Docs

Movement Move REST API Guide

Production-ready docs for Movement's MoveVM interface. Movement exposes Aptos-compatible REST endpoints under /v1 for querying data and submitting transactions.

Movement RPC

With Dwellir, you get access to our global Movement network which always routes your API requests to the nearest available location, ensuring low latency and the fastest speeds.

Get your API key

Why Build on Movement

  • Move-first execution environment with resource-oriented safety
  • BlockSTM parallel execution for high throughput
  • 1–3 second fast finality UX
  • Compatibility with existing Aptos tooling and REST schemas

Quick Start

Endpoints

Movement RPC Endpoints
HTTPS
curl -X GET https://api-movement-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>/v1 \  -H "Accept: application/json"
import { Aptos, AptosConfig } from '@aptos-labs/ts-sdk';const client = new Aptos(  new AptosConfig({ fullnode: 'https://api-movement-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>/v1' }));const ledger = await client.getLedgerInfo();console.log(ledger.chain_id);
import requestsresp = requests.get('https://api-movement-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>/v1')print(resp.json())
package mainimport (  "fmt"  "io"  "net/http")func main() {  resp, err := http.Get("https://api-movement-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>/v1")  if err != nil { panic(err) }  defer resp.Body.Close()  body, _ := io.ReadAll(resp.Body)  fmt.Println(string(body))}

SDK Installation

Bash
npm i @aptos-labs/ts-sdk
TypeScript
import { Aptos, AptosConfig, Network } from '@aptos-labs/ts-sdk';

const config = new AptosConfig({
  network: Network.CUSTOM,
  fullnode: 'https://api-movement-mainnet.n.dwellir.com/YOUR_API_KEY/v1'
});
const aptos = new Aptos(config);
const ledger = await aptos.getLedgerInfo();
console.log('Move chain ID:', ledger.chain_id);
Bash
# Example usage placeholder. Configure your CLI with the endpoint above
# API Base: https://api-movement-mainnet.n.dwellir.com/YOUR_API_KEY/v1

Network Information

ParameterValueDetails
API Base/v1Aptos-compatible REST
Native TokenMOVE
Finality~1–3sFast confirmations
Endpointhttps://api-movement-mainnet.n.dwellir.com/YOUR_API_KEY/v1Full REST base URL

Move REST API Reference

Movement exposes Aptos-compatible REST APIs at /v1 for MoveVM operations.

Movement-Specific Features

Common Integration Patterns

  • DEX or payments: leverage Move resources for precise asset accounting
  • Data services: poll /v1/blocks and /v1/transactions for real-time indexing
  • Custody/wallets: query account resources and event streams to reflect balances

Performance Best Practices

  • Design for BlockSTM: avoid write conflicts to maximize parallelism
  • Gas optimization: use Move simulations to estimate gas under load
  • Finality-aware UX: consider 1–3s finality in confirmations and polling intervals

Migration Guides

  • From Aptos: reuse Move modules with minimal changes; update REST base to Movement /v1
  • From Sui: port object/resource models to Move on Movement; adjust package layout

Troubleshooting

  • Ensure correct address format (hex with 0x prefix) and fully qualified module/function IDs
  • Encode payloads with BCS and confirm signatures before submission
  • Check /v1/-/healthy for node health and /v1/ledger for latest version

Resources & Tools