MarketDataService
Get Spot Config
Retrieve a cacheable snapshot of spot assets and pairs, including precision and trading constraints.
Request
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/spot/config' \ --header 'Accept: */*'
Responses
{
"assets": [
{
"asset": "BTC",
"ledgerId": 1,
"marketDataVolumeScale": 123456,
"name": "Bitcoin",
"quantityDisplayDecimals": 8,
"quantityScale": 8
}
],
"pairs": [
{
"allowBuyFeeFromBase": false,
"baseAsset": "BTC",
"baseQuantityScale": 8,
"defaultMarketSlippageBpsBuy": 1,
"defaultMarketSlippageBpsSell": 1,
"delistingAt": "2025-01-01T00:00:00Z",
"listingAt": "2025-01-01T00:00:00Z",
"marketdata": {
"orderbookPriceBuckets": [
0.1
]
},
"maxClientRefDriftBps": 1,
"minNotionalQuote": "10",
"minQtyBase": "0.0001",
"quoteAsset": "USDT",
"quoteQuantityScale": 6,
"referencePriceScale": 5000000,
"status": "ENABLED",
"stepSize": "0.0001",
"symbol": "BTC-USDT",
"symbolId": 1,
"tickSize": "0.01"
}
],
"tsSec": "1735689600"
}Asset code, e.g. "USDT" or "BTC".
BTCStable numeric asset id used by account, balance, and order APIs.
1Integer scale for public candle and market-overview base volume (0..18).
123456Human-friendly display name, e.g. "Bitcoin".
BitcoinSuggested decimal precision for displaying user-facing asset amounts.
8Integer scale for quantities and balances in this asset (0..18). A scale of 8 means one whole asset is represented as 100000000 in scaled integer fields such as qty_scaled.
8Whether BUY order fees may be paid from the base asset instead of the spent quote asset when the order request selects the base fee asset.
falseBase asset code. For BTC-USDT, this is "BTC".
BTCQuantity scale for base-asset amounts in this pair.
8Default MARKET order slippage cap for BUY orders, in basis points (1 bp = 0.01%). A request-level slippage setting can override this value.
1Default MARKET order slippage cap for SELL orders, in basis points (1 bp = 0.01%). A request-level slippage setting can override this value.
1Scheduled delisting timestamp. When unset, the pair has no explicit delisting time.
2025-01-01T00:00:00ZScheduled listing timestamp. When unset, the pair has no explicit future listing time.
2025-01-01T00:00:00ZSuggested order book aggregation bucket sizes in quote-asset price units, e.g. 0.01, 0.1, 1, or 10.
[0.1]Maximum allowed drift between client reference price and server reference price for MARKET orders, in basis points (1 bp = 0.01%), when client reference pricing is used.
1Minimum order notional as a decimal string in quote-asset units.
10Minimum order quantity as a decimal string in base-asset units.
0.0001Quote asset code. For BTC-USDT, this is "USDT".
USDTQuantity scale for quote-asset amounts in this pair.
6Integer scale for composite reference prices in candle responses (0..18). Primary market and execution prices use the fixed scale 9.
5000000Current trading status.
ENABLEDMinimum allowed quantity increment as a decimal string in base-asset units.
0.0001Trading pair symbol, e.g. "BTC-USDT".
BTC-USDTStable numeric pair id used by low-latency ConnectRPC requests and streams.
1Minimum allowed price increment as a decimal string in quote-asset units. Prices use 9 decimal places in scaled integer fields; for example "0.01" means orders must be priced in 0.01 quote-asset increments.
0.01Snapshot generation timestamp, in seconds since the Unix 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. |