> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Token Transfer History



## OpenAPI

````yaml openapi.json GET /gateway/v1/token/transfers
openapi: 3.1.0
info:
  title: Hermod
  version: 0.0.1
servers:
  - url: https://api.asksurf.ai
security: []
paths:
  /gateway/v1/token/transfers:
    get:
      tags:
        - Token
      summary: Token Transfer History
      description: >-
        Returns recent transfer events **for a specific token** (ERC-20/TRC-20
        contract).


        Pass the **token contract address** in `address` — returns every
        on-chain transfer of that token regardless of sender/receiver.


        **Included fields:** sender, receiver, raw amount, block timestamp.


        Use this to analyze a token's on-chain activity (e.g. large movements,
        distribution patterns).


        **Lookup:** `address` (token contract) + `chain`. Sort by `asc` or
        `desc`.


        **Data refresh:** ~24 hours · **Chains:** Ethereum, Base, TRON (Solana
        uses a different source with no delay)
      operationId: token-transfers
      parameters:
        - description: Token contract address (0x-prefixed hex or Solana base58)
          explode: false
          in: query
          name: address
          required: true
          schema:
            description: Token contract address (0x-prefixed hex or Solana base58)
            examples:
              - '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
            type: string
        - description: Chain. Can be `ethereum`, `base`, `solana`, or `tron`.
          explode: false
          in: query
          name: chain
          required: true
          schema:
            description: Chain. Can be `ethereum`, `base`, `solana`, or `tron`.
            enum:
              - ethereum
              - base
              - solana
              - tron
            examples:
              - ethereum
            type: string
        - description: >-
            Start of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to
            30 days ago.
          explode: false
          in: query
          name: from
          schema:
            description: >-
              Start of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults
              to 30 days ago.
            examples:
              - '2025-01-01'
            type: string
        - description: >-
            End of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to
            today.
          explode: false
          in: query
          name: to
          schema:
            description: >-
              End of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to
              today.
            examples:
              - '2025-03-01'
            type: string
        - description: Results per page
          explode: false
          in: query
          name: limit
          schema:
            default: 20
            description: Results per page
            examples:
              - 20
            format: int64
            maximum: 100
            minimum: 1
            type: integer
        - description: Pagination offset
          explode: false
          in: query
          name: offset
          schema:
            default: 0
            description: Pagination offset
            examples:
              - 0
            format: int64
            minimum: 0
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponseTokenTransferItem'
          description: OK
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataAPIError'
          description: Error
      security:
        - AccessToken: []
components:
  schemas:
    DataResponseTokenTransferItem:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://example.com/schemas/DataResponseTokenTransferItem.json
          format: uri
          readOnly: true
          type: string
        data:
          items:
            $ref: '#/components/schemas/TokenTransferItem'
          type:
            - array
            - 'null'
        meta:
          $ref: '#/components/schemas/OffsetMeta'
      required:
        - data
        - meta
      type: object
    DataAPIError:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://example.com/schemas/DataAPIError.json
          format: uri
          readOnly: true
          type: string
        error:
          $ref: '#/components/schemas/DataAPIErrorDetail'
      required:
        - error
      type: object
    TokenTransferItem:
      additionalProperties: false
      properties:
        amount:
          description: Transfer amount (decimal-adjusted, human-readable)
          type: string
        amount_usd:
          description: >-
            Transfer value in USD at the time of the transaction. Not available
            for all transfers.
          format: double
          type: number
        block_number:
          description: Block number in which this transfer was included
          format: int64
          type: integer
        from_address:
          description: Sender wallet address
          type: string
        symbol:
          description: Token symbol like ETH, USDC, or WETH
          type: string
        timestamp:
          description: Unix timestamp in seconds when the transfer occurred
          format: int64
          type: integer
        to_address:
          description: Recipient wallet address
          type: string
        tx_hash:
          description: Transaction hash
          type: string
      required:
        - tx_hash
        - from_address
        - to_address
        - amount
        - timestamp
        - block_number
      type: object
    OffsetMeta:
      additionalProperties: false
      properties:
        cached:
          description: Whether this response was served from cache
          type: boolean
        credits_used:
          description: Credits deducted for this request
          format: int64
          type: integer
        limit:
          description: Maximum number of items returned in this response
          format: int64
          type: integer
        offset:
          description: Number of items skipped (pagination offset)
          format: int64
          type: integer
        total:
          description: >-
            Total number of matching items (before pagination). Omitted when
            total is unknown.
          format: int64
          type: integer
      required:
        - limit
        - offset
        - credits_used
        - cached
      type: object
    DataAPIErrorDetail:
      additionalProperties: false
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
      type: object

````