Token Transfers by Wallet Address

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

{
  "data": [
    {
      "id": "eth_25937833_0xe3d3005d33af5e5ea60ebe3c16436691ac44a862f7f7bdf133114c0b4110d9f0_299_out",
      "type": "transfer",
      "attributes": {
        "block_number": 25937833,
        "tx_hash": "0xe3d3005d33af5e5ea60ebe3c16436691ac44a862f7f7bdf133114c0b4110d9f0",
        "direction": "out",
        "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "amount_raw": "7999906000",
        "amount": "7999.906",
        "block_timestamp": "2026-09-09T05:50:11Z",
        "from_address": "0x9642b23ed1e01df1092b92641051881a322f5d4e",
        "to_address": "0xf8932784396f4f122bbb7ff62fab2a85e400646b",
        "name": "Tether USD",
        "symbol": "USDT",
        "decimals": 6
      }
    },
    {
      "id": "eth_25937832_0x0f8c5a214905a7590e9b4f55821e89dd790e8569f2f91db46cce0cb13f8023fb_144_in",
      "type": "transfer",
      "attributes": {
        "block_number": 25937832,
        "tx_hash": "0x0f8c5a214905a7590e9b4f55821e89dd790e8569f2f91db46cce0cb13f8023fb",
        "direction": "in",
        "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "amount_raw": "3401000000",
        "amount": "3401.0",
        "block_timestamp": "2026-09-09T05:49:59Z",
        "from_address": "0x5fa654326317a2a5d69bc97e5a0ea9fe6f092cd5",
        "to_address": "0x9642b23ed1e01df1092b92641051881a322f5d4e",
        "name": "USD Coin",
        "symbol": "USDC",
        "decimals": 6
      }
    }
  ],
  "meta": {
    "next_cursor": "eyJibG9ja19udW1iZXIiOjI1OTM3ODMyLCJsb2dfaW5kZXgiOjE0NCwiZGlyZWN0aW9uIjoiaW4iLCJmcm9tIjoxNzg4MzI4MjQ3LCJ0byI6MTc4ODkzMzA0N30"
  }
}

GET

onchain

networks

{network}

wallets

{address}

transfers

Token Transfers by Wallet Address

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

{
  "data": [
    {
      "id": "eth_25937833_0xe3d3005d33af5e5ea60ebe3c16436691ac44a862f7f7bdf133114c0b4110d9f0_299_out",
      "type": "transfer",
      "attributes": {
        "block_number": 25937833,
        "tx_hash": "0xe3d3005d33af5e5ea60ebe3c16436691ac44a862f7f7bdf133114c0b4110d9f0",
        "direction": "out",
        "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "amount_raw": "7999906000",
        "amount": "7999.906",
        "block_timestamp": "2026-09-09T05:50:11Z",
        "from_address": "0x9642b23ed1e01df1092b92641051881a322f5d4e",
        "to_address": "0xf8932784396f4f122bbb7ff62fab2a85e400646b",
        "name": "Tether USD",
        "symbol": "USDT",
        "decimals": 6
      }
    },
    {
      "id": "eth_25937832_0x0f8c5a214905a7590e9b4f55821e89dd790e8569f2f91db46cce0cb13f8023fb_144_in",
      "type": "transfer",
      "attributes": {
        "block_number": 25937832,
        "tx_hash": "0x0f8c5a214905a7590e9b4f55821e89dd790e8569f2f91db46cce0cb13f8023fb",
        "direction": "in",
        "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "amount_raw": "3401000000",
        "amount": "3401.0",
        "block_timestamp": "2026-09-09T05:49:59Z",
        "from_address": "0x5fa654326317a2a5d69bc97e5a0ea9fe6f092cd5",
        "to_address": "0x9642b23ed1e01df1092b92641051881a322f5d4e",
        "name": "USD Coin",
        "symbol": "USDC",
        "decimals": 6
      }
    }
  ],
  "meta": {
    "next_cursor": "eyJibG9ja19udW1iZXIiOjI1OTM3ODMyLCJsb2dfaW5kZXgiOjE0NCwiZGlyZWN0aW9uIjoiaW4iLCJmcm9tIjoxNzg4MzI4MjQ3LCJ0byI6MTc4ODkzMzA0N30"
  }
}

Notes

direction is relative to the queried wallet, so the counterparty is whichever of from_address and to_address is not that wallet:
direction Queried wallet is Transfer was
in to_address received
out from_address sent
amount is full precision and never rounded, but comes back null when the token cannot be resolved. amount_raw is always present, so fall back to it and convert with decimals: amount_raw / 10^decimals.
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.

`direction`	Queried wallet is	Transfer was
`in`	`to_address`	received
`out`	`from_address`	sent

Supported networks

Chain	Network `id`
Ethereum	`eth`
Base	`base`
BNB Chain	`bsc`
Polygon	`polygon_pos`
Arbitrum	`arbitrum`
Optimism	`optimism`
Avalanche	`avax`
Stable	`stable`
Robinhood	`robinhood`

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 supported networks.

address

string

default:0x9642b23ed1e01df1092b92641051881a322f5d4e

required

Wallet address.

Query Parameters

token

string

Filter transfers by token contract address.

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.

direction

enum<string>

Filter transfers by direction, relative to the queried wallet. Omit to return both.

Available options:

in,

out

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 token transfers data

data

object[]

required

Hide child attributes

data.id

string

required

Transfer identifier

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.block_number

integer

required

Block number of the transfer

data.attributes.tx_hash

string

required

Transaction hash

data.attributes.direction

string

required

Transfer direction relative to the queried wallet, either in or out

data.attributes.token_address

string

required

Token contract address

data.attributes.amount_raw

string

required

Transfer amount in the smallest unit, before decimals are applied

data.attributes.amount

string | null

required

Transfer amount at full precision

data.attributes.block_timestamp

string<date-time>

required

Block timestamp of the transfer

data.attributes.from_address

string

required

Sender address

data.attributes.to_address

string

required

Recipient address

data.attributes.name

string

required

Token name

data.attributes.symbol

string

required

Token symbol

data.attributes.decimals

integer

required

Token decimals

CoinGecko API

Onchain API

Token Transfers by Wallet Address

Notes

Authorizations

Path Parameters

Query Parameters

Response

​Notes

Authorizations

Path Parameters

Query Parameters

Response

Notes