Source: https://docs.sogni.ai/api-reference/wallet/

# On-chain Wallet

Public reads of on-chain balances, RPC endpoints, and token contract addresses for any EVM wallet address. These show on-chain holdings, not generation-account credit. For spendable balances, Premium Spark, usage, and worker earnings, use the [authenticated account reference](https://docs.sogni.ai/api-reference/account-and-usage/).

### GET /v2/wallet/balance

Returns SOGNI, Spark, and native (ether) balances for a wallet on the chosen provider, as decimal strings in whole-token units. An RPC failure returns `500`; retry with backoff.

### [#](https://docs.sogni.ai/api-reference/wallet/#query-parameters)Query parameters

| Name | Type | In | Description |
| --- | --- | --- | --- |
| walletAddressrequired | string | query | EVM address, all-lowercase or with a valid EIP-55 checksum. Other values return `400`. |
| provider | string | query | Network provider. Lowercase `base` (default) or `etherlink`; any other value is treated as `base`. |

### [#](https://docs.sogni.ai/api-reference/wallet/#response)Response

```json
{
  "status": "success",
  "data": {
    "sogni": "1234.56",
    "spark": "78.90",
    "ether": "0.0123"
  }
}
```

### GET /v1/wallet/rpc-endpoints

Returns the canonical RPC endpoint list for a network provider. Useful for adding Sogni's network to an EVM wallet.

### [#](https://docs.sogni.ai/api-reference/wallet/#query-parameters-1)Query parameters

| Name | Type | In | Description |
| --- | --- | --- | --- |
| provider | string | query | Lowercase `base` (default) or `etherlink`; any other value is treated as `base`. |

### [#](https://docs.sogni.ai/api-reference/wallet/#response-1)Response

```json
{
  "status": "success",
  "data": {
    "RPCEndpoints": {
      "endpoint1": "https://mainnet.base.org",
      "endpoint2": "https://base-rpc.publicnode.com"
    }
  }
}
```

### GET /v1/contract/addresses

Returns `data.addresses` for the chosen network. Use `SogniToken` and `SparkToken` to add SOGNI and Spark to a wallet or read balances directly. Other entries are Sogni platform contracts and can change.

### [#](https://docs.sogni.ai/api-reference/wallet/#query-parameters-2)Query parameters

| Name | Type | In | Description |
| --- | --- | --- | --- |
| provider | string | query | `etherlink` for Etherlink; any other value, or none, returns Base. |