💠API Reference

Get Quote

post

Request a transaction-ready quote for swap and bridge flows.

Body

application/json

from_chainintegerRequired

Source chain ID

Example: 8453

to_chainintegerRequired

Destination chain ID

Example: 42161

from_tokenstringRequired

Source token address

Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

to_tokenstringRequired

Destination token address

Example: 0xaf88d065e77c8cC2239327C5EDb3A432268e5831

from_addressstringRequired

Sender address

Example: 0xac50fab2bf7a921a73298a691dc047a6fc2ad34a

to_addressstringRequired

Recipient address

Example: 0xac50fab2bf7a921a73298a691dc047a6fc2ad34a

amountstringRequired

Input amount in token base units

Example: 1000000Pattern: ^[0-9]+$

slippageintegerOptional

Slippage in basis points style units where 50 means 0.5%

Example: 50

affiliationstring · nullableOptional

Integrator or referral code

external_bridgebooleanOptionalDefault: false

to_platform_idintegerOptional

Destination platform ID when applicable

Example: 0

quote_onlyboolean · nullableOptional

Optional frontend compatibility flag that may be included in quote requests.

Example: true

Responses

200

Quote created successfully

application/json

request_idstringRequired

amount_outstringRequired

feestringRequired

slippageintegerRequired

min_receivestringRequired

estimated_timenumberRequired

recipientstringRequired

router_typestring · enumRequiredPossible values:

routerstringRequired

created_atstring · date-timeRequired

pointsstringRequired

quote_messagestring · nullableOptional

400

Invalid request

application/json

422

Validation error

application/json

post

/quote

HTTPcURLJavaScriptPython

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

{
  "from_chain": 1,
  "to_chain": 1,
  "from_token": "0x0000000000000000000000000000000000000000",
  "to_token": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
  "from_address": "0xac50fab2bf7a921a73298a691dc047a6fc2ad34a",
  "to_address": "0xac50fab2bf7a921a73298a691dc047a6fc2ad34a",
  "amount": "1000000000000000000",
  "slippage": 50,
  "affiliation": null,
  "to_platform_id": 0,
  "quote_only": true
}

Same-chain swapCross-chain bridge

{
  "request_id": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "amount_out": "2051868772",
  "fee": "2.48506399999999842120",
  "tx": {
    "to": "0x6222f99443A0d75bd96d40F2904606f60f37cdc2",
    "value": "1000000000000000000",
    "data": "0xabcdef",
    "chainId": 1,
    "gas": null,
    "maxFeePerGas": null,
    "maxPriorityFeePerGas": null
  },
  "approve": null,
  "slippage": 50,
  "min_receive": "2041609428",
  "estimated_time": 2,
  "recipient": "0xac50fab2bf7a921a73298a691dc047a6fc2ad34a",
  "router_type": "swap",
  "price_impact": {
    "bridge_fee": "0",
    "swap_fee": "2.48506399999999842120",
    "dst_gas_fee": "0"
  },
  "router": "OKX DEX",
  "created_at": "2026-03-12T10:14:32.186371",
  "points": "248.5",
  "quote_message": null,
  "routes": [
    {
      "name": "OKX DEX",
      "logo": "https://static.wheelx.fi/media/dex_logos/OKX.png"
    }
  ]
}

Get Order

get

Query a single order by request_id.

Path parameters

request_idstringRequired

Order ID returned by POST /quote

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

Responses

200

Order found

application/json

order_idstringRequired

from_chainintegerRequired

from_tokenstringRequired

from_addressstringRequired

from_amountstringRequired

to_chainintegerRequired

to_tokenstringRequired

to_addressstringRequired

to_amountstringRequired

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 · nullableOptional

reward_valueobject · nullableOptional

routesstring[]Optional

to_platform_idinteger · nullableOptional

404

Order not found

application/json

get

/order/{request_id}

HTTPcURLJavaScriptPython

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

{
  "order_id": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "from_chain": 8453,
  "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "from_token_info": {
    "symbol": "USDC",
    "name": "USD Coin",
    "decimals": 6,
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "chain_id": 8453,
    "logo": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
    "tags": [
      "top"
    ],
    "categories": []
  },
  "from_address": "0xac50fab2bf7a921a73298a691dc047a6fc2ad34a",
  "from_amount": "1632112.000000",
  "to_chain": 8453,
  "to_token": "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2",
  "to_token_info": {
    "symbol": "USDT",
    "name": "Tether USD",
    "decimals": 6,
    "address": "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2",
    "chain_id": 8453,
    "logo": "https://logo.moralis.io/0x2105_0xfde4c96c8593536e31f229ea8f37b2ada2699bb2_0a0c0ec4b493edd63a32fb37abd7a354.png",
    "tags": [
      "top"
    ],
    "categories": []
  },
  "to_address": "0xac50fab2bf7a921a73298a691dc047a6fc2ad34a",
  "to_amount": "1611027",
  "open_tx_hash": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "open_block": 43205959,
  "open_timestamp": "2026-03-11T03:54:25",
  "fill_tx_hash": null,
  "fill_block": null,
  "fill_timestamp": null,
  "status": "Filled",
  "points": "2.19",
  "reward_type": null,
  "reward_value": null,
  "routes": [
    "QuickSwap"
  ],
  "to_platform_id": 0
}

Get Orders

get

Retrieve historical order records for one or more wallet addresses.

Query parameters

addressstring[]Required

One or more wallet addresses

networkstring · enumOptionalDefault: mainnetPossible values:

limitinteger · min: 1 · max: 50OptionalDefault: 5

offsetintegerOptionalDefault: 0

Responses

200

Orders returned successfully

application/json

totalintegerRequired

400

Invalid query parameters

application/json

get

/orders

HTTPcURLJavaScriptPython

GET /v1/orders?address=text HTTP/1.1
Host: api.wheelx.fi
Accept: */*

{
  "orders": [
    {
      "order_id": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "from_chain": 8453,
      "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "from_token_info": {
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "chain_id": 8453,
        "logo": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
        "tags": [
          "top"
        ],
        "categories": []
      },
      "from_address": "0xac50fab2bf7a921a73298a691dc047a6fc2ad34a",
      "from_amount": "1632112.000000",
      "to_chain": 8453,
      "to_token": "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2",
      "to_token_info": {
        "symbol": "USDT",
        "name": "Tether USD",
        "decimals": 6,
        "address": "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2",
        "chain_id": 8453,
        "logo": "https://logo.moralis.io/0x2105_0xfde4c96c8593536e31f229ea8f37b2ada2699bb2_0a0c0ec4b493edd63a32fb37abd7a354.png",
        "tags": [
          "top"
        ],
        "categories": []
      },
      "to_address": "0xac50fab2bf7a921a73298a691dc047a6fc2ad34a",
      "to_amount": "1611027",
      "open_tx_hash": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "open_block": 43205959,
      "open_timestamp": "2026-03-11T03:54:25",
      "fill_tx_hash": null,
      "fill_block": null,
      "fill_timestamp": null,
      "status": "Filled",
      "points": "2.19",
      "reward_type": null,
      "reward_value": null,
      "routes": [
        "QuickSwap"
      ],
      "to_platform_id": 0
    }
  ],
  "total": 1
}