Skip to content
ChordChordChord Docs

Trade tape

GET
/tokens/trades/{address}
curl --request GET \
  --url 'https://api.getchord.xyz/v1/tokens/trades/example?side=buy&limit=25&page=1'

Recent swaps of a token, newest first, with the venue, side, size, price and the attributed wallet. Filter by side, venue, minimum size or wallet; page with page. stats24h sums the day.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
address
required

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/

Query Parameters

Section titled “Query Parameters”
side
string
Allowed values: buy sell
dex
string

Venue id.

min
number

Minimum USD.

wallet

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
limit
integer
default: 25 >= 1 <= 100
page
integer
default: 1 >= 1

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
trades
Array<object>
object
tx

Transaction hash.

string
/^0x[a-fA-F0-9]{64}$/
logIndex
integer
dex
string
side
string
Allowed values: buy sell
tokenAmt
number
usd
number
priceUsd
number
ts

Unix time, seconds, UTC.

integer
wallet

EVM address, hex, case-insensitive.

string | null
/^0x[a-fA-F0-9]{40}$/
total
integer
page
integer
pageSize
integer
dexes

Venues seen on this token.

Array<string>
stats24h
object
buys
integer
sells
integer
buyUsd
number
sellUsd
number
Example
{
  "trades": [
    {
      "tx": "0x4e0bda6af0d4e75c98049cc7c64c5fb9112dcb7e397d68f851cfc01406df33db",
      "logIndex": 41,
      "dex": "uniswap_v3",
      "side": "buy",
      "tokenAmt": 0.00587394,
      "usd": 472.372001,
      "priceUsd": 80418.25435738193,
      "ts": 1789891817,
      "wallet": "0x0e177f6758872e474c8adb191fbd33352495911d"
    },
    {
      "tx": "0xac5d6408c433ced6e93e0b5d4118f5f726511c0e0514f4ea6a9a7cb98552cde4",
      "logIndex": 3,
      "dex": "uniswap_v3",
      "side": "buy",
      "tokenAmt": 0.01154339,
      "usd": 928.183258,
      "priceUsd": 80408.20400246374,
      "ts": 1789891817,
      "wallet": "0x870c73c98a14b6956b79247e1a1cdc68ba0060ee"
    }
  ],
  "total": 2001,
  "page": 1,
  "pageSize": 2,
  "dexes": [
    "slipstream_fork",
    "uniswap_v3"
  ],
  "stats24h": {
    "buys": 11127,
    "sells": 9332,
    "buyUsd": 2902488.248025012,
    "sellUsd": 3019938.981532
  }
}

400

Section titled “400”

Invalid parameters — error names the check that failed (INVALID_PARAMS, BAD_ADDRESS, BAD_LIMIT, BAD_HOURS, …).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}

404

Section titled “404”

Nothing at this identity (NOT_FOUND, UNKNOWN_TOKEN, NO_ROUTE).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}