# Trade tape

> Newest first. Each trade carries side, amounts in human units, USD and ETH value, the price, pool and DEX, the attributed trader, gas and token tax, and its…

Source: https://docs.crius.sh/reference/trades/trade-tape/ · Updated 2026-10-28

GET https://api.crius.sh/v1/{chain}/token/{address}/trades

Newest first. Each trade carries side, amounts in human units, USD and ETH value, the price, pool and DEX, the attributed trader, gas and token tax, and its `finality` (`latest` → `safe` → `finalized`). Filter by `side`, `trader`, `min_usd` and a time range; paginate with `cursor`. USD values are computed when the trade is indexed: the quote amount times the quote's USD price at that block, from on-chain markets (ETH via the WETH/USDG pool). `eth_usd_at_trade` is that block's ETH/USD (exact for ETH and WETH-quoted trades: `value_usd / value_eth`); `price_eth` comes from the amounts for ETH-quoted trades, else from `price_usd` and that rate. In the chain's first days (before about June 24, 2026) the WETH/USDG pool was new and thin, so USD values from then are estimates from its spot price.

> Real trader attribution, USD at trade time, realized tax, gas (L2 + L1).

## Path parameters

`chain`stringrequired

Chain slug (`robinhood`) or chain id (`4663`).

`address`stringrequired

Contract or wallet address, any case (`0x…`, 20 bytes).

## Query parameters

`limit`integer Default `50`

Maximum number of items to return. Up to 500.

`cursor`string

Pagination cursor from the previous response's `meta.next_cursor`.

`side`string

`buy` or `sell`.

`trader`string

Only trades by this trader address.

`min_usd`number

Only items worth at least this many USD.

`from_ts`integer

Start of the time range, unix milliseconds (inclusive).

`to_ts`integer

End of the time range, unix milliseconds (inclusive).

`app`string

Fomo: only trades made through this app, executed by its relayers (the relayer shows as signer\_label; trader\_app marks the app's own smart wallets)

## Guides that use this endpoint

[**Get OHLCV candles for Robinhood Chain tokens (OHLCV API)**Robinhood Chain OHLCV API: candles for any token from 1 second to 1 day, with buy volume, trade count and market cap per candle. Real examples and chart code.](https://docs.crius.sh/guides/get-ohlcv-candles/)[**Stream Robinhood Chain trades over WebSocket**Stream every trade of a Robinhood Chain token, pool or wallet over the Crius WebSocket, with Node.js and Python clients that reconnect, resume and backfill.](https://docs.crius.sh/guides/stream-trades-websocket/)[**Get every trade of a Robinhood Chain token (trade tape)**Get every buy and sell of a Robinhood Chain token with USD value, price, gas, tax and the real trader behind routers and smart wallets. Real examples, no key.](https://docs.crius.sh/guides/get-token-trades/)[**Stream live candles for a Robinhood Chain token chart**Keep a Robinhood Chain candlestick chart live: load candles over REST, update the last bar from the Crius WebSocket, with a runnable Node.js relay.](https://docs.crius.sh/guides/stream-live-candles/)[**Get a token's full activity feed (trades, transfers, liquidity)**Get every event of a Robinhood Chain token in one feed, from trades and transfers to liquidity, burns, owner actions, locks and graduation, with real examples.](https://docs.crius.sh/guides/get-token-activity-feed/)[**Find a token's top traders and their PnL**Rank the traders of any Robinhood Chain token by PnL, volume, buys or ROI, with wallet tags, gas and hold time. A real example with the PnL math explained.](https://docs.crius.sh/guides/get-top-traders-pnl/)[**Move from raw RPC calls to the Crius API on Robinhood Chain**Replace eth\_getLogs scans, slot0 math and Transfer replays with Crius API calls on Robinhood Chain: a mapping table, before/after code and credit costs.](https://docs.crius.sh/guides/migrate-from-rpc-to-crius/)[**Get a wallet's trade history**List every trade a Robinhood Chain wallet made across all tokens, with USD value at trade time, market cap, DEX and gas. Filter by token, side, size, time.](https://docs.crius.sh/guides/get-wallet-trade-history/)[**Robinhood Chain DEX data: which DEXs trade, and how to get their trades, pools and volume**Which DEXs trade on Robinhood Chain (Uniswap v2, v3, v4 with hooks, launchpad curves), their real 24h volume and pools, and the API calls for DEX trades.](https://docs.crius.sh/guides/robinhood-chain-dex-data/)[**Robinhood Chain API for trading bots**What a Robinhood Chain trading bot needs from the Crius API: new launches, live prices, pools and safety checks before every buy, with credit costs.](https://docs.crius.sh/use-cases/trading-bots/)

## Errors

Errors come back as `{ "error": { "code", "message" } }` with the matching HTTP status: `400` bad parameter, `401` missing or invalid key, `403` endpoint above your plan, `404` unknown token or address, `429` rate limit or credits used up (with `Retry-After`). See [Errors](https://docs.crius.sh/errors/).

## More trades & candles endpoints

[GET/token/{address}/candlesOHLCV candlesAnonymous · 2 cr](https://docs.crius.sh/reference/trades/ohlcv-candles/)[GET/token/{address}/transactionsActivity feedFree · 2 cr](https://docs.crius.sh/reference/trades/activity-feed/)

Request No key needed

  

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/trades?limit=3" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/trades?limit=3", {
  headers: { "x-api-key": process.env.CRIUS_API_KEY },
});
const { data, meta } = await res.json();
```

**Python**

```python
import os, requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/trades?limit=3",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

Response 200 · captured Oct 28, 2026

```json
{
  "data": [
    {
      "amount_base": 0.241346083005198446,
      "amount_quote": 569.019791,
      "block": 100406784,
      "dex": "uniswap_v3",
      "eth_usd_at_trade": 2356.9,
      "executor": null,
      "fees": {
        "gas": {
          "gas_price_gwei": 0.021,
          "gas_used": 239930,
          "gas_used_l1": 0,
          "l1_eth": 0,
          "l2_eth": 0.00000503853,
          "total_eth": 0.00000503853,
          "usd": 0.0118753
        },
        "token_tax": {
          "pct": null
        }
      },
      "finality": "latest",
      "id": "100406784-6-44",
      "market_cap_usd_at_trade": 90494155,
      "pool": "0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca",
      "price_eth": 1.00034,
      "price_usd": 2357.69,
      "quote": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
      "quote_symbol": "USDG",
      "signer": "0xe950337f36e45c316c53c69a5f285487b54f0bad",
      "signer_label": null,
      "trader": "0xe950337f36e45c316c53c69a5f285487b54f0bad",
      "trader_app": null,
      "trader_label": "fomo_relayer_3",
      "ts": 1793225076000,
      "tx": "0x5b474612139f91cb226cf9e5097244dbb896a86834d8adbd263641c96d67b9f7",
      "tx_index": 6,
      "type": "buy",
      "value_eth": 0.241428,
      "value_usd": 569.02,
      "via": []
    },
    {
      "amount_base": 0.021222351350879784,
      "amount_quote": 50.025498,
      "block": 100406784,
      "dex": "uniswap_v3",
      "eth_usd_at_trade": 2356.9,
      "executor": null,
      "fees": {
        "gas": {
          "gas_price_gwei": 0.021,
          "gas_used": 455557,
          "gas_used_l1": 0,
          "l1_eth": 0,
          "l2_eth": 0.0000095667,
          "total_eth": 0.0000095667,
          "usd": 0.0225477
        },
        "token_tax": {
          "pct": null
        }
      },
      "finality": "latest",
      "id": "100406784-1-12",
      "market_cap_usd_at_trade": 90475571,
      "pool": "0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca",
      "price_eth": 1.00013,
      "price_usd": 2357.21,
      "quote": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
      "quote_symbol": "USDG",
      "signer": "0x800539138ff0510191277f6b5c58fb94ae700064",
      "signer_label": null,
      "trader": "0x800539138ff0510191277f6b5c58fb94ae700064",
      "trader_app": null,
      "trader_label": null,
      "ts": 1793225076000,
      "tx": "0x0bde8abf03edce0f2ba13a3398ec2575b177c3f2d85eef77c25c7899a9949311",
      "tx_index": 1,
      "type": "sell",
      "value_eth": 0.0212252,
      "value_usd": 50.0255,
      "via": [
        "uniswap_universal_router"
      ]
    },
    {
      "amount_base": 0.011210844980975568,
      "amount_quote": 26.431588,
      "block": 100406782,
      "dex": "uniswap_v3",
      "eth_usd_at_trade": 2356.9,
      "executor": null,
      "fees": {
        "gas": {
          "gas_price_gwei": 0.020904,
          "gas_used": 315171,
          "gas_used_l1": 0,
          "l1_eth": 0,
          "l2_eth": 0.00000658833,
          "total_eth": 0.00000658833,
          "usd": 0.015528
        },
        "token_tax": {
          "pct": null
        }
      },
      "finality": "latest",
      "id": "100406782-10-32",
      "market_cap_usd_at_trade": 90493695,
      "pool": "0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca",
      "price_eth": 1.00033,
      "price_usd": 2357.68,
      "quote": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
      "quote_symbol": "USDG",
      "signer": "0x8a2a3d6fcefd9427ac46b07c91d21207aaa0e168",
      "signer_label": null,
      "trader": "0x8a2a3d6fcefd9427ac46b07c91d21207aaa0e168",
      "trader_app": null,
      "trader_label": null,
      "ts": 1793225076000,
      "tx": "0xa3a9ddaaa96d7cc4d300eb5ae37d174755cee56aec3e5e15ae7c3adf437a113b",
      "tx_index": 10,
      "type": "buy",
      "value_eth": 0.0112146,
      "value_usd": 26.4316,
      "via": [
        "gmgn_swap_router"
      ]
    }
  ],
  "meta": {
    "block": 100406789,
    "block_age_ms": 367,
    "block_ts": 1793225077000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 7,
    "next_cursor": "100406782-32",
    "safe_block": 100401329
  }
}
```

[Report an issue](mailto:support@crius.sh?subject=Docs%20issue%3A%20GET%20%2Fv1%2F%7Bchain%7D%2Ftoken%2F%7Baddress%7D%2Ftrades&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Ftrades%2Ftrade-tape%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)
