# Wallet trades

> Every trade the wallet made across all tokens, newest first, in the same shape as the trade tape plus the token.

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

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

Every trade the wallet made across all tokens, newest first, in the same shape as the trade tape plus the token. Filter by `token`, `side`, `min_usd` and time.

## Path parameters

`chain`stringrequired

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

`address`stringrequired

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

## Query parameters

`token`string

Only trades of this token.

`side`string

`buy` or `sell`.

`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).

`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 a wallet's holdings and PnL on Robinhood Chain**Get a Robinhood Chain wallet's tokens with USD value, ETH balance, realized and unrealized PnL, win rate, gas spent and wallet tags in one call. Real example.](https://docs.crius.sh/guides/get-wallet-pnl-and-holdings/)[**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 API for wallets and portfolio apps**What a Robinhood Chain wallet or portfolio app needs from the Crius API: holdings, USD values, PnL, trade history and warnings about spam tokens.](https://docs.crius.sh/use-cases/wallets-and-portfolio-apps/)

## 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 wallets & devs endpoints

[GET/wallet/{address}Wallet profileStarter · 5 cr](https://docs.crius.sh/reference/wallets/wallet-profile/)[GET/wallet/{address}/connectionsWallet connectionsStarter · 10 cr](https://docs.crius.sh/reference/wallets/wallet-connections/)[GET/dev/{address}Developer profileFree · 5 cr](https://docs.crius.sh/reference/wallets/developer-profile/)

Request Needs a Starter key

 

**cURL**

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

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca/trades?limit=20", {
  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/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca/trades?limit=20",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

Response 200 · captured Oct 28, 2026

```json
{
  "data": [],
  "meta": {
    "block": 100406866,
    "block_age_ms": 557,
    "block_ts": 1793225085000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 110,
    "next_cursor": null,
    "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%2Fwallet%2F%7Baddress%7D%2Ftrades&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Fwallets%2Fwallet-trades%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)