GET /order-status/{orderId}

This endpoint returns the status and details for a single order ID. It is only applicable to orders routed through the limit-order provider.

TypeScript Types: Generate types for this API with a single command. See Type Generation.

API Reference: For detailed schema definitions and interactive testing, see the API Reference.

Request

Endpoint

GET /order-status/{orderId}

Headers

x-api-key: YOUR_API_KEY

Path Parameters

Field	Type	Required	Description
`orderId`	`string`	Yes	The order ID to retrieve

Example Request

import type { components } from './m0-swap';
 
type Order = components['schemas']['Order'];
 
const orderId = '0xabc123';
 
const response = await fetch(`https://gateway.m0.xyz/v1/orchestration/order-status/${orderId}`, {
  method: 'GET',
  headers: {
    'x-api-key': YOUR_API_KEY,
  },
});
 
if (response.status === 404) {
  throw new Error('Order not found');
}
 
if (!response.ok) {
  const error = await response.text();
  throw new Error(`Get order status failed: ${error}`);
}
 
const order: Order = await response.json();

Response

Success Response (200)

Returns an Order object.

import type { components } from './m0-swap';
 
type Order = components['schemas']['Order'];
type OrderStatus = components['schemas']['OrderStatus'];

Response Fields

Field	Type	Description
`orderId`	`string`	Unique order identifier
`createdAt`	`string`	Creation timestamp
`originChainId`	`number`	Origin chain ID
`destChainId`	`number`	Destination chain ID
`sender`	`string`	Sender wallet address
`tokenIn`	`string`	Input token address
`amountIn`	`string`	Input amount (smallest unit)
`tokenOut`	`string`	Output token address
`amountOut`	`string`	Target output amount (smallest unit)
`designatedSolver`	`string`	Assigned solver address
`openTx`	`string`	Transaction hash that opened the order
`amountOutFilled`	`string`	Total output filled so far
`fillCount`	`number`	Number of fills
`amountInReleased`	`string`	Input amount released so far
`fillReportCount`	`number`	Number of fill reports
`amountRefunded`	`string`	Amount refunded
`status`	`OrderStatus`	Current status (`CREATED`, `COMPLETED`, `CANCELLED`)
`resolvedAt`	`string \| null`	Resolution timestamp when applicable

💡 Further inspect the response fields on the API reference.

Error Responses

Status	Description
`404`	Order not found

Example Response

{
  "orderId": "0xabc123",
  "createdAt": "2026-02-19T14:31:03.120Z",
  "originChainId": 1,
  "sender": "0xYourWalletAddress",
  "tokenIn": "0x866A2BF4E572CbcF37D5071A7a58503Bfb36be1b",
  "amountIn": "1000000",
  "destChainId": 8453,
  "tokenOut": "0x866A2BF4E572CbcF37D5071A7a58503Bfb36be1b",
  "amountOut": "999500",
  "designatedSolver": "0xSolverAddress",
  "openTx": "0xOpenTxHash",
  "amountOutFilled": "999500",
  "fillCount": 1,
  "amountInReleased": "1000000",
  "fillReportCount": 1,
  "amountRefunded": "0",
  "status": "COMPLETED",
  "resolvedAt": "2026-02-19T14:36:20.002Z"
}