Skip to content

README.md

Latest commit

 

History

History
86 lines (75 loc) · 5.19 KB

README.md

File metadata and controls

86 lines (75 loc) · 5.19 KB

Stock Market Index API - Finnworlds

The Stock Market Index API provides developers with real-time benchmark index data from global markets. With just one API call, you can retrieve the latest values for major stock indices such as the S&P 500, Dow Jones, NASDAQ 100, Russell 1000, GB100, Nifty Fifty, Shanghai 50, CS50 and many more worldwide.

This index data API is built for fast integration and accuracy, offering reliable performance indicators without the need to scrape or maintain your own feeds. Developers can easily track daily price movements, percentage changes, and trends.

The API is ideal for fintech platforms, trading dashboards, academic research, or portfolio management applications that rely on precise and up-to-date benchmark data. With broad coverage and straightforward REST access, it’s a useful data tool for anyone analyzing market performance.

Common Use Cases

– Displaying live and historical benchmark index values on trading or investment platforms
– Feeding financial dashboards with daily, weekly, monthly, and yearly percentage changes data on indices
– Academic research or data modeling with market benchmark references
– Comparing regional market performance across different indices

API Features

  • Global Index Coverage – Access major indices such as S&P 500 (US500), Dow Jones (US30), NASDAQ 100 (US100), Russell 1000 (US1000), and equivalents across countries worldwide.
  • Daily Movements – Includes absolute price change and daily percentage change.
  • Performance Metrics – Weekly, monthly, and annual percentage returns.
  • Region & Country Classification – Retrieve indices by country or broader region (e.g., America, Europe, Asia).
  • Date & Timestamp – Each record includes precise datetime stamps for accuracy.

Get started by getting your API key on Finnworlds website. Looking for academic or non-profit use? Send us an email to start the conversation.

How to access the data

  • JSON rest API
  • Excel CSV download
  • PDF reports
  • Email link

Documentation

Our documentation includes input parameters, output objects with descriptions. We also have SDKs for Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Strest, Rust, Swift and Scala.

Examples

https://api.finnworlds.com/api/v1/benchmark?key=APIKEY&country=united_states

{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "output": [
            {
                "region": "america",
                "country": "united states",
                "benchmark": "us500",
                "price": "6449.8",
                "price_change_day": "-18.74",
                "percentage_day": "-0.29%",
                "percentage_week": "0.94%",
                "percentage_month": "2.97%",
                "percentage_year": "16.12%",
                "datetime": "2025-08-15T00:00:00.000"
            },
            {
                "region": "america",
                "country": "united states",
                "benchmark": "us30",
                "price": "44946",
                "price_change_day": "35",
                "percentage_day": "0.08%",
                "percentage_week": "1.74%",
                "percentage_month": "1.56%",
                "percentage_year": "10.54%",
                "datetime": "2025-08-15T00:00:00.000"
            },
            {
                "region": "america",
                "country": "united states",
                "benchmark": "us100",
                "price": "23712",
                "price_change_day": "-120",
                "percentage_day": "-0.51%",
                "percentage_week": "0.43%",
                "percentage_month": "3.51%",
                "percentage_year": "21.55%",
                "datetime": "2025-08-15T00:00:00.000"
            },
            {
                "region": "america",
                "country": "united states",
                "benchmark": "us1000",
                "price": "3525.97",
                "price_change_day": "-9.33",
                "percentage_day": "-0.26%",
                "percentage_week": "0.97%",
                "percentage_month": "2.87%",
                "percentage_year": "16.43%",
                "datetime": "2025-08-15T00:00:00.000"
            }
        ]
    }
}

Customer Support

Need help, have questions? Get in touch with Support.

Legal

Use of the Finnworlds website, services like API and database are subject to the Finnworlds Terms & Conditions.