---
title: "Token - Transfer List"
method: POST
path: "/token/v1/transfer"
tags: ["Balance & Transfer"]
---

# Token - Transfer List

`POST /token/v1/transfer`

Retrieve the transfer history of a specified token

## Headers

- `x-chain` 'solana'

## Request body

- TokenTransferBody
  - `token_address` string, required — Address of the token to retrieve transfers for.
  - `time_from` number — Start of the transfer time range as a Unix timestamp.
  - `time_to` number — End of the transfer time range as a Unix timestamp.
  - `from_amount` number — Minimum token amount to include.
  - `to_amount` number — Maximum token amount to include.
  - `from_value` number — Minimum transfer value in USD to include.
  - `to_value` number — Maximum transfer value in USD to include.
  - `from_wallet` string — Address of the sender wallet.
  - `to_wallet` string — Address of the recipient wallet.
  - `cursor` string — Cursor used to retrieve the next page of results.
  - `limit` number

## Response `200`

JSON object containing list transfer

- CommonResponseType
  - `success` boolean, required
  - `data` object, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. API key is missing or invalid
- `403` — Forbidden. Request is blacklisted or not whitelisted
- `429` — Too Many Requests. Rate limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/birdeye/apis/birdeye-data-api.md) · [All operations](https://skmtc.net/birdeye/apis/birdeye-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/birdeye/birdeye-data-api/revisions/fcaba926a089/schema)