API Reference

https://econalk.com/api/v1

Pass your API key as a Bearer token in the Authorization header. The key is shown exactly once when you create it — store it securely.

Authorization: Bearer ek_live_<your-key>

Alternatively you may pass the key in the X-API-Key header.

Limits follow your ECONALK membership: the console and API keys use your ECONALK account directly — no separate developer registration. Every member gets the Member tier; ECONALK Premium members are upgraded automatically within an hour — or immediately on your next console visit.

The per-minute limit uses a fixed 60-second window. The monthly quota counts every logged request in the current UTC calendar month; usage beyond the included quota is metered and billable at the tier's overage price (tracked live in the developer console), and requests stop with 429 quota_exceeded once the hard cap is reached. Every response includes:

Success (list)

{
  "data": [ /* array of objects */ ],
  "pagination": {
    "total": 142,
    "limit": 20,
    "offset": 0
  }
}

Success (single)

{
  "data": { /* single object */ }
}

Error

{
  "error": {
    "code": "invalid_region",
    "message": "region must be us, kr, or jp"
  }
}

Returns a paginated list of published articles across regions.

Query parameters

Example request

curl "https://econalk.com/api/v1/articles?region=us&category=economy&limit=5" \
  -H "Authorization: Bearer ek_live_..."

Example response

{
  "data": [
    {
      "slug": "2026-06-01-fed-rate-decision",
      "title": "Fed holds rates steady amid inflation data",
      "description": "The Federal Reserve opted to keep ...",
      "category": "economy",
      "region": "us",
      "date": "2026-06-01",
      "author": "ECONALK Editorial",
      "image": "/images/fed-rate.jpg"
    }
  ],
  "pagination": { "total": 142, "limit": 5, "offset": 0 }
}

Returns a single article by slug, including the full rendered content.

Path parameter

Query parameters

Example request

curl "https://econalk.com/api/v1/articles/2026-06-01-fed-rate-decision?region=us" \
  -H "Authorization: Bearer ek_live_..."

Returns

{
  "data": {
    "slug": "2026-06-01-fed-rate-decision",
    "title": "Fed holds rates steady ...",
    "description": "...",
    "category": "economy",
    "region": "us",
    "date": "2026-06-01",
    "author": "ECONALK Editorial",
    "image": "/images/fed-rate.jpg",
    "content": "<!-- full MDX-rendered HTML string -->"
  }
}

Returns upcoming (and recent) economic events such as central bank decisions, CPI releases, and employment reports.

Query parameters

Example request

curl "https://econalk.com/api/v1/economic-calendar?region=us&importance=3&futureDays=30" \
  -H "Authorization: Bearer ek_live_..."

Example response

{
  "data": [
    {
      "eventName": "Fed Interest Rate Decision",
      "scheduledAt": "2026-07-30T18:00:00.000Z",
      "country": "United States",
      "category": "Central Bank",
      "importance": 3,
      "forecastValue": "4.25%",
      "previousValue": "4.25%",
      "actualValue": ""
    }
  ],
  "pagination": { "total": 12, "limit": 20, "offset": 0 }
}

All list endpoints support limit (default 20, max 100) and offset (default 0). Use the pagination.total field in the response to calculate the number of pages: Math.ceil(total / limit).

// Page 3 (zero-indexed), 10 per page
GET /api/v1/articles?limit=10&offset=20