Latest prints

GET

/arc/token/{address}/trades

const url = 'https://api.getchord.xyz/v1/arc/token/example/trades?limit=50';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.getchord.xyz/v1/arc/token/example/trades?limit=50'

The last N swaps of one token straight from Chord’s own Arc tape (newest first): venue, side, size, USD, price, wallet (null until resolved) and pool. Bounded and index-served — the mobile token page’s Feed tab.

Parameters

Path Parameters

address

required

EVM address, hex, case-insensitive.

string

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

Query Parameters

limit

integer

default: 50 >= 1 <= 200

Newest rows.

Responses

200

application/json

object

chain

integer

Allowed value: 5042

token

EVM address, hex, case-insensitive.

string

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

trades

Array<object>

object

string

logIndex

integer

dex

string

side

string

Allowed values: buy sell

tokenAmt

Whole tokens.

number

usd

number

priceUsd

number

Unix time, seconds, UTC.

integer

wallet

EVM address, hex, case-insensitive.

string | null

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

pool

Pool address or V4 poolId.

string

updatedAt

Unix time, milliseconds — when the server built this answer.

integer

Example

{
  "chain": 5042,
  "token": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
  "trades": [
    {
      "tx": "0xbebd037b84ae0fba9229fb3e01f983833cbd637983ba254d4dba71ddad861764",
      "logIndex": 22,
      "dex": "uniswap_v3",
      "side": "buy",
      "tokenAmt": 0.00000843,
      "usd": 0.70542,
      "priceUsd": 83679.71530249111,
      "ts": 1790709599,
      "wallet": "0x7fe73969faf9d867ac49add1860bc121ff199272",
      "pool": "0x82916bee18fcef517b26c72d7cb5f13694e1db41"
    },
    {
      "tx": "0xbdd5f399dd4ead2281042560db54dbfa13c6b44c4ed873baad4daea84dfed472",
      "logIndex": 3,
      "dex": "uniswap_v3",
      "side": "buy",
      "tokenAmt": 0.003,
      "usd": 250.846064,
      "priceUsd": 83615.35466666667,
      "ts": 1790709590,
      "wallet": "0xee93f91e457522d89ee19c2affba87352c365465",
      "pool": "0x82916bee18fcef517b26c72d7cb5f13694e1db41"
    }
  ],
  "updatedAt": 1790709635583
}

400

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

application/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"
}

503

The lane behind this endpoint is not ready or not enabled here (NOT_READY, CHAIN_NOT_ENABLED, NOT_ENABLED, *_UNAVAILABLE). Retry later; do not treat it as an empty answer.

application/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"
}