API Documentation

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

Get API Access

Free API key with 500 requests/day. All indices, history, and regional data. Need enterprise limits? Contact support@axonindex.com

Get your key below →

Base URL

https://axonindex.com/api/v1

Auth

X-API-Key header

Rate Limit (Free)

500 req/day

Format

JSON

Authentication & Rate Limiting

All API access requires a free API key. Register below to get yours instantly. Include your key in every request via the X-API-Key header:

curl -H "X-API-Key: ax_live_your_key_here" \
  https://axonindex.com/api/v1/indices

Free keys include 500 requests per day (resets at midnight ET). Response headers include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

ENDPOINTS

GET/api/v1/indices

List all available indices with their latest values

EXAMPLE

curl -H "X-API-Key: YOUR_KEY" \
  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 -H "X-API-Key: YOUR_KEY" \
  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 -H "X-API-Key: YOUR_KEY" \
  "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 -H "X-API-Key: YOUR_KEY" \
  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"
    },
    ...
  ]
}

POST/api/v1/auth/register

EXAMPLE

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

RESPONSE

{
  "api_key": "ax_live_a1b2c3d4e5f6...",
  "email": "you@company.com",
  "daily_limit": 500,
  "message": "Your API key is ready. Store it securely..."
}

Error Responses

Status	Meaning	Example
`401`	Unauthorized	API key required / Invalid API key
`403`	Forbidden	API key deactivated
`404`	Not Found	Index 'GCI-XYZ' not found
`429`	Rate Limited	Daily rate limit of 500 requests exceeded

Get Your API Key

Free access to all indices, historical data, and regional breakdowns. 500 requests/day. Instant activation.