# Activity feed

> One chronological feed of everything that happened to the token: buys and sells, liquidity adds and removes, plain transfers, mints and burns, LP lock events,…

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

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

One chronological feed of everything that happened to the token: buys and sells, liquidity adds and removes, plain transfers, mints and burns, LP lock events, fee claims, owner actions on the contract (`renounceOwnership`, `openTrading`, setters, upgrades) and launchpad lifecycle events. Filter with `type` (comma list), `wallet`, `min_usd`, `from`/`to` and `finality`.

> Trades, liquidity adds/removes, transfers, mints/burns, owner actions (decoded), locks, fee claims, launch / graduation.

## Path parameters

`chain`stringrequired

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

`address`stringrequired

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

## Query parameters

`type`string

Filter by item type. Comma list of `buy`, `sell`, `add_liquidity`, `remove_liquidity`, `transfer`, `mint`, `burn`, `owner_action`, `lock`, `fee_claim`, `launch`, `graduation`.

`wallet`string

Only events involving this wallet.

`min_usd`number

Only items worth at least this many USD.

`from`string

Start of the window (`block:`, `ts:`, `mcap:` or a label). One of `block:N`, `ts:MS`, `mcap:USD`, `launch`, `trading_open`, `graduation`, `ath`.

`to`string

End of the window (same forms as `from`).

`finality`string

Only rows at or below this finality level. One of `latest`, `safe`, `finalized`.

`limit`integer Default `50`

Maximum number of items to return.

`cursor`string

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

## Guides that use this endpoint

[**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/)[**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/)

## 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}/tradesTrade tapeAnonymous · 2 cr](https://docs.crius.sh/reference/trades/trade-tape/)[GET/token/{address}/candlesOHLCV candlesAnonymous · 2 cr](https://docs.crius.sh/reference/trades/ohlcv-candles/)

Request Needs a Free key

 

**cURL**

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

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/transactions?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/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/transactions?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": [
    {
      "actor": "0xffb51d3cc36b1356d5b9418198adee9f29283c58",
      "actor_tags": [],
      "amount_base": 788818.58267172958349331,
      "amount_quote": 0.001303958643843039,
      "block": 100128111,
      "dex": "uniswap_v4",
      "fees": {
        "token_tax": {
          "pct": 0
        }
      },
      "finality": "finalized",
      "id": "100128111-7-34",
      "method": "dagSwapTo(uint256,address,(uint256,address,uint256,uint256,uint256),(address[],address[],uint256[],bytes[],uint256)[])",
      "pool": "0x871b166182fd708d5d16a4daa9a42f05a653fa51ee2b195097f425e0d9ca4913",
      "quote_symbol": "ETH",
      "trader": "0xffb51d3cc36b1356d5b9418198adee9f29283c58",
      "trader_tags": [],
      "ts": 1793196203320,
      "tx": "0x8d68dc0ee4294bf07b052c4684ccc7211e9944438fa23c0866ccadb1aa1a0999",
      "type": "sell",
      "value_usd": 3.04084
    },
    {
      "actor": "0x06386c82d3d4be2704f9ca7da3b0b7422cf7472c",
      "actor_tags": [],
      "amount_base": 740848.926745217054477405,
      "amount_quote": 0.001227267922525477,
      "block": 99713565,
      "dex": "uniswap_v4",
      "fees": {
        "token_tax": {
          "pct": 0
        }
      },
      "finality": "finalized",
      "id": "99713565-9-26",
      "method": null,
      "pool": "0x871b166182fd708d5d16a4daa9a42f05a653fa51ee2b195097f425e0d9ca4913",
      "quote_symbol": "ETH",
      "trader": "0x06386c82d3d4be2704f9ca7da3b0b7422cf7472c",
      "trader_tags": [],
      "ts": 1793152958500,
      "tx": "0x74cd5b3dd10ab859b6e6da32e9352880cce954a8702378879f078c76936dc489",
      "type": "sell",
      "value_usd": 2.88648
    },
    {
      "actor": "0x4337044e8b7a221d141fe622eb2460f050a6b6c2",
      "actor_tags": [],
      "amount_base": 3467283.726496635780002732,
      "amount_quote": 0.005777579700862946,
      "block": 99235194,
      "dex": "uniswap_v4",
      "fees": {
        "token_tax": {
          "pct": 0
        }
      },
      "finality": "finalized",
      "id": "99235194-5-13",
      "method": "handleOps((address,uint256,bytes,bytes,bytes32,uint256,bytes32,bytes,bytes)[],address)",
      "pool": "0x871b166182fd708d5d16a4daa9a42f05a653fa51ee2b195097f425e0d9ca4913",
      "quote_symbol": "ETH",
      "trader": "0x4498f864313237eb18f593fecd47181979551376",
      "trader_tags": [
        "smart_account",
        "fomo"
      ],
      "ts": 1793103300400,
      "tx": "0x504e29889e0ff0dd2a4a5e70f4e47d2fe0f9c48eed33604fad83a199efd10c94",
      "type": "sell",
      "value_usd": 13.3484
    }
  ],
  "meta": {
    "block": 100406803,
    "block_age_ms": 823,
    "block_ts": 1793225078000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "history": "complete",
    "lag_ms": 80,
    "next_cursor": "99235194-13",
    "safe_block": 100401329
  }
}
```

[Get a key for this endpoint](https://dashboard.crius.sh/signup?ref=docs-endpoint) [Report an issue](mailto:support@crius.sh?subject=Docs%20issue%3A%20GET%20%2Fv1%2F%7Bchain%7D%2Ftoken%2F%7Baddress%7D%2Ftransactions&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Ftrades%2Factivity-feed%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)
