On-chain Wallet

Surface · On-chain

#Wallet & Balance

Read on-chain balances and RPC endpoints for the wallet associated with an account. For spendable generation-account balances, Premium Spark, usage, and worker earnings, use the authenticated account reference. These public wallet reads show on-chain holdings, not generation-account credit.

GET /v2/wallet/balance Public

Read SOGNI, Spark, and native (ether) balances for a wallet on the chosen provider.

#Query parameters

Name	Type	In	Description
walletAddress*	string	query	Checksummed EVM address.
provider	string	query	Network provider. Use lowercase `base` (default) or `etherlink`.

#Response

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

GET /v1/wallet/rpc-endpoints Public

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

#Query parameters

Name	Type	In	Description
provider	string	query	Lowercase `base` (default) or `etherlink`.

#Response

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