---
title: "Trades by Wallet Address"
method: GET
path: "/onchain/networks/{network}/wallets/{address}/trades"
---

# Trades by Wallet Address

`GET /onchain/networks/{network}/wallets/{address}/trades`

## Request

- Base URL: `https://pro-api.coingecko.com/api/v3`
- URL: `https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/wallets/{address}/trades`
- Auth: one of:
  - API key in header `x-cg-pro-api-key`
  - API key in query parameter `x_cg_pro_api_key`

To query the trades of a wallet address on a network

## Path parameters

- `network` string, required
- `address` string, required

## Query parameters

- `token` string
- `from` string
- `to` string
- `include_anomalous` boolean
- `cursor` string
- `per_page` integer

## Response `200`

Wallet trades data

- WalletTrades
  - `data` object[], required
    - `id` string, required: Trade identifier
    - `type` string, required: Resource type
    - `attributes` object, required
      - `pool_address` string, required: Pool contract address where the trade occurred
      - `pool_dex` string, required: DEX identifier of the pool
      - `block_number` integer, required: Block number of the trade
      - `block_timestamp` string, date-time, required: Block timestamp of the trade
      - `tx_hash` string, required: Transaction hash
      - `tx_from_address` string, required: Transaction sender address
      - `kind` string, required: Trade kind, either buy or sell
      - `from_token_address` string, required: From-token contract address
      - `to_token_address` string, required: To-token contract address
      - `from_token_amount` string, required: Amount of token sent
      - `to_token_amount` string, required: Amount of token received
      - `price_from_in_usd` string, required: Price of from-token in USD
      - `price_to_in_usd` string, required: Price of to-token in USD
      - `price_from_in_currency_token` string, required: Price of from-token in currency token
      - `price_to_in_currency_token` string, required: Price of to-token in currency token
      - `volume_in_usd` string, required: Trade volume in USD
      - `is_anomalous` boolean, required: Whether the trade is flagged as anomalous
  - `meta` object, required
    - `next_cursor` string, nullable, required: Cursor for the next page, null when there are no further pages

## Changes

> 29 revisions in range; 1 not diffed.

- **2026-10-20** `e4bff3bc4ce0`: 2 info
  - added the new optional `query` request parameter `include_anomalous`
  - added the required property `data/items/attributes/is_anomalous` to the response with the `200` status

[Operation history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/onchain/networks/:network/wallets/:address/trades/get.md)

---

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