Trades by Wallet Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/wallets/{address}/trades \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": [
    {
      "id": "eth_26014653_0x62cea982714040d1e3ccbbb7b34f2038b21ad8f0807f38ab5b649937328f2e21_70_1789858264",
      "type": "trade",
      "attributes": {
        "pool_address": "0x86ce2637f272a2972b0652492c4830458d008d29",
        "pool_dex": "uniswap_v2",
        "block_number": 26014653,
        "block_timestamp": "2026-09-19T22:50:59Z",
        "tx_hash": "0x62cea982714040d1e3ccbbb7b34f2038b21ad8f0807f38ab5b649937328f2e21",
        "tx_from_address": "0x7942262a7a5637e6eb0eec9b91b55ec232141f87",
        "kind": "sell",
        "from_token_address": "0x12419a0427c2a27a61c1cb4a49f5fad24fd4e671",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "from_token_amount": "103506.532814702",
        "to_token_amount": "0.00501453238225022",
        "price_from_in_usd": "0.000127363990398952",
        "price_to_in_usd": "2628.96",
        "price_from_in_currency_token": "0.0000000484465303385948",
        "price_to_in_currency_token": "1.0",
        "volume_in_usd": "13.1830050516405",
        "is_anomalous": false
      }
    },
    {
      "id": "eth_26010581_0x7ee572c77ff5ff2fa994eb75ae2a02220313eae9cd68e057bf505a83330d63a9_146_1789809092",
      "type": "trade",
      "attributes": {
        "pool_address": "0x40efafe9250b43b7c1be0ec1a75e4e7526559507",
        "pool_dex": "uniswap_v2",
        "block_number": 26010581,
        "block_timestamp": "2026-09-19T09:11:23Z",
        "tx_hash": "0x7ee572c77ff5ff2fa994eb75ae2a02220313eae9cd68e057bf505a83330d63a9",
        "tx_from_address": "0x7942262a7a5637e6eb0eec9b91b55ec232141f87",
        "kind": "buy",
        "from_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "to_token_address": "0x57737ded3870e43fed7d80d31e0ced3d5fb0cccc",
        "from_token_amount": "0.198",
        "to_token_amount": "2119603.73334363",
        "price_from_in_usd": "2652.59",
        "price_to_in_usd": "0.00024778821236151",
        "price_from_in_currency_token": "1.0",
        "price_to_in_currency_token": "0.0000000934136871365381",
        "volume_in_usd": "525.21282",
        "is_anomalous": false
      }
    }
  ],
  "meta": {
    "next_cursor": null
  }
}

GET

onchain

networks

{network}

wallets

{address}

trades

Trades by Wallet Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/wallets/{address}/trades \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": [
    {
      "id": "eth_26014653_0x62cea982714040d1e3ccbbb7b34f2038b21ad8f0807f38ab5b649937328f2e21_70_1789858264",
      "type": "trade",
      "attributes": {
        "pool_address": "0x86ce2637f272a2972b0652492c4830458d008d29",
        "pool_dex": "uniswap_v2",
        "block_number": 26014653,
        "block_timestamp": "2026-09-19T22:50:59Z",
        "tx_hash": "0x62cea982714040d1e3ccbbb7b34f2038b21ad8f0807f38ab5b649937328f2e21",
        "tx_from_address": "0x7942262a7a5637e6eb0eec9b91b55ec232141f87",
        "kind": "sell",
        "from_token_address": "0x12419a0427c2a27a61c1cb4a49f5fad24fd4e671",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "from_token_amount": "103506.532814702",
        "to_token_amount": "0.00501453238225022",
        "price_from_in_usd": "0.000127363990398952",
        "price_to_in_usd": "2628.96",
        "price_from_in_currency_token": "0.0000000484465303385948",
        "price_to_in_currency_token": "1.0",
        "volume_in_usd": "13.1830050516405",
        "is_anomalous": false
      }
    },
    {
      "id": "eth_26010581_0x7ee572c77ff5ff2fa994eb75ae2a02220313eae9cd68e057bf505a83330d63a9_146_1789809092",
      "type": "trade",
      "attributes": {
        "pool_address": "0x40efafe9250b43b7c1be0ec1a75e4e7526559507",
        "pool_dex": "uniswap_v2",
        "block_number": 26010581,
        "block_timestamp": "2026-09-19T09:11:23Z",
        "tx_hash": "0x7ee572c77ff5ff2fa994eb75ae2a02220313eae9cd68e057bf505a83330d63a9",
        "tx_from_address": "0x7942262a7a5637e6eb0eec9b91b55ec232141f87",
        "kind": "buy",
        "from_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "to_token_address": "0x57737ded3870e43fed7d80d31e0ced3d5fb0cccc",
        "from_token_amount": "0.198",
        "to_token_amount": "2119603.73334363",
        "price_from_in_usd": "2652.59",
        "price_to_in_usd": "0.00024778821236151",
        "price_from_in_currency_token": "1.0",
        "price_to_in_currency_token": "0.0000000934136871365381",
        "volume_in_usd": "525.21282",
        "is_anomalous": false
      }
    }
  ],
  "meta": {
    "next_cursor": null
  }
}

Notes

Paginate with cursor rather than a page number:
- Pass meta.next_cursor back unchanged as cursor to fetch the next page.
- meta.next_cursor is null on the last page.
- An invalid or expired cursor returns a 400. Restart pagination without cursor.

from and to must be provided together, and the window between them cannot exceed 30 days.

Omit both to get the most recent 7 days.
Providing only one of them returns a 400.

SDK Examples

const response = await client.onchain.networks.wallets.trades.get('0x7942262a7a5637e6eb0eec9b91b55ec232141f87', {
  network: 'eth',
});

console.log(JSON.stringify(response, null, 2));

response = client.onchain.networks.wallets.trades.get(
  "0x7942262a7a5637e6eb0eec9b91b55ec232141f87",
  network="eth",
)

print(response.model_dump_json(indent=2))

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

network

string

default:eth

required

Network ID. *refers to /onchain/networks.

address

string

default:0x7942262a7a5637e6eb0eec9b91b55ec232141f87

required

Wallet address.

Query Parameters

token

string

Filter trades by token contract address, returning only trades involving this token.

from

string

Starting date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility. Must be provided together with to.

string

Ending date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility. Must be provided together with from.

include_anomalous

boolean

Include trades flagged as anomalous. Default: false

cursor

string

Cursor from the previous response, passed back unchanged to fetch the next page.

per_page

integer

Total results per page. Default value: 100 Valid values: 1...300

Response

200 - application/json

Wallet trades data

data

object[]

required

Hide child attributes

data.id

string

required

Trade identifier

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.pool_address

string

required

Pool contract address where the trade occurred

data.attributes.pool_dex

string

required

DEX identifier of the pool

data.attributes.block_number

integer

required

Block number of the trade

data.attributes.block_timestamp

string<date-time>

required

Block timestamp of the trade

data.attributes.tx_hash

string

required

Transaction hash

data.attributes.tx_from_address

string

required

Transaction sender address

data.attributes.kind

string

required

Trade kind, either buy or sell

data.attributes.from_token_address

string

required

From-token contract address

data.attributes.to_token_address

string

required

To-token contract address

data.attributes.from_token_amount

string

required

Amount of token sent

data.attributes.to_token_amount

string

required

Amount of token received

data.attributes.price_from_in_usd

string

required

Price of from-token in USD

data.attributes.price_to_in_usd

string

required

Price of to-token in USD

data.attributes.price_from_in_currency_token

string

required

Price of from-token in currency token

data.attributes.price_to_in_currency_token

string

required

Price of to-token in currency token

data.attributes.volume_in_usd

string

required

Trade volume in USD

data.attributes.is_anomalous

boolean

required

Whether the trade is flagged as anomalous

CoinGecko API

Onchain API

Trades by Wallet Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples