---
title: "Trade tape"
method: GET
path: "/tokens/trades/{address}"
tags: ["Tokens and charts"]
---

# Trade tape

`GET /tokens/trades/{address}`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/tokens/trades/{address}`
- Auth: none declared

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.

## Path parameters

- `address` string, required: EVM address, hex, case-insensitive.

## Query parameters

- `side` 'buy' | 'sell'
- `dex` string
- `min` number
- `wallet` string: EVM address, hex, case-insensitive.
- `limit` integer
- `page` integer

## Response `200`

- object
  - `trades` TradeRow[]
    - `tx` string: Transaction hash.
    - `logIndex` integer
    - `dex` string
    - `side` 'buy' | 'sell'
    - `tokenAmt` number
    - `usd` number
    - `priceUsd` number
    - `ts` integer: Unix time, seconds, UTC.
    - `wallet` string, nullable: EVM address, hex, case-insensitive.
  - `total` integer
  - `page` integer
  - `pageSize` integer
  - `dexes` string[]: Venues seen on this token.
  - `stats24h` object
    - `buys` integer
    - `sells` integer
    - `buyUsd` number
    - `sellUsd` number

## Other responses

- `400`: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- `404`: Nothing at this identity (`NOT_FOUND`, `UNKNOWN_TOKEN`, `NO_ROUTE`).

---

[API](https://skmtc.dev/getchord/apis/chord-api.md) · [All operations](https://skmtc.dev/getchord/apis/chord-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getchord/apis/chord-api/revisions/d3bc4640fea0?raw)