---
title: "Get token transfers for an address"
method: GET
path: "/api/v1/{blockchain}/{token}/{address}/token-transfers"
tags: ["Token Transfers"]
---

# Get token transfers for an address

`GET /api/v1/{blockchain}/{token}/{address}/token-transfers`

## Request

- Base URL: `https://wdk-api.tether.io` (the document declares no server; this is the origin it was published from)
- URL: `https://wdk-api.tether.io/api/v1/{blockchain}/{token}/{address}/token-transfers`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/tether/apis/wdk-indexer-api/docs/api/v1/:blockchain/:token/:address/token-transfers/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the token transfer history for a specific wallet address on a given blockchain. Returns incoming and outgoing transfers sorted by block number.

## Path parameters

- `blockchain` 'ethereum' | 'arbitrum' | 'avalanche' | 'polygon' | 'plasma' | 'sepolia' | 'tron' | 'ton' | 'bitcoin' | 'spark', required
- `token` 'usdt' | 'xaut' | 'usat' | 'btc', required
- `address` string, required

## Query parameters

- `limit` integer
- `fromTs` integer
- `toTs` integer

## Response `200`

Token transfer history for the queried address

- object: Token transfer history for the queried address
  - `transfers` object[]: List of token transfers sorted by block number.
    - `blockchain` string: Blockchain where the transfer occurred.
    - `blockNumber` integer: Block number containing the transfer.
    - `transactionHash` string: Hash of the transaction.
    - `transferIndex` integer: Index of the transfer within the transaction.
    - `token` string: Token identifier.
    - `amount` string: Transfer amount as a decimal string.
    - `timestamp` integer: Block timestamp in milliseconds since Unix epoch.
    - `transactionIndex` integer: Position of the transaction within the block.
    - `logIndex` integer: Event log index for EVM chains. null for non-EVM chains like Bitcoin.
    - `from` string: Sender wallet address.
    - `to` string: The recipient's address
    - `label` string: A label associated with the transfer, if any
    - `metadata` object: Chain-specific extra data attached to the transfer, if any.

## Other responses

- `400`: Bad Request - invalid parameters, address format, blockchain, or token
- `401`: Unauthorized - expired API key
- `403`: Forbidden - missing or invalid API key
- `429`: Too Many Requests - rate limit exceeded
- `500`: Internal Server Error - indexer service unavailable or unexpected failure

---

[API](https://skmtc.dev/tether/apis/wdk-indexer-api.md) - [All operations](https://skmtc.dev/tether/apis/wdk-indexer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tether/apis/wdk-indexer-api/revisions/fb8b84e0bb98?raw)