Skip to main content
GET
/
balance-allowance
/
update
Refresh balance and allowance (L2)
curl --request GET \
  --url https://clob.kuest.com/balance-allowance/update \
  --header 'KUEST_ADDRESS: <kuest_address>' \
  --header 'KUEST_API_KEY: <kuest_api_key>' \
  --header 'KUEST_PASSPHRASE: <kuest_passphrase>' \
  --header 'KUEST_SIGNATURE: <kuest_signature>' \
  --header 'KUEST_TIMESTAMP: <kuest_timestamp>'
{
  "asset_type": "COLLATERAL",
  "signature_type": 123,
  "balance": "<string>",
  "allowance": "<string>",
  "token_id": "<string>"
}
Forces a fresh on-chain read of balance and allowance for the authenticated account.
This endpoint requires L2 authentication headers: KUEST_ADDRESS, KUEST_SIGNATURE, KUEST_TIMESTAMP, KUEST_API_KEY, and KUEST_PASSPHRASE.
Use the same query parameters as GET /balance-allowance.

Headers

​
KUEST_ADDRESS
string
required

Checksummed wallet address performing the request.

​
KUEST_API_KEY
string<uuid>
required

API key obtained from the L1 derivation endpoint.

​
KUEST_PASSPHRASE
string
required

64 character hexadecimal passphrase associated with the API key.

​
KUEST_TIMESTAMP
string
required

Millisecond epoch timestamp (string) used for freshness checks.

​
KUEST_SIGNATURE
string
required

Hex-encoded HMAC-SHA256 signature built from the L2 signing string.

Query Parameters

​
asset_type
enum<string>

Asset type to inspect.

Available options:
COLLATERAL,
CONDITIONAL
​
token_id
string

Token identifier when asset_type=CONDITIONAL.

​
signature_type
integer<int32>

Signature type used for conditional asset approvals.

Response

Balance and allowance payload.

​
asset_type
enum<string>
required

Asset type for the balance lookup.

Available options:
COLLATERAL,
CONDITIONAL
​
signature_type
integer<int32>
required

Signature type used for allowance checks.

​
balance
string
required

Balance in base units.

​
allowance
string
required

Allowance in base units.

​
token_id
string | null

Token identifier for conditional assets.