Trades by Token Address

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

{
  "data": [
    {
      "id": "eth_25191526_0xe9d83fd4f20bd9a4d262df47aaed68822d8312adc903623dc08f004d0db42c48_418_1779943449",
      "type": "trade",
      "attributes": {
        "pool_address": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852",
        "pool_dex": "uniswap_v2",
        "block_number": 25191526,
        "tx_hash": "0xe9d83fd4f20bd9a4d262df47aaed68822d8312adc903623dc08f004d0db42c48",
        "tx_from_address": "0xabba7bef6dffba87d66e6c3d2d612b1a57df2303",
        "from_token_amount": "18.0",
        "to_token_amount": "0.00906223763828302",
        "price_from_in_currency_token": "0.000503457646571279",
        "price_to_in_currency_token": "1.0",
        "price_from_in_usd": "0.996563779970825",
        "price_to_in_usd": "1979.43915790687",
        "block_timestamp": "2026-05-28T04:43:59Z",
        "kind": "buy",
        "volume_in_usd": "17.9381480394748",
        "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      }
    },
    {
      "id": "eth_25191526_0x41533cb177c05e4b651a1bac8cfb9497a7d325275b668ba6d42d0a2dbf01c3bc_121_1779943444",
      "type": "trade",
      "attributes": {
        "pool_address": "0x54578b6f942aeb23b67a8cef24220651306b8e26",
        "pool_dex": "uniswap_v3",
        "block_number": 25191526,
        "tx_hash": "0x41533cb177c05e4b651a1bac8cfb9497a7d325275b668ba6d42d0a2dbf01c3bc",
        "tx_from_address": "0x930b88a592a045c428f3d99f7f3e5f95e3967508",
        "from_token_amount": "1267.21454522135",
        "to_token_amount": "116.882923",
        "price_from_in_currency_token": "0.0000464421678267092",
        "price_to_in_currency_token": "0.000503514021305036",
        "price_from_in_usd": "0.0919444428573566",
        "price_to_in_usd": "0.996837967006657",
        "block_timestamp": "2026-05-28T04:43:59Z",
        "kind": "sell",
        "volume_in_usd": "116.513335341116",
        "from_token_address": "0x9aab071b4129b083b01cb5a0cb513ce7eca26fa5",
        "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    }
  ],
  "meta": {
    "next_cursor": null
  }
}

GET

onchain

networks

{network}

tokens

{token_address}

trades

Trades by Token Address

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

{
  "data": [
    {
      "id": "eth_25191526_0xe9d83fd4f20bd9a4d262df47aaed68822d8312adc903623dc08f004d0db42c48_418_1779943449",
      "type": "trade",
      "attributes": {
        "pool_address": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852",
        "pool_dex": "uniswap_v2",
        "block_number": 25191526,
        "tx_hash": "0xe9d83fd4f20bd9a4d262df47aaed68822d8312adc903623dc08f004d0db42c48",
        "tx_from_address": "0xabba7bef6dffba87d66e6c3d2d612b1a57df2303",
        "from_token_amount": "18.0",
        "to_token_amount": "0.00906223763828302",
        "price_from_in_currency_token": "0.000503457646571279",
        "price_to_in_currency_token": "1.0",
        "price_from_in_usd": "0.996563779970825",
        "price_to_in_usd": "1979.43915790687",
        "block_timestamp": "2026-05-28T04:43:59Z",
        "kind": "buy",
        "volume_in_usd": "17.9381480394748",
        "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      }
    },
    {
      "id": "eth_25191526_0x41533cb177c05e4b651a1bac8cfb9497a7d325275b668ba6d42d0a2dbf01c3bc_121_1779943444",
      "type": "trade",
      "attributes": {
        "pool_address": "0x54578b6f942aeb23b67a8cef24220651306b8e26",
        "pool_dex": "uniswap_v3",
        "block_number": 25191526,
        "tx_hash": "0x41533cb177c05e4b651a1bac8cfb9497a7d325275b668ba6d42d0a2dbf01c3bc",
        "tx_from_address": "0x930b88a592a045c428f3d99f7f3e5f95e3967508",
        "from_token_amount": "1267.21454522135",
        "to_token_amount": "116.882923",
        "price_from_in_currency_token": "0.0000464421678267092",
        "price_to_in_currency_token": "0.000503514021305036",
        "price_from_in_usd": "0.0919444428573566",
        "price_to_in_usd": "0.996837967006657",
        "block_timestamp": "2026-05-28T04:43:59Z",
        "kind": "sell",
        "volume_in_usd": "116.513335341116",
        "from_token_address": "0x9aab071b4129b083b01cb5a0cb513ce7eca26fa5",
        "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    }
  ],
  "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.
For an absolute date window instead of a relative lookback, consider Trades within Time Range by Token Address.

SDK Examples

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

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

response = client.onchain.networks.tokens.trades.get(
  "0xdac17f958d2ee523a2206206994597c13d831ec7",
  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.

token_address

string

default:0xdac17f958d2ee523a2206206994597c13d831ec7

required

Token contract address.

Query Parameters

trade_volume_in_usd_greater_than

number

Filter trades by trade volume in USD greater than this value. Default value: 0

trading_period

enum<string>

Lookback period for trades. Default: 1d

Available options:

1d,

7d,

30d

cursor

string

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

per_page

integer

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

Response

200 - application/json

Trades from a token across all pools

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.tx_hash

string

required

Transaction hash

data.attributes.tx_from_address

string

required

Transaction sender 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_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.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.block_timestamp

string

required

Block timestamp

data.attributes.kind

string

required

Trade kind (buy or sell)

data.attributes.volume_in_usd

string

required

Trade volume in USD

data.attributes.from_token_address

string

required

From-token contract address

data.attributes.to_token_address

string

required

To-token contract address

CoinGecko API

Onchain API

Trades by Token Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples