Skip to main content

1. Get an API key

Request a key. Discovery endpoints (/health, /openapi.json, /llms.txt) need no key at all — you can explore before signing up.

2. Make your first request

Latest macro readings for a country:
curl "https://api.financialdatapi.com/v1/public/observations/latest?country=USA" \
  -H "x-api-key: $CONDUIT_API_KEY"

3. Read one indicator’s history

curl "https://api.financialdatapi.com/v1/public/observations?indicator_id=cpi_inflation_yoy&country=GBR&limit=24" \
  -H "x-api-key: $CONDUIT_API_KEY"

Response envelope

Every response uses the same shape:
{
  "data": [ /* ... observations ... */ ],
  "meta": {
    "request_id": "req_...",
    "api_version": "v1",
    "pagination": { "next_cursor": "pub_...", "has_more": true }
  },
  "requestId": "req_..."
}
Follow meta.pagination.next_cursor (passing it back as ?cursor=) while has_more is true. limit is 1–500 (default 100). Unknown query params are rejected with bad_request.

Next steps

Authentication

Keys, scopes, public endpoints.

Macro screener

Filter countries by macro conditions.

AI agents

Call Conduit from an LLM via MCP.

API Reference

Browse every endpoint + playground.