Skip to main content

Response Envelope

Most successful responses include data and meta:

{
  "data": {},
  "meta": {
    "provider": "google_finance",
    "contract": "gfin.quote.summary.v1",
    "route": "quote_summary",
    "operation": "quote_summary",
    "family": "quote",
    "cache": "edge",
    "ttl_seconds": 3600,
    "stale_seconds": 43200,
    "request_id": "..."
  }
}

data contains the decoded public data payload for the route. meta contains gfin-owned identifiers and operational context.

Public Contract IDs​

Use meta.contract or the x-gfin-contract response header as the stable contract identifier:

gfin.search.v1
gfin.research.v1
gfin.quote.summary.v1
gfin.markets.summary.v1

These contract IDs are the public integration surface. Do not depend on undocumented array positions unless a route page or API reference documents that field.

Metadata Policy​

Public responses do not expose raw transport route names, source endpoint identifiers, source-debug metadata, or source-identifying CORS headers.

The public endpoint catalog is intentionally compact:

curl "https://api.gfin.dev/v1/endpoints"

Use it to discover public route names, public paths, and public contract IDs.