Skip to content

index-api.md

Latest commit

 

History

History
105 lines (88 loc) · 4.14 KB

index-api.md

File metadata and controls

105 lines (88 loc) · 4.14 KB
Raw

Stock Index Spot API - Real-Time Stock Index Data with FinanceFlowAPI

The Stock Index Spot API from FinanceFlowAPI provides real-time data on 86 global stock index benchmarks, such as the S&P 500, DAX 40, and ASX200, including price changes, regional classification, and performance trends. Built for investors, analysts, and financial institutions, this API supports monitoring market trends for informed investment decisions. Integrate index data into your trading platforms or analytical tools.

Sign up to get started and explore the full API at financeflowapi.com/api_documentation.

Base URL

https://financeflowapi.com/api/v1/

All Stock Index Spot API endpoints follow this base URL.

Endpoints

1. Supported Benchmark List

  • Endpoint: /index-catalog
  • Description: Retrieves the list of all 86 available stock index benchmarks, including major indices like the S&P 500 (us500), Dow Jones (us30), Nasdaq 100 (us100), FTSE 100 (gb100), DAX 40 (de40), and Nikkei 225 (jp225).

Request Parameters

  • api_key (string, required): Your unique API key. Get yours.

Request Example

GET https://financeflowapi.com/api/v1/index-catalog?api_key=YOUR_API_KEY

Response Example

{
    "success": true,
    "code": 200,
    "message": "OK",
    "meta": {
        "timestamp": 1743339544,
        "request_id": "67e9401854175"
    },
    "data": [
        {"benchmark": "adx general"},
        {"benchmark": "asx200"},
        {"benchmark": "us500"},
        {"benchmark": "de40"}
    ]
}

2. Stock Index Spot Data

  • Endpoint: /index-spot
  • Description: Retrieves real-time stock index data for a specified country or benchmark, including current price, daily change, and performance metrics.

Request Parameters

  • api_key (string, required): Your unique API key.
  • country (string, optional): The country for which to retrieve index data (e.g., "germany").
  • benchmark (string, optional): The specific benchmark to retrieve (e.g., "de40"). Use either country or benchmark.

Request Examples

By Country:

GET https://financeflowapi.com/api/v1/index-spot?api_key=YOUR_API_KEY&country=germany

By Benchmark:

GET https://financeflowapi.com/api/v1/index-spot?api_key=YOUR_API_KEY&benchmark=de40

Response Example

{
    "success": true,
    "code": 200,
    "message": "OK",
    "meta": {
        "timestamp": 1743340626,
        "request_id": "67e94452c1b30"
    },
    "data": {
        "benchmark": "de40",
        "country": "germany",
        "region": "europe",
        "price": "26361.500",
        "daily_change": "95.36",
        "daily_change_percent": "0.36%",
        "monthly_change_percent": "3.94%",
        "yearly_change_percent": "9.63%",
        "last_updated": "2026-08-26T15:12:29"
    }
}

Note: price is returned as a string, not a numeric JSON value.

Why Choose FinanceFlowAPI?

  • Global Index Coverage: Access data on stock indices from Europe, Asia, the Americas, and beyond.
  • Affordable Plans: Start with our Test plan ($5/month, 200 requests) or upgrade to Standard ($25/month) or Premium ($50/month) for more data.
  • Clear Documentation: Documentation with code samples for every endpoint.
  • Future-Proof: Upcoming endpoints include SEC data.

Get Started

  1. Sign up to get your API key.
  2. Explore the Stock Index Spot API documentation or this repository for details.
  3. Test the endpoints with our Test plan or unlock full access with a paid plan.

Star this repository to support FinanceFlowAPI and stay updated on new features! For questions, open an issue or contact support@financeflowapi.com.

FinanceFlowAPI: Empowering fintech with real-time and historical financial data.