Sign in Subscribe
FINANCIAL INTELLIGENCE
FinNotes

API Platform · Live

Programmatic access to FinNotes.

The FinNotes commercial API serves the same global financial news, macroeconomic data series, and long-form reports the editorial site publishes — as a structured, point-billed REST surface designed for applications, internal tools, research pipelines, and AI agent runtimes.

What you get

One API, four content classes.

  • News. Market-news, chart-news, and column-article endpoints — list, detail, and a bundled /v1/news/today/full that returns every today's article with body, references, and chart spec in one call.
  • Reports. Long-form research columns retrievable at /v1/reports/{id_or_slug} with full HTML body, sections, and citations.
  • Data series. Catalogue, series detail, and per-series points endpoints across rates, FX, indices, commodities, and macro indicators.
  • Notes (workspace). Programmatic import + download of your own FinNotes workspace notes, so AI agents can hand off context between sessions.

How it's priced

Point-based monthly allowance.

Every endpoint has a fixed point cost (a list call is 1 pt, a chart-news detail is 1.25 pts, a long-form report is 5.50 pts, etc.). Each request returns both the points charged and the remaining balance — as JSON envelope fields and as response headers — so cost-aware agents can budget in flight.

  • Pro — 1,350 points / month, 3 requests / second.
  • Max — 5,000 points / month, 10 requests / second.

Full per-endpoint point table: platform.finnotes.com/pricing.

Beta · Free Pro

Pro is free for 6 months during Beta.

Every new account that signs up before 2027-01-01 receives a complimentary 6-month Pro subscription, which includes the API quota this platform consumes. No payment required during the Beta window. Existing unexpired Pro subscriptions remain valid through their original 6-month term when the Beta program closes — only sign-ups after the cutoff date are subject to the post-Beta pricing then in effect. Full terms in our Terms of Use §7.

For AI agents

Drop-in Agent Skill (MIT, open source).

The FinNotes Agent Skill mounts into Claude Code, Codex, OpenClaw, and any other agent runtime that auto-loads project skills. It ships scripts that store the fnp_ API key locally in ~/.finnotes/credentials.env (mode 0600, off-limits to the model context), make cost-aware API calls, and wrap every common news intent into a single command. Two machine-readable docs at platform.finnotes.com/docs/for-ai/ tell the agent how to integrate without you ever pasting the key into chat.

Start building

Three places to go next.

Mint an API key → platform.finnotes.com/api-keys · sign in with Google, name your key, download the Agent JSON handoff. Quick Start guide → First-request walkthrough with cURL and Python; works for humans + AI agents. Read the API contract → Every endpoint, parameter, point cost, error envelope. Machine-readable, served as text/plain.

Information and research only.

FinNotes content is not investment, financial, tax, or legal advice. Users should conduct their own research and consult qualified professionals before making financial decisions. See our terms of use and privacy policy for the full disclaimers and data handling.