GET /ft/order/:orderHash

Fetch a single AugustusRFQ order by its hash, with current state and remaining fillable balance.

GET /ft/order/{orderHash}

Get an OTC order by hash

cURL

curl --request GET \
  --url https://api.velora.xyz/ft/order/{orderHash}

200

{
  "orderHash": "<string>",
  "chainId": 1,
  "nonceAndMeta": "<string>",
  "expiry": 123,
  "maker": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "taker": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "makerAsset": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "takerAsset": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "makerAmount": "1000000000000000000",
  "takerAmount": "1000000000000000000",
  "signature": "<string>",
  "permitMakerAsset": "<string>",
  "takerFromMeta": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "makerBalance": "1000000000000000000",
  "fillableBalance": "1000000000000000000",
  "reservedBalance": "1000000000000000000",
  "swappableBalance": "1000000000000000000",
  "transactionHash": "<string>",
  "createdAt": 123,
  "updatedAt": 123
}

Fetch one order by the orderHash returned when it was posted. The response is the full order record, including its current state and the fillableBalance still open for partial fills.

Always re-check expiry against the current block and confirm state is PENDING before a taker submits a fill. The on-chain fill reverts if the order is expired, already FULFILLED, or CANCELLED.

Related pages

OTC overview

Lifecycle, endpoints, and order states end to end.

List maker orders

All orders created by a maker, paginated.

List taker orders

All orders a given taker can fill.

SDK → OTC

sdk.otcOrders.getOTCOrders reads orders by maker or taker.

Path Parameters

orderHash · string · required

The order's EIP-712 hash, returned when the order was posted.

Response

200

application/json

The order record.

A stored order as returned by the API, including server-tracked balances and state.

orderHash · string

The order's EIP-712 hash — its unique identifier.

chainId · integer

EVM chain ID. AugustusRFQ is deployed on 1 (Mainnet), 10 (Optimism), 56 (BSC), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 43114 (Avalanche), and 100 (Gnosis). See /resources/chains-and-contracts for per-chain addresses.

Example:

1

nonceAndMeta · string

expiry · integer

maker · string

EVM address (20 bytes, hex-encoded with 0x prefix).

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

taker · string

EVM address (20 bytes, hex-encoded with 0x prefix).

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

makerAsset · string

EVM address (20 bytes, hex-encoded with 0x prefix).

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

takerAsset · string

EVM address (20 bytes, hex-encoded with 0x prefix).

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

makerAmount · string

Token amount in raw units / wei (no decimal point). Serialized as a string to preserve precision beyond JavaScript Number range.

Example:

"1000000000000000000"

takerAmount · string

Token amount in raw units / wei (no decimal point). Serialized as a string to preserve precision beyond JavaScript Number range.

Example:

"1000000000000000000"

signature · string

permitMakerAsset · string | null

state · enum<string>

Lifecycle state. SUSPENDED means the maker's balance or allowance dropped below the order. FULFILLED means fully filled.

Available options: DRAFT, PENDING, FULFILLED, CANCELLED, SUSPENDED, EXPIRED

type · enum<string>

P2P is a counterparty-restricted OTC order (a named taker). LIMIT is an open AugustusRFQ order. The OTC API surface is P2P.

Available options: P2P, LIMIT

takerFromMeta · string

Intended receiver decoded from nonceAndMeta.

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

makerBalance · string

Min of the maker's balance, allowance, and balance backing this order.

Example:

"1000000000000000000"

fillableBalance · string

Remaining unfilled makerAmount.

Example:

"1000000000000000000"

reservedBalance · string

Amount currently reserved by this order.

Example:

"1000000000000000000"

swappableBalance · string

Amount available to fill right now.

Example:

"1000000000000000000"

transactionHash · string | null

Fill or cancellation transaction hash, once settled on-chain.

createdAt · integer

Unix timestamp the order was created.

updatedAt · integer

Unix timestamp the order was last updated.