One API, Five Real-Time Financial Data Categories
FinanceFlowAPI’s Financial Data API gives you a single key and one consistent JSON format to query economic calendar events, commodity prices, government bond yields, currency exchange rates and macroeconomic indicators, all real-time and historical, without integrating a separate data vendor for each asset class.
Get Your API Key Discover DocsFinancial Data API Catalog
FinanceFlowAPI’s Financial Data API is organized into topical categories, each with its own dedicated endpoint page covering parameters, response schema, errors and code examples. This page indexes every category currently documented. Start here to find the right one, then follow through for the full reference. For plans, billing and account setup, see the FinanceFlowAPI homepage.
Global API Capabilities
- One key, one format: every endpoint below shares the same
api_keyauthentication and the same JSON response envelope (success,code,message,meta,data). - Real-time and historical: several categories return live data plus a date-range history. Exact historical support varies by category, see each endpoint page for specifics.
- Consistent error handling: the same HTTP status codes mean the same thing across every endpoint (see below).
- Per-tariff rate limits: request volume and your per-minute rate limit scale with your subscription plan.
Endpoint Catalog
Five data categories, each with a dedicated endpoint page. Pick one to see live examples, parameters and errors. More categories are being added.
- Economic Calendar API: macroeconomic events (GDP, CPI, PMI, interest rate decisions) with actual vs. forecast vs. previous values, for 83 countries.
- Commodity Price API: real-time and historical prices for 102 commodities, including gold, oil and other metals.
- Government Bonds API: live and historical sovereign bond yields for 54 countries.
- Currency Exchange Rate API: live quotes for 628 currency pairs across 127 currencies.
- Economic Indicators API: GDP, inflation, unemployment and 660+ other indicators across 131 countries.
API Authentication
Every endpoint above uses the same authentication: pass your key as an api_key query parameter on any request. One key works across every data category. There is no separate key per endpoint. See the full API documentation for the exact parameters of each endpoint.
Common Response Format & Errors
Every endpoint returns the same JSON envelope:
{
"success": true,
"code": 200,
"message": "OK",
"meta": {
"timestamp": 1787485535,
"request_id": "6a8add5f5274d"
},
"data": [...]
}
| HTTP code | Meaning |
|---|---|
200 | OK: request succeeded |
400 | Bad request: missing or invalid parameters |
403 | Invalid or missing API key, expired subscription, request limit reached, or the endpoint isn’t included in your plan |
404 | No data found for the request, or unknown endpoint |
429 | Rate limit exceeded for your subscription plan |
500 | Internal server error (rare) |
Exact error conditions vary slightly by endpoint. See each endpoint page’s own Errors table for specifics.
Quick Start
- Get an API key. Create a FinanceFlowAPI account and choose a plan. See Pricing & Access below for current plans and limits.
- Make your first request. Every request follows the same shape:
GET https://financeflowapi.com/api/v1/{endpoint}?api_key=YOUR_API_KEY&.... Pick a category above for its exact endpoint name and parameters. - Go deeper. See the full API documentation for every parameter, response field and error code.
Market Data API
Test Plan
$5.00/month
Historical data, days: 60
Requests limit: 200
Requests Speed limit(per minute): 20
Standard Subscription
$25.00/month
Historical data, years: 5
Requests limit: 10000
Requests Speed limit(per minute): 60
Premium Subscription
$50.00/month
Historical data, years: 20+
Requests limit: 100000
Requests Speed limit(per minute): 120
Why FinanceFlowAPI
Most financial data needs mean juggling several vendors: one for market events, another for commodities, a third for FX, a fourth for bonds. FinanceFlowAPI replaces that with a single integration:
- One key, one format, five categories: the same
api_keyand the same JSON response envelope work across economic calendar, commodities, government bonds, currency rates and economic indicators, so you build one integration instead of five. - Consistent error handling: the same HTTP status codes (
400/403/404/429/500) mean the same thing across every endpoint, instead of a different error contract per data vendor. - Real-time and historical together: several categories expose both current values and date-range history through the same endpoint family, without a separate historical-data product.
- Broad, verified coverage: 83 countries for economic events, 102 commodities, 54 countries for government bonds, 628 currency pairs and 660+ economic indicators across 131 countries. See the Endpoint Catalog above for details.
FAQ
Is there a free trial or free plan?
No. FinanceFlowAPI is a paid API from the first request. See Pricing & Access above for current plans, limits and pricing.
Do I need a separate API key for each data category?
No. One api_key authenticates every endpoint across all five categories, subject to which endpoints your plan includes.
What’s the difference between this page and the category pages?
This page indexes all five categories and documents what’s common to every endpoint: authentication, response format and errors. Each category has its own page with the exact parameters, response schema and code examples for that category’s endpoints.
Is data available for both real-time and historical use cases?
It varies by category: some endpoints return live values only, others also support a date-range history. Check each category’s own page for what it supports.
How do I get started?
Create a FinanceFlowAPI account and choose a plan. See Pricing & Access above for current plans and limits, then follow Quick Start above.
Related Guides
- Financial Data API Guide: step-by-step integration tutorial with real requests and code.
- Why Use FinanceFlowAPI: how it compares and when it’s the right fit.
Ready to start? Create your FinanceFlowAPI account and get your API key in minutes.
Get Your API Key