Skip to main content

News And Events

Use news and event routes when your product needs current market context.

News​

curl "https://api.gfin.dev/v1/news?limit=5" \
  -H "X-Gfin-Contact: you@example.com"
news = client.news(limit=5)
const news = await client.news({ limit: 5 });

News Stories​

curl "https://api.gfin.dev/v1/news/stories?limit=5" \
  -H "X-Gfin-Contact: you@example.com"
stories = client.news_stories(limit=5)
const stories = await client.newsStories({ limit: 5 });

Events​

curl "https://api.gfin.dev/v1/events" \
  -H "X-Gfin-Contact: you@example.com"
events = client.events()
const events = await client.events();

Practical Rules​

  • Use limit or count to keep responses small.
  • Cache normally for background jobs.
  • Preserve article URLs and publisher labels exactly as returned.
  • Treat empty news sections as valid empty states.