Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Graph Horizon
                • Resources
                  Token API > TVM Token Endpoints (ERC-20)

                  TRC-20 Transfers

                  GET/v1/tvm/transfers

                  Returns TRC-20 transfers with transaction and block data.

                  Query Parameters

                  ParameterDescriptionValue
                  network
                  string

                  The Graph Network ID for TVM networks https://thegraph.com/networks

                  • Accepted values: tron
                  Required
                  tron
                  transaction_id
                  string

                  Filter by transaction hash
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

                  • Accepted pattern: ^[0-9a-fA-F]{64}$
                  • Format: tvm-tx-hash
                  contract
                  string

                  Filter by contract address
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

                  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
                  • Format: tvm-address
                  from_address
                  string

                  Filter by address
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

                  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
                  • Format: tvm-address
                  to_address
                  string

                  Filter by address
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

                  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
                  • Format: tvm-address
                  start_time
                  string

                  UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

                    end_time
                    string

                    UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

                      start_block
                      integer

                      Filter by block number

                      • Minimum value: 0
                      • Maximum value: 9007199254740991
                      end_block
                      integer

                      Filter by block number

                      • Minimum value: 0
                      • Maximum value: 9007199254740991
                      limit
                      integer

                      Number of items* returned in a single request.
                      *Plan restricted.

                      • Default value: 10
                      • Minimum value: 1
                      • Maximum value: 1000
                      page
                      integer

                      Page number to fetch.
                      Empty data array signifies end of results.

                      • Default value: 1
                      • Minimum value: 1
                      • Maximum value: 767465558638

                      Potential Responses

                      StatusDescription
                      200

                      Successful Response

                      400

                      Client side error

                      401

                      Authentication failed

                      403

                      Forbidden

                      404

                      Not found

                      500

                      Server side error

                      ⁠Edit on GitHub⁠

                      Token MetadataNative Metadata
                      Test this endpoint

                      1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/tvm/transfers?network=tron&transaction_id=46c608cd66c873753f7d86a3dc6b46453052505730cc5f6e951533083b1d40ab&contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&from_address=TAYtGZzxZf1GhPfGwZKskWQnz7Qj3rwLDh&to_address=THWuviP5wEiPBLZ1g1iPPiH4kV7FRXWFP1&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                      1{2  "data": [3    {4      "block_num": 49014118,5      "datetime": "2023-03-01 06:55:06",6      "timestamp": 1677653706,7      "transaction_id": "0xa85ee0572469b128690c00a80f03a328c882b7339496faf64a1ad0707b537329",8      "log_index": 0,9      "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",10      "type": "transfer",11      "from": "THx5jmvnQkRjDpYEpkaLn7yCvgafXzxiAF",12      "to": "TCc3eBTbWXcUwfmgWP58VnyVGS6HE3gGe3",13      "name": "Tether USD",14      "symbol": "USDT",15      "decimals": 6,16      "amount": "10000000000",17      "value": 10000,18      "network": "tron"19    }20  ]21}
                      The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service