LedgerReadService
Get Equity History Series
Retrieve equity history as columnar series data. Supports optional subaccount, range, account-bucket filtering, and grouping by account or asset.
Request
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/equity/history/series?account_code=FUNDING&group_by=ACCOUNT&range=1d&subaccount_id=6789012345678' \ --header 'Accept: */*' \ --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \ --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \ --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE'
Responses
{
"btcPrices": [
"0.005"
],
"bucket": "1m",
"endTsSec": 1735689600,
"points": 1,
"quoteAsset": "USDT",
"range": "1d",
"series": [
{
"account": {
"accountCode": 1,
"name": "Trading"
},
"equity": [
"0.0001"
]
}
],
"startTsSec": 1735689600
}Optional account bucket filter (comma-separated codes or names: funding, trading).
Grouping mode (defaults to account).
History window (defaults to 1d).
Optional subaccount public id (base58).
BTC-USDT close price at each timestamp, scaled by 1e9 (same as price_ticks). Enables client-side conversion to BTC denomination without refetch.
["0.005"]Sampling interval between points, such as "5m" or "1h".
1mLast point timestamp in seconds since epoch (UTC).
1735689600Number of aligned points in each returned series.
1Human-readable quote asset symbol (always "USDT").
USDTResolved history window.
1daccount bucket code
1human-readable name ("funding", "trading")
Tradingpublic asset id (0 for "OTHER" bucket)
asset symbol ("BTC", "ETH", "OTHER")
Equity in quote currency (USDT) scaled by 1e4 (4 decimals). Values align 1:1 with timestamps.
["0.0001"]First point timestamp in seconds since epoch (UTC).
1735689600| Key | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |