API Reference
Balance
Wallet balance operations
GET
/api/balanceGet Wallet Balance
Check your wallet's USDC balance on a specific network.
Auth:ApiTokenOAuth2
query parameters
| Name | Type | Description |
|---|---|---|
| network | "base" | "base-sepolia" | "solana" | "solana-devnet" default: "base-sepolia" | Blockchain network |
Responses
200Balance retrieved successfully
| Field | Type | Description |
|---|---|---|
| usdcBalance | string | On-chain USDC balance example: "50.000000" |
| creditBalance | string | Credit balance (in-app credits) example: "5.000000" |
| totalBalance | string | Combined balance (USDC + credit) example: "55.000000" |
| address | string | Wallet address |
| hasWallet | boolean | |
| network | string | |
| chainType | "ethereum" | "solana" |
401Unauthorized - invalid or missing authentication
| Field | Type | Description |
|---|---|---|
| error | string | |
| error_description | string | |
| message | string |
Example (cURL)
curl -X GET 'https://api.agnic.ai/api/balance' \
-H 'X-Agnic-Token: YOUR_TOKEN'