---
title: "Token Transfers by Wallet Address"
method: GET
path: "/onchain/networks/{network}/wallets/{address}/transfers"
---

# Token Transfers by Wallet Address

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

## Request

- Base URL: `https://pro-api.coingecko.com/api/v3`
- URL: `https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/wallets/{address}/transfers`
- 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 token transfers of a wallet address on a network

## Path parameters

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

## Query parameters

- `token` string
- `from` string
- `to` string
- `direction` 'in' | 'out'
- `cursor` string
- `per_page` integer

## Response `200`

Wallet token transfers data

- WalletTokenTransfers
  - `data` object[], required
    - `id` string, required: Transfer identifier
    - `type` string, required: Resource type
    - `attributes` object, required
      - `block_number` integer, required: Block number of the transfer
      - `tx_hash` string, required: Transaction hash
      - `direction` string, required: Transfer direction relative to the queried wallet, either in or out
      - `token_address` string, required: Token contract address
      - `amount_raw` string, required: Transfer amount in the smallest unit, before decimals are applied
      - `amount` string, nullable, required: Transfer amount at full precision
      - `block_timestamp` string, date-time, required: Block timestamp of the transfer
      - `from_address` string, required: Sender address
      - `to_address` string, required: Recipient address
      - `name` string, required: Token name
      - `symbol` string, required: Token symbol
      - `decimals` integer, required: Token decimals
  - `meta` object, required
    - `next_cursor` string, nullable, required: Cursor for the next page, null when there are no further pages

---

[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)