Error
A valid request URL is required to generate request examples{
"version": "external-market-snapshot/v1",
"marketId": "<string>",
"status": "draft",
"market": {
"marketId": "<string>",
"underlyingSymbol": "<string>",
"marketType": "crypto",
"logoUrl": "<string>",
"logoUnavailable": true,
"status": "draft",
"priceScale": 1,
"quantityScale": 1,
"minPrice": "<string>",
"maxPrice": "<string>",
"minQuantity": "<string>",
"maxQuantity": "<string>",
"initialMarginBps": 123,
"maintenanceMarginTiers": [
{
"notionalThresholdAtoms": "<string>",
"maintenanceMarginBps": -4503599627365496
}
],
"maxLeverageX": 123,
"makerFeeBps": 1,
"takerFeeBps": 1,
"settlementAsset": "<string>",
"lastPriceAtoms": "<string>",
"lastPrice": "<string>",
"change24hBps": "<string>",
"favorite": true
},
"marketSession": {
"state": "open",
"asOfEpochMs": 1,
"nextOpenEpochMs": 1,
"nextCloseEpochMs": 1,
"riskIncreasingOrderCutoffEpochMs": 1
},
"snapshotSequence": 1,
"readModelDigest": "<string>",
"resync": {
"stream": "market.status",
"fromSequence": 123
}
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}Markets
Get a market snapshot
Returns the current market snapshot (mark/index, status, funding) for a market.
Method and path: GET /v1/markets/
Authentication: none.
Request schema: none.
Response schema: ExternalMarketSnapshotResponse.
Error envelope: ExternalRestError (external-rest-error/v1).
GET
/
v1
/
markets
/
{marketId}
Error
A valid request URL is required to generate request examples{
"version": "external-market-snapshot/v1",
"marketId": "<string>",
"status": "draft",
"market": {
"marketId": "<string>",
"underlyingSymbol": "<string>",
"marketType": "crypto",
"logoUrl": "<string>",
"logoUnavailable": true,
"status": "draft",
"priceScale": 1,
"quantityScale": 1,
"minPrice": "<string>",
"maxPrice": "<string>",
"minQuantity": "<string>",
"maxQuantity": "<string>",
"initialMarginBps": 123,
"maintenanceMarginTiers": [
{
"notionalThresholdAtoms": "<string>",
"maintenanceMarginBps": -4503599627365496
}
],
"maxLeverageX": 123,
"makerFeeBps": 1,
"takerFeeBps": 1,
"settlementAsset": "<string>",
"lastPriceAtoms": "<string>",
"lastPrice": "<string>",
"change24hBps": "<string>",
"favorite": true
},
"marketSession": {
"state": "open",
"asOfEpochMs": 1,
"nextOpenEpochMs": 1,
"nextCloseEpochMs": 1,
"riskIncreasingOrderCutoffEpochMs": 1
},
"snapshotSequence": 1,
"readModelDigest": "<string>",
"resync": {
"stream": "market.status",
"fromSequence": 123
}
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}{
"version": "external-rest-error/v1",
"requestId": "<string>",
"code": "invalid_request",
"safeMessage": "<string>",
"retryable": true,
"recoveryActions": [
"none"
],
"occurredAtEpochMs": 1,
"realtimeTicketFailure": "invalid"
}Path Parameters
Minimum string length:
1Response
Success
Allowed value:
"external-market-snapshot/v1"Minimum string length:
1Available options:
draft, backfilling, open, paused, halted, cancel_only, reduce_only Show child attributes
Show child attributes
Show child attributes
Show child attributes
Required range:
x >= 0Identifies the market-registry PROJECTION CHECKPOINT this market was read from -- a hash of {panel, journalSequence, version}, covering the whole registry rather than the single market returned here. It does NOT cover the payload and cannot be recomputed from it.
Pattern:
^sha256:[0-9a-f]{64}$Show child attributes
Show child attributes