Error
A valid request URL is required to generate request examples{
"version": "external-market-catalog/v1",
"markets": [
{
"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
}
],
"snapshotSequence": 1,
"readModelDigest": "<string>"
}{
"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
List markets
Returns tradable markets with order-ticket metadata: scales, bounds, initial margin, maximum leverage, fees, and settlement asset.
Method and path: GET /v1/markets
Authentication: none.
Request schema: none.
Response schema: ExternalMarketCatalogResponse.
Error envelope: ExternalRestError (external-rest-error/v1).
GET
/
v1
/
markets
Error
A valid request URL is required to generate request examples{
"version": "external-market-catalog/v1",
"markets": [
{
"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
}
],
"snapshotSequence": 1,
"readModelDigest": "<string>"
}{
"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"
}Response
Success
Allowed value:
"external-market-catalog/v1"Show child attributes
Show child attributes
Required range:
x >= 0Identifies the market-registry PROJECTION CHECKPOINT this catalogue was read from -- a hash of {panel, journalSequence, version}. It does NOT cover the market content below and cannot be recomputed from it: two responses with identical markets differ if the checkpoint moved.
Pattern:
^sha256:[0-9a-f]{64}$