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)

                  Token Metadata

                  GET/v1/tvm/tokens

                  Provides TVM token contract metadata.

                  Query Parameters

                  ParameterDescriptionValue
                  network
                  string

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

                  • Accepted values: tron
                  Required
                  tron
                  contract
                  string

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

                    Required

                    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⁠

                    NFT TransfersTRC-20 Transfers
                    Test this endpoint

                    1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/tvm/tokens?network=tron&contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t' \3  --header 'Authorization: Bearer {token}'

                    1{2  "data": [3    {4      "last_update": "2026-02-13 20:52:42",5      "last_update_block_num": 80117031,6      "last_update_timestamp": 1771015962,7      "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",8      "total_transfers": 3051378972,9      "name": "Tether USD",10      "symbol": "USDT",11      "decimals": 6,12      "network": "tron",13      "icon": {14        "web3icon": "usdt"15      }16    }17  ]18}
                    The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service