Get escrow order

GET /v1/onchain/{orderId}/order The escrow’s raw order tuple — what refund(order) needs from a device that holds only the on-chain id.

Item	Value
Route key	`infinityOnchainOrder`
Credential	API key or project id

Not scoped to your organization. See Get on-chain fill for the id-format note.

Request

Path parameters

Param	Rules	Meaning
`orderId`	`0x` + 64 lowercase hex (not validated)	the on-chain order id. The hub records an openFor order’s `orderId` as its `onchainOrderId`, so the ack’s `orderId` works here too

Response

data (OnchainOrder):

Field	Type	Meaning
`onchainOrderId`	string	the id
`chainDomain`	string	the origin escrow’s chain
`settler`	string	the escrow contract to send `refund(order)` to, in the origin chain’s form — check it is one of the chain’s `inputSettlers` in `GET /catalog`
`rawOrder`	string	the ABI-encoded `StandardOrder` exactly as the Open log carried it (`0x` hex), verified against the id when stored

Behavior

The settler honours a refund only for a tuple that hashes to the order id, and a refund pays only the order’s own user — so the blob needs availability, not confidentiality.
EVM origins only. Non-EVM order bodies are not served: such an order answers EIN0009 permanently, even once its Open, fill and settle are observed (known issue). A Solana-origin order refunds through Get Solana refund instead.

Errors

Code	When
`EIN0009`	no verified tuple under this id: an unknown or miscased id, a hub order id (`hubOrderId`, or a `POST /order` `orderId`), a non-EVM origin (permanently), or an order whose Open has not been observed yet (poll again)
`EIN0051`	store unavailable

Never send an empty id: /onchain//order is not a route. The gateway’s own refusals — a refused credential, a route not open to it, a rate limit, the hub unreachable or too slow — can come back from every route, with an EPX code and a real HTTP status (Errors — gateway codes); EIN0049 (internal, scrubbed) can come back from any route.

Example

curl -sS https://proxy-api.infinimesh.net/v1/onchain/0x8c7f293ae9851d2919e1543d0268483a0636bef9417240b0aa15258c508e32b9/order \
  -H "x-api-key: $HUB_API_KEY"

Response

Illustrative values; formats follow the Response table. rawOrder is elided here: a real ABI-encoded StandardOrder is not derivable from the documented sources.

{
  "success": true,
  "request_id": "b8c9d0e1-f2a3-4e38-8394-051627384950",
  "data": {
    "onchainOrderId": "0x8c7f293ae9851d2919e1543d0268483a0636bef9417240b0aa15258c508e32b9",
    "chainDomain": "eip155-1",
    "settler": "0xf439808b5a80e3c355645b62310502817000cd1d",
    "rawOrder": "0x…"
  }
}

// client: your InteropClient (see /infinity-interop/sdk/installation)
const tuple = await client.api.getOnchainOrder(onchainOrderId);

Get started

Core concepts

Resources

API reference

SDK

SDK reference

Request

Path parameters

Response

Behavior

Errors

Example

Response

See also

​Request

​Path parameters

​Response

​Behavior

​Errors

​Example

​Response

​See also

Request

Path parameters

Response

Behavior

Errors

Example

Response

See also