Developers

Build with
Meridian.

Canonical API access, selected MCP tools, bounded previews, and x402 full-data access.

API Canonical v1
MCP Selected tools
x402 Pay-per-call
# Bounded preview
	curl "https://meridianfin.io/api/v1/congress?sample=true"

# Full data: plain curl returns HTTP 402, no payment
# Paying needs a configured x402 client and budget
	curl -i "https://meridianfin.io/api/v1/congress/1m"
Example response shape
{
  "trades": [
    {
      "representative": "Nancy Pelosi",
      "ticker": "NVDA",
      "trade_type": "purchase",
      "amount_range": "$250K - $500K",
      "filing_date": "2026-01-15",
      "transaction_date": "2026-01-08"
    }
  ],
  "_sample": true,
  "_note": "This is a free sample (max 2 records per list). Full data requires x402 payment.",
  "_upgrade": {
    "message": "Sample preview only. Pay via x402 for full data.",
    "x402_endpoint": "https://meridianfin.io/api/v1/congress",
    "pricing_info": "https://meridianfin.io/agents.json"
  }
}

REST API

Selected API endpoints below use the canonical v1 contract. The OpenAPI document describes a selected public tool catalogue, not the full runtime, account, or internal APIs; schemas and examples are partial where applicable.

API data is licensed for personal or internal business use under the API Use terms. Bulk redistribution, resale, or mirroring of Meridian data as a dataset or feed is not permitted.

Method Endpoint Description
GET /api/v1/congress Congressional trades
GET /api/v1/darkpool FINRA daily aggregate off-exchange short-sale volume
GET /api/v1/insiders SEC Form 4 filings
GET /api/v1/13f Institutional 13F filings
GET /api/v1/crypto/etf-flows Crypto ETF flows
GET /api/v1/macro Macro dashboard

Discovery & Spec

/agents.json JSON

AI agent discovery manifest. Tells AI crawlers what tools and capabilities are available.
/api/openapi.json OpenAPI 3.1

Selected public tool catalogue in OpenAPI 3.1 format. Excludes the full runtime, account, and internal APIs; schemas and examples are partial where applicable.
/llms.txt Markdown

Plain-language API description for LLMs. Part of the emerging llms.txt standard.

Ready to build?

Start with the OpenAPI spec or point your MCP client at our server.

OpenAPI Spec agents.json Launch App