getBalance

curl --request POST \
  --url https://api.privy.io/v1/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "method": "getBalance",
  "network": "MAINNET"
}'

{
  "method": "getBalance",
  "data": {
    "balance": "239170",
    "token_balances": {
      "btknrt1x9helfvakyz8y53lzwt2wjen7d30ft6skpu69eydvndqt5uxsr4q0zvugn": {
        "balance": "999999910",
        "token_metadata": {
          "raw_token_identifier": "316f9fa59db10472523f1396a74b33f362f4af50b079a2e48d64da05d38680ea",
          "token_public_key": "025bd027cd332a40e21f16cb6e9c6aee9ac11e3dff9508081b64fa8b27658b18b6",
          "token_name": "Merica",
          "token_ticker": "USA",
          "decimals": 6,
          "max_supply": "21000000000000"
        }
      }
    },
    "encoding": "hex"
  }
}

POST

wallets

{wallet_id}

rpc

curl --request POST \
  --url https://api.privy.io/v1/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "method": "getBalance",
  "network": "MAINNET"
}'

{
  "method": "getBalance",
  "data": {
    "balance": "239170",
    "token_balances": {
      "btknrt1x9helfvakyz8y53lzwt2wjen7d30ft6skpu69eydvndqt5uxsr4q0zvugn": {
        "balance": "999999910",
        "token_metadata": {
          "raw_token_identifier": "316f9fa59db10472523f1396a74b33f362f4af50b079a2e48d64da05d38680ea",
          "token_public_key": "025bd027cd332a40e21f16cb6e9c6aee9ac11e3dff9508081b64fa8b27658b18b6",
          "token_name": "Merica",
          "token_ticker": "USA",
          "decimals": 6,
          "max_supply": "21000000000000"
        }
      }
    },
    "encoding": "hex"
  }
}

curl --request POST \
  --url https://api.privy.io/v1/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "method": "getBalance",
  "network": "MAINNET"
}'

{
  "method": "getBalance",
  "data": {
    "balance": "239170",
    "token_balances": {
      "btknrt1x9helfvakyz8y53lzwt2wjen7d30ft6skpu69eydvndqt5uxsr4q0zvugn": {
        "balance": "999999910",
        "token_metadata": {
          "raw_token_identifier": "316f9fa59db10472523f1396a74b33f362f4af50b079a2e48d64da05d38680ea",
          "token_public_key": "025bd027cd332a40e21f16cb6e9c6aee9ac11e3dff9508081b64fa8b27658b18b6",
          "token_name": "Merica",
          "token_ticker": "USA",
          "decimals": 6,
          "max_supply": "21000000000000"
        }
      }
    },
    "encoding": "hex"
  }
}

Headers

string

required

ID of your Privy app.

string

Request authorization signature. If multiple signatures are required, they should be comma separated.

string

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

Path Parameters

string

required

ID of the wallet to get.

These wallet methods are modeled after the Spark Wallet SDK. For more information about this wallet method, check out the Spark Wallet documentation.

Body

string

required

Available options: getBalance

string

required

Available options: MAINNET, REGTEST

Returns

enum<string>

required

Available options: getBalance

object

required

The balance and token holdings of the wallet.

Hide child attributes

string

required

Native Spark balance in satoshis.

object

required

A mapping of token Spark addresses to token data.

Hide child attributes

object

required

Hide child attributes

string

required

object

required

Hide child attributes

string

required

string

required

string

required

string

required

number

required

string

required

string

required

eth_signTransaction transfer

⌘I

API reference

Wallets

Wallet actions

Accounts

Policies

Condition sets

Aggregations

Transactions

Key quorums

Intents

Users

Labs

Headers

Path Parameters

Body

Returns

​Headers

​Path Parameters

​Body

​Returns

Headers

Path Parameters

Body

Returns