API Documentation

Programmatic access to all Axon index values, historical data, regional breakdowns, and source status. RESTful JSON API with consistent response schemas.

Base URL

https://axonindex.com/api/v1

Rate Limit (Free)

100 req/day

Format

JSON

Rate Limiting

Unauthenticated requests are limited to 100 requests per day per IP address. Response headers include X-RateLimit-Limit and X-RateLimit-Remaining. When the limit is exceeded, a 429 response is returned with a Retry-After header.

Institutional API keys (coming soon) provide higher rate limits, WebSocket streaming, and SLA guarantees.

ENDPOINTS

GET/api/v1/indices

List all available indices with their latest values

EXAMPLE

curl https://axonindex.com/api/v1/indices

RESPONSE

{
  "indices": [
    {
      "index_id": "GCI-H100",
      "latest_value": 2.1430,
      "latest_date": "2026-02-10",
      "change_pct": -0.0303,
      "status": "published"
    },
    ...
  ]
}

GET/api/v1/indices/{id}/latest

Get the most recent fixing value for a specific index, including optional regional breakdown

EXAMPLE

curl https://axonindex.com/api/v1/indices/GCI-H100/latest

RESPONSE

{
  "index_id": "GCI-H100",
  "fixing_date": "2026-02-10",
  "fixing_time": "2026-02-10T16:00:00-05:00",
  "value": 2.1430,
  "change_abs": -0.0670,
  "change_pct": -0.0303,
  "num_sources": 8,
  "num_observations": 1247,
  "status": "published",
  "methodology_version": "1.0",
  "regions": [
    {
      "index_id": "GCI-H100-US-West",
      "region": "US-West",
      "value": 2.0800,
      ...
    }
  ]
}

GET/api/v1/indices/{id}/history?days=30

Get historical fixing values. Supports 1-365 days.

EXAMPLE

curl "https://axonindex.com/api/v1/indices/GCI-H100/history?days=30"

RESPONSE

{
  "index_id": "GCI-H100",
  "days": 30,
  "data": [
    {
      "fixing_date": "2026-01-12",
      "value": 2.3200,
      "change_abs": -0.0150,
      "change_pct": -0.0064,
      "num_sources": 7,
      "status": "published"
    },
    ...
  ]
}

GET/api/v1/indices/{id}/regions

Get all regional sub-indices for a given model index

EXAMPLE

curl https://axonindex.com/api/v1/indices/GCI-H100/regions

RESPONSE

{
  "index_id": "GCI-H100",
  "fixing_date": "2026-02-10",
  "regions": [
    {
      "index_id": "GCI-H100-US-West",
      "region": "US-West",
      "value": 2.0800,
      "num_sources": 5,
      "num_observations": 412,
      "status": "published"
    },
    ...
  ]
}

GET/api/v1/sources/status

Get operational status of all data sources

EXAMPLE

curl https://axonindex.com/api/v1/sources/status

RESPONSE

{
  "sources": [
    {
      "id": "vast_ai",
      "name": "Vast.ai",
      "source_type": "spot_marketplace",
      "tier": 1,
      "asset_types": ["compute"],
      "is_active": true,
      "last_success": "2026-02-10T15:00:00Z",
      "failure_count": 0,
      "reliability_score": 0.98
    },
    ...
  ],
  "total": 12,
  "active": 11
}

POST/api/v1/waitlist

Join the API access waitlist

EXAMPLE

curl -X POST https://axonindex.com/api/v1/waitlist \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com", "company": "Acme"}'

RESPONSE

{
  "id": 42,
  "email": "you@company.com",
  "created_at": "2026-02-10T16:30:00Z",
  "message": "Successfully added to waitlist"
}

Error Responses

Status	Meaning	Example
`404`	Not Found	Index 'GCI-XYZ' not found
`409`	Conflict	Email already on waitlist
`429`	Rate Limited	Rate limit exceeded. Maximum 100 requests per day.

Get Institutional API Access

Higher rate limits, WebSocket streaming, SLA guarantees, and dedicated support. We're onboarding institutional partners now.

No commitment. We'll email you when access is ready.