Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • 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.

                  Query Parameters

                  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.

                  • Accepted pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                  • Format: svm-address
                  Required
                  token_account
                  string

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

                  • Accepted pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                  • Format: svm-address
                  mint
                  string

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

                  • Accepted pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                  • Format: svm-address
                  program_id
                  string

                  Filter by SPL token program ID

                  • Accepted values: 11111111111111111111111111111111, TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb, TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                  TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
                  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⁠

                    Token HoldersAccount Owner Lookup
                    Test this endpoint

                    1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/svm/balances?network=solana&owner=GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9&mint=pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn&program_id=TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb&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 GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service