Solana API
Query Solana wallet balances and token holdings, fetch live SOL market data, and save per-user RPC endpoint configurations.
Get SOL price
Returns the current SOL price in USD along with 24-hour market data. Data is sourced from CoinGecko and cached for 60 seconds.
Response
{
"price": 148.52,
"change24h": -2.34,
"marketCap": 72500000000,
"volume24h": 3200000000
}
Response fields
| Field | Type | Description |
|---|
price | number | null | Current SOL price in USD |
change24h | number | null | 24-hour price change percentage |
marketCap | number | null | Market capitalization in USD |
volume24h | number | null | 24-hour trading volume in USD |
Fields return null when CoinGecko does not include them in the response. Price data is cached and refreshed every 60 seconds.
Errors
| Code | Description |
|---|
| 500 | Failed to fetch price data from CoinGecko |
Look up wallet
Returns the SOL balance, token holdings, and account metadata for a Solana address. You can optionally specify a custom RPC endpoint.
Query parameters
| Parameter | Type | Required | Description |
|---|
address | string | Yes | Solana wallet address (base58-encoded, 32–44 characters). Invalid addresses return a 400 error. |
rpc | string | No | Custom Solana JSON-RPC endpoint URL. Defaults to https://api.mainnet-beta.solana.com. |
Response
{
"address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"solBalance": 1.5,
"tokens": [
{
"mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"symbol": "USDC",
"amount": 250.0,
"decimals": 6
},
{
"mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
"symbol": "JUP",
"amount": 100.0,
"decimals": 6
}
],
"accountInfo": {
"isExecutable": false,
"owner": "11111111111111111111111111111111",
"rentEpoch": 18446744073709551615
}
}
Response fields
| Field | Type | Description |
|---|
address | string | The queried wallet address |
solBalance | number | Native SOL balance (in SOL, not lamports) |
tokens | array | SPL token holdings with a non-zero balance, sorted by amount descending (max 20) |
tokens[].mint | string | Token mint address |
tokens[].symbol | string | Token symbol. Known tokens display their ticker (e.g. USDC, JUP); unknown tokens show a truncated mint address. |
tokens[].amount | number | Token balance in human-readable units |
tokens[].decimals | number | Token decimal precision |
accountInfo | object | On-chain account metadata |
accountInfo.isExecutable | boolean | Whether the account contains an executable program |
accountInfo.owner | string | null | Program that owns this account |
accountInfo.rentEpoch | number | null | Epoch at which rent was last collected |
Recognized tokens
The following token mints are resolved to human-readable symbols automatically:
| Symbol | Mint address | Decimals |
|---|
| USDC | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v | 6 |
| USDT | Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB | 6 |
| WSOL | So11111111111111111111111111111111111111112 | 9 |
| JUP | JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN | 6 |
| BONK | DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 | 5 |
| WIF | EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm | 6 |
| mSOL | mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So | 9 |
| stSOL | 7dHbWXmci3dT8UFYWYZweBLXgycu7Y3iL6trKn1Y7ARj | 9 |
Errors
| Code | Description |
|---|
| 400 | Invalid Solana address. The address must be a base58-encoded string between 32 and 44 characters. |
| 500 | Failed to fetch wallet data from the Solana RPC endpoint |
Get RPC configuration
GET /api/solana/rpc-config
Response
{
"rpcUrl": "https://my-custom-rpc.example.com"
}
Response fields
| Field | Type | Description |
|---|
rpcUrl | string | The saved custom RPC URL. Returns an empty string if no custom URL is configured. |
Errors
| Code | Description |
|---|
| 401 | Unauthorized — no valid session |
Save RPC configuration
POST /api/solana/rpc-config
Request body
| Field | Type | Required | Description |
|---|
rpcUrl | string | Yes | A valid HTTPS URL for the custom Solana RPC endpoint |
Example request
{
"rpcUrl": "https://my-custom-rpc.example.com"
}
Response
{
"success": true,
"rpcUrl": "https://my-custom-rpc.example.com"
}
Errors
| Code | Description |
|---|
| 400 | Missing rpcUrl, value is not a string, URL is invalid, or URL does not use HTTPS |
| 401 | Unauthorized — no valid session |
