---
title: "Get synced transfers across all registered wallets"
method: GET
path: "/api/v1/transfers"
tags: ["Wallet Transfers"]
---

# Get synced transfers across all registered wallets

`GET /api/v1/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/transfers`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/tether/apis/wdk-indexer-api/docs/api/v1/transfers/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the automatically synced transfer log across all the owner's registered wallets, merged and sorted by timestamp.

## Query parameters

- `blockchain` 'ethereum' | 'arbitrum' | 'avalanche' | 'polygon' | 'plasma' | 'sepolia' | 'tron' | 'ton' | 'bitcoin' | 'spark'
- `token` 'usdt' | 'xaut' | 'usat' | 'btc'
- `type` 'sent' | 'received'
- `from` union
  - integer
  - string, date-time
- `to` union
  - integer
  - string, date-time
- `limit` integer
- `skip` integer
- `sort` 'asc' | 'desc'

## Response `200`

Raw transfer log entries for registered wallets

- object: Raw transfer log entries for registered wallets
  - `transfers` object[]: List of transfers sorted by timestamp.
    - `walletId` string: Wallet the transfer belongs to.
    - `blockchain` string: Blockchain where the transfer occurred.
    - `token` string: Token identifier.
    - `transactionHash` string: Hash of the transaction.
    - `transferIndex` integer: Index of the transfer within the transaction.
    - `blockNumber` integer: Block number containing the transfer.
    - `amount` string: Transfer amount as a decimal string.
    - `from` string: Sender address.
    - `to` string: Recipient address.
    - `ts` 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.
    - `label` string: A label associated with the transfer, if any.
    - `type` 'sent' | 'received': Direction of the transfer relative to the wallet.

## Other responses

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

---

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