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"
      }
    },
    {
      "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"
      }
    }
  ],
  "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"
      }
    },
    {
      "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"
      }
    }
  ],
  "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.

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.

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

CoinGecko API

Onchain API

Trades by Wallet Address

Notes

Authorizations

Path Parameters

Query Parameters

Response

​Notes

Authorizations

Path Parameters

Query Parameters

Response

Notes