API & MCP

Everything on Finance Desk as data: explained moves, sourced stories, catalysts, fundamentals, pooled 24/7 prices and odds. Built for apps and for AI agents.

API reference ↗OpenAPI

Why it's different

  • Moves come with their causes: every unusual price move links to the stories that explain it.
  • Every story is structured (kind, importance, entities) and sourced, with a summary and key points in plain English.
  • Prices pooled from every venue we can reach, around the clock, with open interest and funding.
  • One call, full context: /v1/brief returns everything an LLM needs about a company or ticker.
  • The MCP server is the same toolset our own assistant uses. If the Desk can answer it, your agent can too.

Quick start

curl -H "Authorization: Bearer fd_live_…" \
  "https://api.wiremeridian.com/v1/brief/instrument/NVDA"

Keys are created per account. Locally: pnpm --filter @fd/api key:create my-app.

Connect your agent (MCP)

Streamable HTTP endpoint at https://api.wiremeridian.com/mcp, 24 read-only tools, results built for citing: every story carries its id and source URL.

# Claude Code
claude mcp add --transport http finance-desk https://api.wiremeridian.com/mcp \
  --header "Authorization: Bearer fd_live_…"

# Cursor / any MCP client (mcp.json)
{ "finance-desk": { "url": "https://api.wiremeridian.com/mcp",
  "headers": { "Authorization": "Bearer fd_live_…" } } }
get_briefget_market_snapshotget_coveragesearchget_instrumentget_price_historyget_derivativesget_movesexplain_moveget_newsget_storyget_companyget_projectget_personget_sectorget_fundamentalsget_financialsget_filingsget_insider_tradesget_calendarget_macro_seriesget_macro_dashboardget_prediction_marketsget_glossary_term

Endpoints

GET /v1/brief/{type}/{key}LLM-ready context for any instrument, company, person, project, macro series, sector, market or story
GET /v1/market/snapshotPrices, latest movers with causes, top stories, next 7 days, headline macro
GET /v1/instruments/{symbol}Pooled 24/7 price, open interest, funding, volume and every venue
GET /v1/instruments/{symbol}/candlesPooled OHLC: 1m, 1h, 1d
GET /v1/moves · /v1/moves/explainUnusual moves with their causes and the stories around them
GET /v1/events · /v1/events/{id}Every story: structured, summarised, sourced, linked to entities
GET /v1/catalystsThe calendar: earnings, Fed, data releases, launches, court dates
GET /v1/companies/{c} · /fundamentals · /financialsProducts & projects with KPIs, valuation ratios, XBRL statements
GET /v1/filings · /v1/insider-tradesSEC filings and Form 4 trades with buy/sell summaries
GET /v1/macro · /v1/macro/{slug}US macro series with next releases
GET /v1/odds · /v1/odds/{slug}Prediction-market odds with history
GET /v1/searchResolve any name to typed keys
GET /v1/streamRealtime prices and stories (Server-Sent Events)