WHwheelx

Get Orders

Changed on

Query cross-chain orders — acts as a transaction explorer. Supports filtering by address, chain, token, status, bridge, tx hash, to_address, and time range.

Table structure: Quote LEFT JOIN Transaction LEFT JOIN ExternalTransaction

  • Transaction/ExternalTransaction hold destination-chain fill info
  • fill_tx_hash = COALESCE(Transaction.tx_hash, ExternalTransaction.tx_hash)
  • Status: same-chain = filled; cross-chain depends on Transaction/ExternalTransaction state

When an address filter is provided, relay deposit history from the Relay API is also fetched and merged with local DB results (deduplicated by bridge_order_id).

When use_deposit_address=True, only orders that went through a deposit address flow (Quote.deposit is not null) are returned. The address parameter still filters by sender.

get/v1/orders

Request

  • Base URL
    https://api.wheelx.fi
  • URL
    https://api.wheelx.fi/v1/orders
  • Auth
    none declared

Query parameters

addressstring[]
network'mainnet' | 'testnet'
from_chaininteger nullable
to_chaininteger nullable
from_tokenstring nullable
to_tokenstring nullable
to_addressstring nullable
statusstring nullable
bridgestring nullable
deposit_tx_hashstring nullable
fill_tx_hashstring nullable
start_datestring date-time nullable
end_datestring date-time nullable
use_deposit_addressboolean
limitinteger
offsetinteger
sort_bystring
sort_orderstring

Response

Successful Response

totalinteger required

Changes