Fodda REST API Reference

Complete reference for all public Fodda REST API endpoints. Base URL: https://api.fodda.ai/v1.

For the machine-readable specification, see the OpenAPI 3.1 Public Specification.

Get your API key at app.fodda.ai/connections.

Authentication

  • API Key: X-API-Key: sk_live_... or Authorization: Bearer sk_live_...
  • Autonomous Agent Settlement: Send unauthenticated request → receive HTTP 402 challenge → settle USDC on Base L2 → redeem via Authorization: Bearer <tx_hash>

Public Endpoints

  • GET /v1/graphs/catalog — Full catalog of live domain, report, and expert graphs
  • GET /v1/catalog.okf — Open Knowledge Format bundle for AI agents
  • GET /v1/graph-slice — Sample JSON-LD data slice for trial evaluation
  • GET /v1/graphs/{graph_id}/readme — Public documentation for a knowledge graph
  • GET /v1/experts/search — Search 4,200+ specialist roster
  • POST /v1/graphs/{graph_id}/search — Hybrid semantic search within a graph
  • POST /v1/search/domain — Unified cross-graph search across all domain libraries
  • POST /v1/search/report — Unified cross-graph search across industry research decks
  • POST /v1/search/specialist — Search specialist knowledge graphs
  • POST /v1/graphs/{graph_id}/evidence — Retrieve curated primary source evidence
  • GET /v1/graphs/{graph_id}/statistics — Cross-graph quantitative data search
  • POST /v1/supplemental/context — Economic, trade and demographic datasets from 110 institutions
  • GET /v1/supplemental/suggest — Recommend relevant statistical data sources
  • GET /v1/supplemental/portwatch/snapshot — IMF PortWatch maritime container data
  • GET /v1/analysts — Directory of Human Agents and Synthetic Analysts
  • GET /v1/analysts/{id} — Analyst profile and expertise details
  • POST /v1/human-agents/consult — Consult a verified Human Agent
  • POST /v1/analysts/consult — Consult a synthetic domain analyst
  • POST /v1/brand-intelligence/{brand} — Brand footprint, trends and competitive sentiment
  • POST /v1/verify/claim — Verify factual claims against research graphs
  • POST /v1/intelligence/dossier — Structured evidence citations
  • GET /v1/health — API health status