Skip to main content
GET
/
accounts
/
{address}
/
balances
Get account balances
curl --request GET \
  --url https://grid.squads.xyz/api/grid/v1/accounts/{address}/balances \
  --header 'Authorization: Bearer <token>' \
  --header 'x-grid-environment: <api-key>'
{
  "data": {
    "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "lamports": 1000000000,
    "sol": 1,
    "tokens": [
      {
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "amount": "500000000",
        "decimals": 6,
        "symbol": "USDC",
        "name": "USD Coin"
      }
    ]
  },
  "metadata": {
    "request_id": "123e4567-e89b-12d3-a456-426614174005",
    "timestamp": "2023-07-15T14:35:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication with Bearer token. Include the API key in the Authorization header as 'Bearer YOUR_API_KEY'

​
x-grid-environment
string
header
required

Environment identifier for the Grid API. Use 'sandbox' for testing on devnet or 'production' for production on mainnet.

Path Parameters

​
address
string
required

Account address

Example:

"11111111111111111111111111111112"

Query Parameters

​
limit
integer
default:10

Number of token balances to return

Required range: 1 <= x <= 100
​
page
integer
default:1

Page number for pagination

Required range: x >= 1

Response

Account balances retrieved successfully

​
data
object
required

The actual response payload

​
metadata
object
required
⌘I