---
title: "get token transfers"
method: GET
path: "/token-transfers"
---

# get token transfers

`GET /token-transfers`

**Deprecation Notice:** Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the [PRO API reference page](https://docs.blockscout.com/devs/pro-api-responses-and-routes) for information.

## Response `200`

token transfers

- object
  - `items` TokenTransfer[], required
    - `block_hash` string, required
    - `block_number` integer, required
    - `from` Address, required — Address
      - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
      - `hash` string, required
      - `implementations` Implementation[], required — Implementations linked with the contract
        - `address_hash` string, required
        - `name` string, nullable, required
      - `is_contract` boolean, nullable, required — Has address contract code?
      - `is_scam` boolean, required — Has address scam badge?
      - `is_verified` boolean, nullable, required — Has address associated source code?
      - `metadata` Metadata, required — Metadata struct
        - `tags` MetadataTag[], required — Metadata tags linked with the address
          - `meta` object, nullable, required
          - `name` string, required
          - `ordinal` integer, required
          - `slug` string, required
          - `tagType` 'name' | 'generic' | 'classifier' | 'information' | 'note' | 'protocol', required
      - `name` string, nullable, required — Name associated with the address
      - `private_tags` Tag[] — Private tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `proxy_type` 'eip1167' | 'eip1967' | 'eip1822' | 'eip1967_oz' | 'eip1967_beacon' | 'master_copy' | 'basic_implementation' | 'basic_get_implementation' | 'comptroller' | 'eip2535' | 'clone_with_immutable_arguments' | 'eip7702' | 'resolved_delegate_proxy' | 'erc7760' | 'minimal_proxy', nullable, required
      - `public_tags` Tag[] — Public tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `reputation` 'ok' | 'scam', required — Reputation of the address
      - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
        - `display_name` string, required
        - `label` string, required
    - `log_index` integer, required
    - `method` string, nullable, required — Method name or hex method id
    - `timestamp` string, date-time, nullable, required
    - `to` Address, required — Address
      - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
      - `hash` string, required
      - `implementations` Implementation[], required — Implementations linked with the contract
        - `address_hash` string, required
        - `name` string, nullable, required
      - `is_contract` boolean, nullable, required — Has address contract code?
      - `is_scam` boolean, required — Has address scam badge?
      - `is_verified` boolean, nullable, required — Has address associated source code?
      - `metadata` Metadata, required — Metadata struct
        - `tags` MetadataTag[], required — Metadata tags linked with the address
          - `meta` object, nullable, required
          - `name` string, required
          - `ordinal` integer, required
          - `slug` string, required
          - `tagType` 'name' | 'generic' | 'classifier' | 'information' | 'note' | 'protocol', required
      - `name` string, nullable, required — Name associated with the address
      - `private_tags` Tag[] — Private tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `proxy_type` 'eip1167' | 'eip1967' | 'eip1822' | 'eip1967_oz' | 'eip1967_beacon' | 'master_copy' | 'basic_implementation' | 'basic_get_implementation' | 'comptroller' | 'eip2535' | 'clone_with_immutable_arguments' | 'eip7702' | 'resolved_delegate_proxy' | 'erc7760' | 'minimal_proxy', nullable, required
      - `public_tags` Tag[] — Public tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `reputation` 'ok' | 'scam', required — Reputation of the address
      - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
        - `display_name` string, required
        - `label` string, required
    - `token` Token, required — Token struct
      - `address_hash` string, required
      - `bridge_type` 'omni' | 'amb', nullable — Type of bridge used for this bridged token
      - `circulating_market_cap` string, nullable, required
      - `circulating_supply` string, nullable, required
      - `decimals` string, nullable, required
      - `exchange_rate` string, nullable, required
      - `foreign_address` string, nullable
      - `holders_count` string, nullable, required
      - `icon_url` string, uri, nullable, required
      - `name` string, nullable, required
      - `origin_chain_id` string, nullable
      - `reputation` 'ok' | 'scam', nullable, required — Reputation of the token
      - `symbol` string, nullable, required
      - `total_supply` string, nullable, required
      - `type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984', required
      - `volume_24h` string, nullable, required
    - `token_type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984', required
    - `total` union, required
      - TotalERC721
        - `token_id` string, nullable, required
        - `token_instance` TokenInstance, required
          - `animation_media_type` 'image' | 'video' | 'html', nullable — Media type category of the token instance animation URL
          - `animation_url` string, uri, nullable, required
          - `external_app_url` string, uri, nullable, required
          - `id` string, required
          - `image_media_type` 'image' | 'video' | 'html', nullable — Media type category of the token instance image URL
          - `image_url` string, uri, nullable, required
          - `is_unique` boolean, nullable, required
          - `media_type` string, nullable, required — Mime type of the media in media_url
          - `media_url` string, uri, nullable, required
          - `metadata` object, nullable, required
          - `owner` Address, required — Address
            - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
            - `hash` string, required
            - `implementations` Implementation[], required — Implementations linked with the contract
              - …
            - `is_contract` boolean, nullable, required — Has address contract code?
            - `is_scam` boolean, required — Has address scam badge?
            - `is_verified` boolean, nullable, required — Has address associated source code?
            - `metadata` Metadata, required — Metadata struct
              - …
            - `name` string, nullable, required — Name associated with the address
            - `private_tags` Tag[] — Private tags associated with the address
              - …
            - `proxy_type` 'eip1167' | 'eip1967' | 'eip1822' | 'eip1967_oz' | 'eip1967_beacon' | 'master_copy' | 'basic_implementation' | 'basic_get_implementation' | 'comptroller' | 'eip2535' | 'clone_with_immutable_arguments' | 'eip7702' | 'resolved_delegate_proxy' | 'erc7760' | 'minimal_proxy', nullable, required
            - `public_tags` Tag[] — Public tags associated with the address
              - …
            - `reputation` 'ok' | 'scam', required — Reputation of the address
            - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
              - …
          - `thumbnails` object, nullable, required
            - `250x250` string, uri
            - `500x500` string, uri
            - `60x60` string, uri
            - `original` string, uri, required
          - `token` Token, required — Token struct
            - `address_hash` string, required
            - `bridge_type` 'omni' | 'amb', nullable — Type of bridge used for this bridged token
            - `circulating_market_cap` string, nullable, required
            - `circulating_supply` string, nullable, required
            - `decimals` string, nullable, required
            - `exchange_rate` string, nullable, required
            - `foreign_address` string, nullable
            - `holders_count` string, nullable, required
            - `icon_url` string, uri, nullable, required
            - `name` string, nullable, required
            - `origin_chain_id` string, nullable
            - `reputation` 'ok' | 'scam', nullable, required — Reputation of the token
            - `symbol` string, nullable, required
            - `total_supply` string, nullable, required
            - `type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984', required
            - `volume_24h` string, nullable, required
          - `token_type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984'
          - `value` string, nullable
      - TotalERC1155
        - `decimals` string, nullable, required
        - `token_id` string, nullable, required
        - `token_instance` TokenInstance, required
          - `animation_media_type` 'image' | 'video' | 'html', nullable — Media type category of the token instance animation URL
          - `animation_url` string, uri, nullable, required
          - `external_app_url` string, uri, nullable, required
          - `id` string, required
          - `image_media_type` 'image' | 'video' | 'html', nullable — Media type category of the token instance image URL
          - `image_url` string, uri, nullable, required
          - `is_unique` boolean, nullable, required
          - `media_type` string, nullable, required — Mime type of the media in media_url
          - `media_url` string, uri, nullable, required
          - `metadata` object, nullable, required
          - `owner` Address, required — Address
            - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
            - `hash` string, required
            - `implementations` Implementation[], required — Implementations linked with the contract
              - …
            - `is_contract` boolean, nullable, required — Has address contract code?
            - `is_scam` boolean, required — Has address scam badge?
            - `is_verified` boolean, nullable, required — Has address associated source code?
            - `metadata` Metadata, required — Metadata struct
              - …
            - `name` string, nullable, required — Name associated with the address
            - `private_tags` Tag[] — Private tags associated with the address
              - …
            - `proxy_type` 'eip1167' | 'eip1967' | 'eip1822' | 'eip1967_oz' | 'eip1967_beacon' | 'master_copy' | 'basic_implementation' | 'basic_get_implementation' | 'comptroller' | 'eip2535' | 'clone_with_immutable_arguments' | 'eip7702' | 'resolved_delegate_proxy' | 'erc7760' | 'minimal_proxy', nullable, required
            - `public_tags` Tag[] — Public tags associated with the address
              - …
            - `reputation` 'ok' | 'scam', required — Reputation of the address
            - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
              - …
          - `thumbnails` object, nullable, required
            - `250x250` string, uri
            - `500x500` string, uri
            - `60x60` string, uri
            - `original` string, uri, required
          - `token` Token, required — Token struct
            - `address_hash` string, required
            - `bridge_type` 'omni' | 'amb', nullable — Type of bridge used for this bridged token
            - `circulating_market_cap` string, nullable, required
            - `circulating_supply` string, nullable, required
            - `decimals` string, nullable, required
            - `exchange_rate` string, nullable, required
            - `foreign_address` string, nullable
            - `holders_count` string, nullable, required
            - `icon_url` string, uri, nullable, required
            - `name` string, nullable, required
            - `origin_chain_id` string, nullable
            - `reputation` 'ok' | 'scam', nullable, required — Reputation of the token
            - `symbol` string, nullable, required
            - `total_supply` string, nullable, required
            - `type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984', required
            - `volume_24h` string, nullable, required
          - `token_type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984'
          - `value` string, nullable
        - `value` string, nullable, required
      - TotalERC7984
        - `decimals` string, nullable, required
        - `value` string, nullable, required
      - Total
        - `decimals` string, nullable, required
        - `value` string, nullable, required
    - `transaction_hash` string, required
    - `type` 'token_burning' | 'token_minting' | 'token_spawning' | 'token_transfer', required
  - `next_page_params` object, required

## Other responses

- `400` — bad input parameter

---

[API](https://skmtc.net/blockscout/apis/blockscout-pro-api.md) · [All operations](https://skmtc.net/blockscout/apis/blockscout-pro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockscout/blockscout-pro-api/versions/59ac5466233b/schema)