Trade tape of a pair

GET
/chains/{chain}/pairs/{address}/trades

Swaps and liquidity events in time order. Walk next_cursor to page away from the newest, prev_cursor to catch up.

Path Parameters

chain*string

chain slug (ton) or numeric chain id (950000)

Length1 <= length <= 32
address*string

chain-native address; EVM addresses are case-insensitive

Length1 <= length <= 128

Query Parameters

tx_type?array<>

comma-separated transaction types; omit for every type

Itemsitems <= 8
maker?string

restrict to one maker wallet

Length1 <= length <= 128
from?integer

unix seconds, inclusive lower bound

Formatint64
Range0 <= value
to?integer

unix seconds, inclusive upper bound

Formatint64
Range0 <= value
order?string

newest first (desc, default) or oldest first

Default"desc"

Value in

  • "asc"
  • "desc"
limit?integer

page size; plans above startup may raise the ceiling

Formatint32
Range1 <= value <= 100
Default10
cursor?string

opaque cursor from next_cursor or prev_cursor

Lengthlength <= 512

Header Parameters

Accept-Payment?string

payment methods the client can use, comma-separated, case-insensitive. With x402 in the list, a spent keyless budget answers 402 with the x402 challenge instead of 429.

PAYMENT-SIGNATURE?string

base64 x402 v2 payment payload for this request. A paid request skips the keyless budget and is settled only when it answers 2xx. The v1 header X-PAYMENT is accepted too.

Response Body

application/json

application/problem+json

application/problem+json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/chains/string/pairs/string/trades"
{  "items": [    {      "timestamp": "string",      "hash": "string",      "chain_id": 0,      "maker_address": "string",      "from_address": "string",      "to_address": "string",      "tx_type": "all",      "block_info": {        "block_number": 0,        "log_index": 0,        "gas_used": 0,        "fee_usd": 0      },      "event_data": {        "amount0": 0,        "amount1": 0,        "price0": 0,        "price1": 0,        "price_usd0": 0,        "price_usd1": 0      }    }  ],  "next_cursor": "string",  "prev_cursor": "string"}