Skip to main content

AI Agents

Give agents a small, stable gfin surface instead of asking them to infer routes.

Minimal Context​

Base URL: https://api.gfin.dev
Identity header: X-Gfin-Contact: you@example.com
OpenAPI: https://api.gfin.dev/v1/openapi.json
Endpoint catalog: https://api.gfin.dev/v1/endpoints
LLM docs index: https://docs.gfin.dev/llms.txt

Useful Routes​

GET /v1/search?q=apple
GET /v1/research?q=Why%20is%20AAPL%20moving%20today%3F
GET /v1/quote/AAPL/summary?exchange=NASDAQ
GET /v1/quote/AAPL/financials?exchange=NASDAQ
GET /v1/markets/summary
GET /v1/news?limit=5

Tool Rules​

  • Prefer public route names and OpenAPI schemas.
  • Branch on error.code, not message text.
  • Respect 429 Retry-After.
  • Avoid refresh=1 unless the user asks for a fresh read.
  • Preserve meta.request_id in logs.
  • Do not invent investment advice from missing data.

MCP-Style Manifest​

gfin exposes a compact tool manifest:

curl "https://api.gfin.dev/.well-known/mcp-manifest.json"

It includes public tools for search, research, and quote access.