Skip to main content
GET
List bonded earn allocation states

Authorizations

API-Key
string
header
required

Your public API key. Identifies the partner making the request.

API-Sign
string
header
required

HMAC signature over the request, computed with your private key.

API-Nonce
string
header
required

Monotonically increasing nonce included in the request signature.

Path Parameters

account_id
string
required

Globally unique public identifier for an account.

Required string length: 14 - 42

Query Parameters

quote_symbol
string
default:USD

Ticker symbol of the quote asset for converted amounts (e.g., "USD", "EUR").

Maximum string length: 10
quote_type
string
default:fiat

Type of the quote asset. Only "fiat" is supported.

Maximum string length: 16
strategy_id
string

Restrict results to one bonded earn strategy.

Required string length: 20
Pattern: ^ES[A-Z2-7]{5}-[A-Z2-7]{5}-[A-Z2-7]{6}$
state
enum<string>[]

Restrict results to one or more current allocation states. Omit to return all states.

Lifecycle state with a pending transition. This excludes earning, unlike BondedAllocationState.

Available options:
bonding,
exit_queue,
unbonding
page_token
string

Opaque token returned as next_page_token in the previous response. Omit to request the first page.

Required string length: 1 - 256
page_size
integer<int32>
default:20

Maximum number of results to return. Ignored when page_token is present.

Required range: 1 <= x <= 25

Response

Successful response

data
object[]
required

Allocation transitions for the requested page.

quote_symbol
string
required

Symbol of the quote asset used for converted amounts (e.g., "USD", "EUR").

quote_type
string
required

Type of the quote asset (e.g., "fiat").

next_page_token
string

Opaque token for retrieving the next page. Absent when there are no more results.

Required string length: 1 - 256