checkpoints.v1.CheckpointService
ListMyCheckpoints
List every checkpoint of the authenticated caller's root account, newest first. Checkpoints are private to the account owner.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/checkpoints.v1.CheckpointService/ListMyCheckpoints' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"subaccountId": "6789012345678"
}'Responses
{
"checkpoints": [
{
"amends": "1",
"badges": [
{
"badge": "FIRST_TRADE",
"earnedAt": "2025-01-01T00:00:00Z"
}
],
"biggestTrade": {
"at": "2025-01-01T00:00:00Z",
"side": "BUY",
"symbol": "BTC-USDT",
"symbolId": 1
},
"biggestTradeUsd": "value",
"busiestDay": "value",
"cancelRatio": "value",
"canceledOrders": "1",
"dailyClaimAmounts": [
{
"amount": "123.45",
"asset": "value",
"excludedFromValue": false,
"usd": "value"
}
],
"dailyClaims": "1",
"dailyVolume": [
{
"approximate": false,
"day": "2025-01-01T00:00:00Z",
"trades": "1",
"usd": "value"
}
],
"daysActive": 1,
"deposits": {
"amounts": [
{
"amount": "123.45",
"asset": "value",
"excludedFromValue": false,
"usd": "value"
}
],
"chains": [
{
"chainName": "value",
"polyesterChainId": 1,
"total": {
"count": "1",
"usd": "value"
}
}
],
"count": "1"
},
"fillRate": "value",
"filledOrders": "1",
"finalValueUsd": "value",
"firstTradeAt": "2025-01-01T00:00:00Z",
"fundingBalances": [
{
"amount": "123.45",
"asset": "value",
"excludedFromValue": false,
"usd": "value"
}
],
"fundingByDay": [
{
"date": "value",
"depositUsd": "value",
"withdrawalUsd": "value"
}
],
"incomplete": [
"VOLUME"
],
"inflowUsd": "value",
"internalTransfers": "1",
"longestStreak": 1,
"makerTrades": "1",
"marketsTraded": 1,
"medianLimitRestMs": "1",
"mostActiveHourUtc": 23,
"netInflowUsd": "value",
"number": 1,
"openingValueUsd": "value",
"orderTypes": {
"limit": "100",
"market": "1"
},
"orders": "1",
"outflowUsd": "value",
"partiallyFilledOrders": "1",
"peakVipTier": 10,
"portfolioValue": [
{
"approximate": false,
"hour": "2025-01-01T00:00:00Z",
"usd": "value"
}
],
"postOnly": "1",
"rejectedOrders": "1",
"seasonEnd": "2025-01-01T00:00:00Z",
"seasonResultUsd": "value",
"seasonStart": "2025-01-01T00:00:00Z",
"selfTrades": "1",
"subaccounts": "1",
"takenAt": "2025-01-01T00:00:00Z",
"takerTrades": "1",
"timeInForce": {
"fok": "1",
"gtc": "1",
"gtd": "1",
"ioc": "1"
},
"tools": {
"ladder": "1",
"stopLoss": "1",
"takeProfit": "1",
"trailingStop": "1",
"twap": "1"
},
"topPairs": [
{
"symbol": "BTC-USDT",
"symbolId": 1,
"trades": "1",
"volumeUsd": "12.3456"
}
],
"trades": "1",
"tradesByWeekdayHour": [
{
"hours": [
"1"
]
}
],
"tradingBalances": [
{
"amount": "123.45",
"asset": "value",
"excludedFromValue": false,
"usd": "value"
}
],
"transfersIn": {
"count": "1",
"usd": "value"
},
"transfersOut": {
"count": "1",
"usd": "value"
},
"vipTierAtCheckpoint": 10,
"vipTimeline": [
{
"date": "value",
"tier": 10
}
],
"volumeUsd": "12.3456",
"withdrawals": {
"amounts": [
{
"amount": "123.45",
"asset": "value",
"excludedFromValue": false,
"usd": "value"
}
],
"chains": [
{
"chainName": "value",
"polyesterChainId": 1,
"total": {
"count": "1",
"usd": "value"
}
}
],
"count": "1"
}
}
]
}checkpoints.v1.ListMyCheckpointsRequestcheckpoints.v1.ListMyCheckpointsResponseOptional subaccount public identifier. Checkpoints cover a root account and all of its subaccounts, so a subaccount resolves to its root account, which must be the caller's own.
Positive checkpoint number. Checkpoint 1 is the first season; numbers increase by season.
UTC start of the season, inclusive.
UTC end of the season, exclusive.
UTC time at which the checkpoint was recorded.
Season trading volume in USD, encoded as a non-negative base-10 decimal string without separators or a currency symbol.
Number of trade fills.
Number of orders placed.
Number of UTC days with at least one trade.
Longest run of consecutive UTC days with at least one trade.
Stable numeric spot market identifier.
Display symbol of the market, for example BTC-USDT. Empty when the market is no longer listed.
Season trading volume on this market in USD, encoded as a non-negative base-10 decimal string without separators or a currency symbol.
Number of trade fills on this market.
Number of different markets traded.
Trade fills on the maker side.
Trade fills on the taker side.
Trade fills where both sides belonged to this account.
Exactly 24 counts, one per UTC hour of the day from 0 through 23.
UTC midnight that starts the day.
Settled trading volume of the day in USD, encoded as a non-negative base-10 decimal string without separators or a currency symbol.
True when the day's volume is a lower bound because some of its trades could not be valued.
Number of trade fills on the day, including fills against the account's own orders, which add no volume.
Largest single trade fill in USD, encoded as a non-negative base-10 decimal string without separators or a currency symbol.
Stable numeric spot market identifier.
Display symbol of the market, for example BTC-USDT. Empty when the market is no longer listed.
The account's side of the fill.
UTC time of the fill.
Limit orders.
Market orders.
Good-till-canceled orders.
Immediate-or-cancel orders.
Fill-or-kill orders.
Good-till-date orders.
Stop-loss uses.
Take-profit uses.
Trailing-stop uses.
TWAP uses.
Ladder uses.
Post-only orders placed.
Orders amended at least once.
Orders that ended fully filled.
Orders that ended canceled or rejected after a partial fill.
Orders that ended canceled.
Orders that ended rejected.
Share of placed orders that ended fully filled, a base-10 decimal string from 0 to 1.
Share of placed orders that ended canceled, a base-10 decimal string from 0 to 1.
Typical time a good-till-canceled or good-till-date limit order rested before it filled or was canceled, in milliseconds. Omitted when no such order ended in the season.
UTC time of the first trade fill in the season. Omitted without trades.
UTC date with the most trade fills, formatted as YYYY-MM-DD. Omitted without trades.
UTC hour of day, 0 through 23, with the most trade fills. Omitted without trades.
VIP tier at the moment the checkpoint was recorded, 0 through 10.
Highest VIP tier reached during the season, 0 through 10.
UTC date from which the tier applies, formatted as YYYY-MM-DD.
VIP tier in the inclusive range 0 through 10.
The badge.
UTC time the badge's threshold was first crossed, within the season.
UTC start of the hour.
Portfolio value in USD, encoded as a base-10 decimal string without separators or a currency symbol.
True when this value is approximate because some holdings could not be valued at that hour.
Asset symbol, for example USDT.
Amount in whole asset units, encoded as a base-10 decimal string without separators.
USD value, encoded as a base-10 decimal string without separators or a currency symbol. Omitted when the asset had no USD price at the required time, and always when excluded_from_value is true.
True when the asset does not count toward account value, for example a test token that cannot be traded. It is listed by amount only, has no USD value and is left out of every USD total, which it never makes approximate or omitted.
Asset symbol, for example USDT.
Amount in whole asset units, encoded as a base-10 decimal string without separators.
USD value, encoded as a base-10 decimal string without separators or a currency symbol. Omitted when the asset had no USD price at the required time, and always when excluded_from_value is true.
True when the asset does not count toward account value, for example a test token that cannot be traded. It is listed by amount only, has no USD value and is left out of every USD total, which it never makes approximate or omitted.
Number of successful operations.
Polyester Chain id.
Display name of the chain, for example Ethereum Sepolia. Empty when the chain is not in the current chain catalog.
Number of operations, including operations in assets excluded from value.
USD total over assets that count toward account value, encoded as a non-negative base-10 decimal string without separators or a currency symbol. Assets excluded from value add nothing. Omitted when any other operation had no USD value.
Asset symbol, for example USDT.
Amount in whole asset units, encoded as a base-10 decimal string without separators.
USD value, encoded as a base-10 decimal string without separators or a currency symbol. Omitted when the asset had no USD price at the required time, and always when excluded_from_value is true.
True when the asset does not count toward account value, for example a test token that cannot be traded. It is listed by amount only, has no USD value and is left out of every USD total, which it never makes approximate or omitted.
Number of successful operations.
Polyester Chain id.
Display name of the chain, for example Ethereum Sepolia. Empty when the chain is not in the current chain catalog.
Number of operations, including operations in assets excluded from value.
USD total over assets that count toward account value, encoded as a non-negative base-10 decimal string without separators or a currency symbol. Assets excluded from value add nothing. Omitted when any other operation had no USD value.
Asset symbol, for example USDT.
Amount in whole asset units, encoded as a base-10 decimal string without separators.
USD value, encoded as a base-10 decimal string without separators or a currency symbol. Omitted when the asset had no USD price at the required time, and always when excluded_from_value is true.
True when the asset does not count toward account value, for example a test token that cannot be traded. It is listed by amount only, has no USD value and is left out of every USD total, which it never makes approximate or omitted.
UTC date, formatted as YYYY-MM-DD.
USD value of the day's deposits, encoded as a non-negative base-10 decimal string without separators or a currency symbol; "0" without a deposit. Omitted when a deposit had no USD value.
USD value of the day's withdrawals, encoded as a non-negative base-10 decimal string without separators or a currency symbol; "0" without a withdrawal. Omitted when a withdrawal had no USD value.
Number of operations, including operations in assets excluded from value.
USD total over assets that count toward account value, encoded as a non-negative base-10 decimal string without separators or a currency symbol. Assets excluded from value add nothing. Omitted when any other operation had no USD value.
Number of operations, including operations in assets excluded from value.
USD total over assets that count toward account value, encoded as a non-negative base-10 decimal string without separators or a currency symbol. Assets excluded from value add nothing. Omitted when any other operation had no USD value.
Internal transfers made.
Daily claims collected.
Asset symbol, for example USDT.
Amount in whole asset units, encoded as a base-10 decimal string without separators.
USD value, encoded as a base-10 decimal string without separators or a currency symbol. Omitted when the asset had no USD price at the required time, and always when excluded_from_value is true.
True when the asset does not count toward account value, for example a test token that cannot be traded. It is listed by amount only, has no USD value and is left out of every USD total, which it never makes approximate or omitted.
USD value brought in during the season: daily claim payouts, deposits and transfers in, each valued when it happened, over assets that count toward account value; assets excluded from value add nothing. Encoded as a non-negative base-10 decimal string without separators or a currency symbol. Omitted when any other part had no USD value.
USD value taken out during the season: withdrawals and transfers out, each valued when it happened, over assets that count toward account value; assets excluded from value add nothing. Encoded as a non-negative base-10 decimal string without separators or a currency symbol. Omitted when any other part had no USD value.
inflow_usd minus outflow_usd, encoded as a base-10 decimal string that may be negative. Omitted when either is omitted.
USD value of all trading and funding balances at the end of the season that count toward account value, encoded as a base-10 decimal string. Assets excluded from value add nothing. Omitted when any other balance had no USD value.
USD value of the funding balances restored to the account when the season opened, valued at the end of the season like final_value_usd, over assets that count toward account value; assets excluded from value add nothing. Encoded as a non-negative base-10 decimal string without separators or a currency symbol; "0" when the season opened with no balances. Omitted when a restored balance had no USD value.
Season result: final_value_usd minus opening_value_usd minus net_inflow_usd, encoded as a base-10 decimal string that may be negative. Price moves on restored holdings are not counted as result. Omitted when any of them is omitted.
Subaccounts of the account.
Values computed from partial evidence, in ascending enum order. Empty when every value is exact.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |