API Documentation

REST API reference for EconPulse economic data endpoints

## Authentication

All requests require an API key sent as a Bearer token in the Authorization header.

GET https://api.econpulse.io/v1/cpi

Headers:
  Authorization: Bearer YOUR_API_KEY

## Base URL

https://api.econpulse.io/v1

## Endpoints

GET/cpi

Returns latest CPI and Core CPI readings with MoM and YoY change.

Example response

{
  "cpi": 3.4,
  "core_cpi": 3.6,
  "mom": 0.3,
  "yoy": 3.4,
  "release_date": "2026-05-15",
  "source": "BLS"
}

GET/ppi

Returns Producer Price Index, final demand.

Example response

{
  "ppi": 2.7,
  "mom": 0.2,
  "yoy": 2.7,
  "release_date": "2026-05-14",
  "source": "BLS"
}

GET/energy

Returns WTI crude oil and national average gas prices updated hourly.

Example response

{
  "wti": 79.42,
  "gas_avg": 3.38,
  "updated_at": "2026-05-27T14:00:00Z",
  "source": "EIA"
}

GET/treasury

Returns 2-year and 10-year treasury rates updated every 15 minutes.

Example response

{
  "rate_2yr": 4.82,
  "rate_10yr": 4.56,
  "updated_at": "2026-05-27T14:45:00Z",
  "source": "Treasury"
}

GET/btc-premium

Returns live BTC cross-exchange spread detection.

Example response

{
  "premium_pct": 0.12,
  "high_exchange": "Coinbase",
  "low_exchange": "Kraken",
  "updated_at": "2026-05-27T14:58:00Z"
}

GET/calendar

Returns upcoming economic release calendar with consensus estimates.

Example response

{
  "events": [
    {
      "name": "CPI",
      "release_date": "2026-06-10",
      "consensus": 3.3,
      "prior": 3.4
    }
  ]
}

GET/indeed

Indeed Hiring Lab job postings index (seasonally adjusted + non-adjusted) and monthly wage growth. Official API partnership, updated daily.

Example response

{
  "job_postings": {
    "sa_index": 102.4,
    "nsa_index": 104.1,
    "as_of": "2026-05-27"
  },
  "wage_growth": {
    "yoy_pct": 3.8,
    "month": "2026-04"
  },
  "source": "Indeed Hiring Lab"
}

## SDKs

Official SDKs for Python and TypeScript. Included with all plans.

Python

pip install econpulse

import econpulse

client = econpulse.Client("YOUR_API_KEY")
data = client.cpi()

TypeScript

npm install econpulse

import EconPulse from 'econpulse'

const client = new EconPulse('YOUR_API_KEY')
const data = await client.cpi()

## Rate Limits

Plan	Monthly API Calls
Starter	1,000 / month
Pro	10,000 / month
Enterprise	Unlimited (dedicated endpoints + SLA)

Get your API key

7-day free trial. No credit card required.

Start Free Trial