---
title: "Get Orders"
method: GET
path: "/v1/orders"
---

# Get Orders

`GET /v1/orders`

## Request

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

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.

## Query parameters

- `address` string[]
- `network` 'mainnet' | 'testnet'
- `from_chain` integer, nullable
- `to_chain` integer, nullable
- `from_token` string, nullable
- `to_token` string, nullable
- `to_address` string, nullable
- `status` string, nullable
- `bridge` string, nullable
- `deposit_tx_hash` string, nullable
- `fill_tx_hash` string, nullable
- `start_date` string, date-time, nullable
- `end_date` string, date-time, nullable
- `use_deposit_address` boolean
- `limit` integer
- `offset` integer
- `sort_by` string
- `sort_order` string

## Response `200`

Successful Response

- OrdersByAddressResponse
  - `orders` OrderResponse[], required
    - `order_id` string, required
    - `from_chain` integer, required
    - `from_token` string, required
    - `from_token_info` TokenInfo
      - `symbol` string, required
      - `name` string, required
      - `decimals` integer, required
      - `address` string, required
      - `chain_id` integer, required
      - `logo` string, required
      - `tags` string[]
      - `categories` string[]
      - `listed` boolean
      - `fee_level` 'Group1' | 'Group2'
    - `from_address` string, required
    - `from_amount` string, required
    - `to_chain` integer, required
    - `to_token` string, required
    - `to_token_info` TokenInfo
      - `symbol` string, required
      - `name` string, required
      - `decimals` integer, required
      - `address` string, required
      - `chain_id` integer, required
      - `logo` string, required
      - `tags` string[]
      - `categories` string[]
      - `listed` boolean
      - `fee_level` 'Group1' | 'Group2'
    - `to_amount` string, required
    - `to_address` string, required
    - `open_tx_hash` string, required
    - `open_block` integer, required
    - `open_timestamp` string, date-time, required
    - `fill_tx_hash` string, nullable
    - `fill_block` integer, nullable
    - `fill_timestamp` string, date-time, nullable
    - `status` 'Open' | 'Filled' | 'Failed' | 'Refund', required
    - `points` string, required
    - `reward_type` 'xp' | 'usdt'
    - `reward_value` object, nullable
    - `routes` string[]
    - `to_platform_id` integer, nullable
    - `order_value` string, nullable
    - `bridge_order_id` string, nullable
    - `deposit_address` string, nullable
    - `is_meta` boolean
  - `total` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `2ce52f9bcd17`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wheelx/apis/wheelx-sdk-api/changes/v1/orders/get.md)

---

[API](https://skmtc.dev/wheelx/apis/wheelx-sdk-api.md) - [All operations](https://skmtc.dev/wheelx/apis/wheelx-sdk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wheelx/apis/wheelx-sdk-api/revisions/2ce52f9bcd17?raw)