API Reference

Quote

post

Body

application/json

from_chainintegerRequired

to_chainintegerRequired

from_tokenstringRequired

to_tokenstringRequired

from_addressstringRequired

to_addressstringRequired

amountintegerRequired

slippageinteger · nullableOptional

affiliationstring · nullableOptional

external_bridgebooleanOptionalDefault: false

to_platform_idinteger · nullableOptional

select_routestring · nullableOptional

sponsor_gasbooleanOptionalDefault: false

use_deposit_addressbooleanOptionalDefault: false

exact_outbooleanOptionalDefault: false

strictbooleanOptionalDefault: false

Responses

200

Successful Response

application/json

request_idstringRequired

amount_outstringRequired

feestringRequired

txany of · nullableOptional

or

or

slippageintegerRequired

min_receivestringRequired

estimated_timenumberOptionalDefault: 10

recipientstringRequired

router_typestring · enumOptionalDefault: swapPossible values:

routerstringOptionalDefault: wheelx

created_atstring · date-timeRequired

pointsstringRequired

quote_messagestring · nullableOptional

deposit_addressstring · nullableOptional

approve_txany of · nullableOptional

or

or

swap_txany of · nullableOptional

or

or

gas_feestring · nullableOptional

bridge_order_idstring · nullableOptional

amount_instring · nullableOptional

422

Validation Error

application/json

post/v1/quote

HTTPcURLJavaScriptPython

POST /v1/quote HTTP/1.1
Host: api.wheelx.fi
Content-Type: application/json
Accept: */*
Content-Length: 300

{
  "from_chain": 1,
  "to_chain": 1,
  "from_token": "text",
  "to_token": "text",
  "from_address": "text",
  "to_address": "text",
  "amount": 1,
  "slippage": 1,
  "affiliation": "text",
  "external_bridge": false,
  "to_platform_id": 1,
  "select_route": "text",
  "sponsor_gas": false,
  "use_deposit_address": false,
  "exact_out": false,
  "strict": false
}

{
  "request_id": "text",
  "amount_out": "text",
  "fee": "text",
  "tx": {
    "to": "text",
    "value": "text",
    "data": "text",
    "chainId": 1,
    "gas": 1,
    "maxFeePerGas": 1,
    "maxPriorityFeePerGas": 1
  },
  "approve": {
    "token": "text",
    "spender": "text",
    "amount": 1
  },
  "slippage": 1,
  "min_receive": "text",
  "estimated_time": 10,
  "recipient": "text",
  "router_type": "swap",
  "price_impact": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "router": "wheelx",
  "created_at": "2026-07-22T16:03:42.997Z",
  "points": "text",
  "quote_message": "text",
  "routes": [
    {
      "name": "text",
      "logo": "text"
    }
  ],
  "deposit_address": "text",
  "approve_tx": {
    "to": "text",
    "value": "text",
    "data": "text",
    "chainId": 1,
    "gas": 1,
    "maxFeePerGas": 1,
    "maxPriorityFeePerGas": 1
  },
  "swap_tx": {
    "to": "text",
    "value": "text",
    "data": "text",
    "chainId": 1,
    "gas": 1,
    "maxFeePerGas": 1,
    "maxPriorityFeePerGas": 1
  },
  "gas_fee": "text",
  "bridge_order_id": "text",
  "amount_in": "text",
  "quotes": [
    {
      "request_id": "text",
      "router": "text",
      "amount_out": "text",
      "tx": {
        "to": "text",
        "value": "text",
        "data": "text",
        "chainId": 1,
        "gas": 1,
        "maxFeePerGas": 1,
        "maxPriorityFeePerGas": 1
      },
      "routes": [
        {
          "name": "text",
          "logo": "text"
        }
      ],
      "gas_fee": "text",
      "points": "0"
    }
  ]
}

Get Order

get

Path parameters

request_idstringRequired

Responses

200

Successful Response

application/json

order_idstringRequired

from_chainintegerRequired

from_tokenstringRequired

from_addressstringRequired

from_amountstringRequired

to_chainintegerRequired

to_tokenstringRequired

to_amountstringRequired

to_addressstringRequired

open_tx_hashstringRequired

open_blockintegerRequired

open_timestampstring · date-timeRequired

fill_tx_hashstring · nullableOptional

fill_blockinteger · nullableOptional

fill_timestampstring · date-time · nullableOptional

statusstring · enumRequiredPossible values:

pointsstringRequired

reward_typestring · enum · nullableOptionalPossible values:

routesstring[]Optional

to_platform_idinteger · nullableOptional

order_valuestring · nullableOptional

bridge_order_idstring · nullableOptional

deposit_addressstring · nullableOptional

422

Validation Error

application/json

get/v1/order/{request_id}

HTTPcURLJavaScriptPython

GET /v1/order/{request_id} HTTP/1.1
Host: api.wheelx.fi
Accept: */*

{
  "order_id": "text",
  "from_chain": 1,
  "from_token": "text",
  "from_token_info": {
    "symbol": "text",
    "name": "text",
    "decimals": 1,
    "address": "text",
    "chain_id": 1,
    "logo": "text",
    "tags": [
      "text"
    ],
    "categories": [
      "text"
    ],
    "listed": true,
    "fee_level": "Group1"
  },
  "from_address": "text",
  "from_amount": "text",
  "to_chain": 1,
  "to_token": "text",
  "to_token_info": {
    "symbol": "text",
    "name": "text",
    "decimals": 1,
    "address": "text",
    "chain_id": 1,
    "logo": "text",
    "tags": [
      "text"
    ],
    "categories": [
      "text"
    ],
    "listed": true,
    "fee_level": "Group1"
  },
  "to_amount": "text",
  "to_address": "text",
  "open_tx_hash": "text",
  "open_block": 1,
  "open_timestamp": "2026-07-22T16:03:42.997Z",
  "fill_tx_hash": "text",
  "fill_block": 1,
  "fill_timestamp": "2026-07-22T16:03:42.997Z",
  "status": "Open",
  "points": "text",
  "reward_type": "xp",
  "reward_value": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "routes": [
    "text"
  ],
  "to_platform_id": 1,
  "order_value": "text",
  "bridge_order_id": "text",
  "deposit_address": "text"
}

Get Orders

get

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

addressstring[]OptionalDefault: []

networkstring · enumOptionalDefault: mainnetPossible values:

from_chaininteger · nullableOptional

to_chaininteger · nullableOptional

from_tokenstring · nullableOptional

to_tokenstring · nullableOptional

to_addressstring · nullableOptional

statusstring · nullableOptional

bridgestring · nullableOptional

deposit_tx_hashstring · nullableOptional

fill_tx_hashstring · nullableOptional

start_datestring · date-time · nullableOptional

end_datestring · date-time · nullableOptional

use_deposit_addressbooleanOptionalDefault: false

limitintegerOptionalDefault: 20

offsetintegerOptionalDefault: 0

sort_bystringOptionalDefault: request_id

sort_orderstringOptionalDefault: desc

Responses

200

Successful Response

application/json

totalintegerRequired

422

Validation Error

application/json

get/v1/orders

HTTPcURLJavaScriptPython

GET /v1/orders HTTP/1.1
Host: api.wheelx.fi
Accept: */*

{
  "orders": [
    {
      "order_id": "text",
      "from_chain": 1,
      "from_token": "text",
      "from_token_info": {
        "symbol": "text",
        "name": "text",
        "decimals": 1,
        "address": "text",
        "chain_id": 1,
        "logo": "text",
        "tags": [
          "text"
        ],
        "categories": [
          "text"
        ],
        "listed": true,
        "fee_level": "Group1"
      },
      "from_address": "text",
      "from_amount": "text",
      "to_chain": 1,
      "to_token": "text",
      "to_token_info": {
        "symbol": "text",
        "name": "text",
        "decimals": 1,
        "address": "text",
        "chain_id": 1,
        "logo": "text",
        "tags": [
          "text"
        ],
        "categories": [
          "text"
        ],
        "listed": true,
        "fee_level": "Group1"
      },
      "to_amount": "text",
      "to_address": "text",
      "open_tx_hash": "text",
      "open_block": 1,
      "open_timestamp": "2026-07-22T16:03:42.997Z",
      "fill_tx_hash": "text",
      "fill_block": 1,
      "fill_timestamp": "2026-07-22T16:03:42.997Z",
      "status": "Open",
      "points": "text",
      "reward_type": "xp",
      "reward_value": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "routes": [
        "text"
      ],
      "to_platform_id": 1,
      "order_value": "text",
      "bridge_order_id": "text",
      "deposit_address": "text"
    }
  ],
  "total": 1
}

Get Deposit Address Config

get

Responses

200

Successful Response

application/json

get/v1/deposit-address-config

HTTPcURLJavaScriptPython

GET /v1/deposit-address-config HTTP/1.1
Host: api.wheelx.fi
Accept: */*

200

Successful Response

{
  "chains": [
    {
      "id": 1,
      "from_enable": true,
      "to_enable": true,
      "chain": 1,
      "created_at": "2026-07-22T16:03:42.997Z",
      "updated_at": "2026-07-22T16:03:42.997Z",
      "chain_info": {
        "server_name": "text",
        "name": "text",
        "chain_id": 1,
        "rpc_url": "",
        "rpc_fallback": [
          "text"
        ],
        "chain_icon": "text",
        "is_testnet": false,
        "is_popular": false,
        "eth_token": "0x0000000000000000000000000000000000000000",
        "usdc_token": "text",
        "usdt_token": "text",
        "support_kline": false,
        "rpc_endpoints": [
          {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ],
        "is_evm": true,
        "inbound": true,
        "outbound": true,
        "support_sponsor_gas": false
      }
    }
  ],
  "tokens": [
    {
      "id": 1,
      "direction": "text",
      "token_name": "text",
      "token_address": "text",
      "enable": true,
      "chain": 1,
      "created_at": "2026-07-22T16:03:42.997Z",
      "updated_at": "2026-07-22T16:03:42.997Z",
      "token_info": {
        "symbol": "text",
        "name": "text",
        "decimals": 1,
        "address": "text",
        "chain_id": 1,
        "logo": "text",
        "tags": [
          "text"
        ],
        "categories": [
          "text"
        ],
        "listed": true,
        "fee_level": "Group1"
      }
    }
  ]
}

Chain Info

get

Query parameters

networkstring · enumOptionalDefault: mainnetPossible values:

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get/v1/chain-info

HTTPcURLJavaScriptPython

GET /v1/chain-info HTTP/1.1
Host: api.wheelx.fi
Accept: */*

{
  "chains": [
    {
      "server_name": "text",
      "name": "text",
      "chain_id": 1,
      "rpc_url": "",
      "rpc_fallback": [
        "text"
      ],
      "chain_icon": "text",
      "is_testnet": false,
      "is_popular": false,
      "eth_token": "0x0000000000000000000000000000000000000000",
      "usdc_token": "text",
      "usdt_token": "text",
      "support_kline": false,
      "rpc_endpoints": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "is_evm": true,
      "inbound": true,
      "outbound": true,
      "support_sponsor_gas": false
    }
  ],
  "tokens": [
    {
      "symbol": "text",
      "name": "text",
      "decimals": 1,
      "address": "text",
      "chain_id": 1,
      "logo": "text",
      "tags": [
        "text"
      ],
      "categories": [
        "text"
      ],
      "listed": true,
      "fee_level": "Group1"
    }
  ],
  "deposit_platforms": {
    "ANY_ADDITIONAL_PROPERTY": {
      "chains": [
        {
          "server_name": "text",
          "name": "text",
          "chain_id": 1,
          "rpc_url": "",
          "rpc_fallback": [
            "text"
          ],
          "chain_icon": "text",
          "is_testnet": false,
          "is_popular": false,
          "eth_token": "0x0000000000000000000000000000000000000000",
          "usdc_token": "text",
          "usdt_token": "text",
          "support_kline": false,
          "rpc_endpoints": [
            {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          ],
          "is_evm": true,
          "inbound": true,
          "outbound": true,
          "support_sponsor_gas": false,
          "platform_id": 1,
          "platform_type": [
            "text"
          ]
        }
      ],
      "tokens": [
        {
          "symbol": "text",
          "name": "text",
          "decimals": 1,
          "address": "text",
          "chain_id": 1,
          "logo": "text",
          "tags": [
            "text"
          ],
          "categories": [
            "text"
          ],
          "listed": true,
          "fee_level": "Group1",
          "chain_icon": "text",
          "platform_type": [
            "text"
          ],
          "platform_id": 1
        }
      ]
    }
  },
  "slippage_policies": [
    {
      "bridge": true,
      "from_fee_level": "Group1",
      "to_fee_level": "Group1",
      "default_slippage": 1,
      "min_slippage": 1,
      "max_slippage": 1,
      "refresh_interval": 1,
      "notice_rounds": 1
    }
  ]
}