Skip to content
Docs
Get API Access
Browse the Documentation

API Reference

Status

Data availability and freshness.

Every endpoint here authenticates with X-API-Key, answers in the standard envelope and fails with the standard error body.

Get market-data availability and freshness

GEThttps://api.cantoncap.cc/v1/status/sources
getSourceStatus

Parameters

This endpoint takes no parameters.

Request

curl -s "https://api.cantoncap.cc/v1/status/sources" \
  -H "X-API-Key: $CANTONCAP_API_KEY"

Response

200 Public source status collection.

Example Response
{
  "status": {
    "timestamp": "2026-10-11T14:00:00.000Z",
    "elapsed_ms": 18,
    "error_code": 0,
    "error_message": null,
    "request_id": "req_7Hk2pQ9xLm"
  },
  "data": [
    {
      "venue_id": "temple",
      "available": true,
      "last_updated_at": "2026-10-11T14:00:00.000Z"
    }
  ]
}
  • dataarray of objects
    3 child fields
    • venue_idstring

      Stable CantonCap venue ID, such as temple or cantex.

    • availableboolean

      True while the feed is operational, including degraded or lagging states. False after authentication failures, a disabled feed or another operational failure.

    • last_updated_atstringnullable

      Time of the latest represented update. For calculated asset prices it is the stored calculation time. Decide acceptable age from it.

Headers

  • X-RateLimit-Limit Requests allowed in the current one-minute window.
  • X-RateLimit-Remaining Requests left in the window.
  • X-RateLimit-Reset Unix time, in seconds, when the window resets.

Errors

StatusCodeWhen
400invalid_requestRequest validation failedA parameter is malformed, out of bounds or not one of its allowed values.
401unauthenticatedA valid API key is requiredX-API-Key is missing or unknown.
403forbiddenThe API key does not resolve to an active planThe key expired, was suspended or has not started.
429rate_limitedThe request rate limit was exceededThe key's one-minute window is used up. Retry after Retry-After seconds.
Esc
navigateopenEscclose