Skip to main content

Realtime

Realtime routes use entity IDs. If you only have a ticker, run search or a quote view first to discover the entity information your workflow needs.

Snapshots​

curl "https://api.gfin.dev/v1/realtime/snapshots?entity_ids=/m/0cqyw,/m/016yss" \
  -H "X-Gfin-Contact: you@example.com"
snapshots = client.realtime_snapshots(["/m/0cqyw", "/m/016yss"])
const snapshots = await client.realtimeSnapshots(["/m/0cqyw", "/m/016yss"]);

Trend Lines​

curl "https://api.gfin.dev/v1/realtime/trend-lines?entity_ids=/m/0cqyw,/m/016yss" \
  -H "X-Gfin-Contact: you@example.com"
trend_lines = client.realtime_trend_lines(["/m/0cqyw", "/m/016yss"])
const trendLines = await client.realtimeTrendLines(["/m/0cqyw", "/m/016yss"]);

Guidance​

  • Keep entity ID lists short.
  • Use normal cache for repeated dashboard reads.
  • Use refresh=1 only for explicit refresh actions.
  • Log meta.request_id for debugging.