---
title: "Get token transfers"
method: GET
path: "/{chainId}/transfers"
tags: ["transfers"]
---

# Get token transfers

`GET /{chainId}/transfers`

Retrieve token transfers by various filters

## Path parameters

- `chainId` string, required

## Query parameters

- `token_type` string[]
- `token_address` string
- `wallet` string
- `start_block` string
- `end_block` string
- `start_timestamp` string
- `end_timestamp` string
- `token_id` string[]
- `transaction_hash` string
- `page` integer
- `limit` integer

## Response `200`

OK

- object — QueryResponse represents the response structure for a query
  - `aggregations` object[] — @Description Aggregation results
  - `data` HandlersTransferModel[] — @Description Query result data
    - `amount` string
    - `block_number` string
    - `block_timestamp` string
    - `from_address` string
    - `log_index` integer
    - `to_address` string
    - `token_address` string
    - `token_id` string
    - `token_type` string
    - `transaction_hash` string
  - `meta` ApiMeta — Meta represents metadata for a query response
    - `address` string — @Description Contract address
    - `chain_id` integer — @Description Chain ID of the blockchain
    - `limit` integer — @Description Number of items per page
    - `page` integer — @Description Current page number
    - `signature` string — @Description Function or event signature
    - `total_items` integer — @Description Total number of items
    - `total_pages` integer — @Description Total number of pages

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2025-03-18** `d4931dc27ea8` — 1 info
  - endpoint added
- **2024-10-01** `8b52267689cc` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/thirdweb/apis/thirdweb-insight/changes/:chainId/transfers/get.md)

---

[API](https://skmtc.dev/thirdweb/apis/thirdweb-insight.md) · [All operations](https://skmtc.dev/thirdweb/apis/thirdweb-insight/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-insight/revisions/a0a466ab88d5/schema)