Skip to main content

List Spot Quote Providers

Returns one row per supported spot quote provider (cryptocompare, coinmarketcap): its stored configuration, or a not-configured stub for a provider that has never been saved. configured tells the two apart. The response is a plain array, not paginated.

A spot quote provider is the external price source the platform refreshes its spot prices from. Exactly one provider is active at a time. There is no built-in fallback: with none activated, the platform has no source to refresh spot prices from.

The API key never comes back. Only api_key_set and the key's last four characters (api_key_last4).

Platform owner only. The caller's node (the node of the access token) must be the platform root node; any other caller is refused with 403 / 10005.

Required permission: spot-quote-provider:view

Request​

GET /v2/admin/spot-quote-providers

Headers​

NameDescription
AuthorizationRequired. Bearer <access_token>

Example​

curl --request GET \
--url '{{baseUrl}}/v2/admin/spot-quote-providers' \
--header 'Authorization: Bearer <access_token>'

Response​

[
{
"provider": "cryptocompare",
"base_url": "",
"timeout": 0,
"cache_ttl_seconds": 0,
"is_active": false,
"effective_active": false,
"api_key_set": false,
"api_key_last4": "",
"configured": false
},
{
"provider": "coinmarketcap",
"base_url": "https://pro-api.coinmarketcap.com",
"timeout": 30,
"cache_ttl_seconds": 3600,
"is_active": true,
"effective_active": true,
"api_key_set": true,
"api_key_last4": "b41d",
"configured": true,
"created_at": "2026-08-14T07:30:02.511Z",
"updated_at": "2026-10-02T12:48:19.083Z"
}
]

Response Fields​

FieldTypeDescription
providerstringProvider key: cryptocompare or coinmarketcap
base_urlstringAPI base URL. Empty means the vendor's own endpoint
timeoutintegerRequest timeout in seconds
cache_ttl_secondsintegerHow long fetched quotes are cached, in seconds. 0 means the provider client's default
is_activebooleanWhether this provider is the active price source
effective_activebooleanWhether this provider is in effect. Always equal to is_active
api_key_setbooleanWhether an API key is stored
api_key_last4stringLast four characters of the stored key; empty when none is stored or the key is four characters or shorter
configuredbooleantrue for a saved provider, false for a not-configured stub
created_atstringCreation time (ISO 8601). Omitted on a stub
updated_atstringLast update time (ISO 8601). Omitted on a stub

Errors​

StatusCodeDescription
40310005The caller is not the platform owner (domain 2)

See Errors for the error format and common codes.