Orchestration API

GET /order-status/{orderId}

Returns the status and details for a single order ID.

This endpoint returns the status and details for a single order ID.

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://orchestration-api.m0.xyz/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"
}

POST /cancel-order

Builds a cancellation transaction for an existing limit order.

GET /orders

Lists orders with optional filters for sender, status, chain IDs, and pagination.