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 DEX Endpoints

                  Liquidity Pools

                  GET/v1/tvm/pools

                  Returns DEX pool metadata including tokens, fees and protocol.

                  Query Parameters

                  ParameterDescriptionValue
                  network
                  string

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

                  • Accepted values: tron
                  Required
                  tron
                  factory
                  string

                  Filter by factory 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
                  pool
                  string

                  Filter by pool 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
                  input_token
                  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
                  output_token
                  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
                  protocol
                  string

                  Protocol name

                  • Accepted values: uniswap_v1, uniswap_v2, uniswap_v3, uniswap_v4, sunpump
                  uniswap_v2
                  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⁠

                  Supported DEXsPool OHLCV Data
                  Test this endpoint

                  1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/tvm/pools?network=tron&factory=TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY&pool=TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ&input_token=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&output_token=TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR&protocol=uniswap_v2&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                  1{2  "data": [3    {4      "pool": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",5      "factory": "TXk8rQSAvPvBBNtqSoY6nCfsXWCSSpTVQF",6      "protocol": "uniswap_v1",7      "input_token": {8        "address": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb",9        "symbol": "TRX",10        "decimals": 611      },12      "output_token": {13        "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",14        "symbol": "USDT",15        "decimals": 616      },17      "fee": 3000,18      "network": "tron"19    }20  ]21}
                  The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service