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"

# Paid (x402, USDC on Base L2) — agents handle this automatically
	curl "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. See the OpenAPI specification for the complete machine-readable surface.

Method Endpoint Description
GET /api/v1/congress Congressional trades
GET /api/v1/darkpool Dark pool transactions
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

Full OpenAPI 3.1 specification. Import into Postman, Insomnia, or any API client.
/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