Docs
La Recherche⌘ K
  • Accueil
  • À propos de The Graph
  • Réseaux pris en charge
  • Contrats du Protocole
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Graph Horizon
                • Resources
                  Token API > SVM Token Endpoints

                  Token Balances

                  GET/v1/svm/balances

                  Returns SPL token balances for Solana token owners with mint and program data.

                  Paramètres de requête

                  ParameterDescriptionValue
                  network
                  string

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

                  • Accepted values: solana
                  Required
                  solana
                  owner
                  string

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

                    Required
                    token_account
                    string

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

                      mint
                      string

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

                        program_id
                        string

                        Filter by SPL token program ID

                        • Accepted values: 11111111111111111111111111111111, TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb, TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                        include_null_balances
                        boolean

                        Include zero/null balances in results

                          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⁠

                          Native BalancesAccount Owner Lookup
                          Test this endpoint

                          1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/svm/balances?network=solana&owner=GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9&token_account=5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW&mint=pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn&include_null_balances=false&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                          1{2  "data": [3    {4      "last_update": "2025-10-09 02:10:01",5      "last_update_block_num": 372132067,6      "last_update_timestamp": 1759975801,7      "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",8      "owner": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9",9      "token_account": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW",10      "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",11      "amount": "85605114004",12      "value": 85605.114004,13      "decimals": 6,14      "name": "Pump",15      "symbol": "PUMP",16      "uri": "https://ipfs.io/ipfs/bafkreibcglldkfdekdkxgumlveoe6qv3pbiceypkwtli33clbzul7leo4m",17      "network": "solana"18    }19  ]20}
                          The GraphStatusTestnetActifs de la MarqueForumSécuritéPolitique de confidentialitéConditions d'utilisation