Finnworlds is a financial data platform providing comprehensive market data via REST API. It covers bonds, dividends, stock splits, OHLC history, macroeconomic calendars and indicators, commodities, indices, forex, stocks, earnings, ETF holdings, financial statements, insider transactions, and SEC filings. All data is JSON, accessible by API key with SDKs for major languages — built for fintech apps and quant research.
Power end-to-end data operations for your Finnworlds API with Nexla. Our bi-directional Finnworlds connector is purpose-built for Finnworlds, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Finnworlds or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Finnworlds workflows fast, secure, and fully governed.
Features
Type: API
SourceDestination
Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
Request optimization with intelligent batching, retry, and caching to minimize API calls and costs
To connect Nexla to the Finnworlds API, you need a Finnworlds account and an active API key. Finnworlds uses API key authentication — the key is passed as a query parameter with every request.
Finnworlds provides an API key immediately upon account registration. The key is auto-generated and ready to use with no additional authorization steps required.
Visit finnworlds.com and click Sign Up (or Log In if you already have an account).
Complete the registration form with your name, email address, and a password, then confirm your email address if prompted.
Once logged in, navigate to your Account Dashboard or API Keys section to locate your API key. Finnworlds generates the key automatically — it is displayed on the dashboard and is ready to use immediately.
Copy the API key and store it securely. This key authenticates all API requests and should be treated like a password.
Finnworlds offers several subscription tiers, including a free plan that provides access to basic API endpoints for exploration and development. Paid plans (Individual, Starter, Developers, and Enterprise) unlock higher request limits and additional endpoints. For academic or non-profit use, contact Finnworlds at support@finnworlds.com to discuss discounted access. Additional plan details are available at finnworlds.com/pricing.
Important
Keep your Finnworlds API key confidential. Avoid embedding the key in public repositories or client-side code. If a key is compromised, regenerate it from your Finnworlds account dashboard.
After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.
Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.
Enter your Finnworlds API key in the API Key field. This key authenticates Nexla with the Finnworlds API. Nexla will include the key as a key query parameter in all API requests to Finnworlds endpoints (for example: https://api.finnworlds.com/api/v1/benchmark?key=YOUR_API_KEY).
The API key can be found in your Finnworlds account dashboard. For complete information about managing your API key, visit the Finnworlds documentation.
Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation and can be selected for use with a new data source.
To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Finnworlds connector tile, then select the credential that will be used to connect to the Finnworlds API, and click Next; or, create a new Finnworlds credential for use in this flow.
Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Finnworlds API endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below. Click on an endpoint to see more information about it and how to configure your data source for that endpoint.
List Bonds
This endpoint retrieves a list of bond data including pricing, yields, and maturity information. Use this endpoint to access fixed-income market data for analysis, portfolio management, or benchmarking against interest rate movements.
This endpoint does not require any additional parameters beyond your API key credential. Select the List Bonds template, and the source will automatically call the Finnworlds bonds endpoint to retrieve available bond data.
The response includes fields such as bond name, ISIN, coupon rate, maturity date, current price, and yield-to-maturity, enabling comprehensive fixed-income analysis.
This endpoint returns a list of dividend payment records including amounts, payment dates, ex-dividend dates, and the associated securities. Use this endpoint to track dividend income, perform yield analysis, or build dividend-focused screeners and alerts.
Select the List Dividends template to fetch dividend records from the Finnworlds API. No additional parameters are required beyond the credential.
The response data is extracted from the dividends array within the API result, providing a record-per-dividend structure that maps cleanly to downstream analytics tools.
This endpoint returns a list of stock split events, including the split ratio, effective date, and the affected security. Use this endpoint to adjust historical price data for split-adjusted calculations or to maintain corporate action records.
Select the List Stock Splits template to fetch stock split records. No additional configuration is required beyond selecting the template.
The response data is extracted from the stocksplits array within the API result, with each record representing a single split event.
This endpoint returns historical OHLC (open, high, low, close) candlestick data for securities, along with trading volume. Use this endpoint for technical analysis, price charting, backtesting trading strategies, or building financial models that require historical price series.
Select the List Historical Candlestick Data template to retrieve daily OHLC records. No additional parameters are required beyond the credential when using the template.
The response data is extracted from the daily_stock_data array within the API result, with each record representing one trading day's price data for a given security.
Fields typically include the ticker symbol, date, open price, high price, low price, close price, and volume.
This endpoint returns a list of upcoming and recent macroeconomic events, including scheduled release dates, consensus forecasts, prior values, and actual reported values. Use this endpoint to build economic event trackers, automate alerts for high-impact releases, or correlate market movements with economic data points.
Select the List Macroeconomic Calendar template to fetch macroeconomic event records. No additional parameters are required beyond the credential.
The response includes fields such as event name, country, release date, forecast value, prior value, and actual value (when available).
This endpoint returns a list of macroeconomic indicator readings, including economic metrics such as GDP, inflation, unemployment, and interest rates, along with their values and reporting periods. Use this endpoint for country-level economic analysis, macro trend modeling, or enriching financial datasets with economic context.
Select the List Macroeconomic Indicators template to fetch macroeconomic indicator records. No additional parameters are required beyond the credential.
Each record in the response represents a single indicator reading for a specific country and time period.
This endpoint returns commodity market data including prices, contract specifications, and market information for energy, metals, agricultural products, and other commodity classes. Use this endpoint to monitor commodity price trends, build commodity dashboards, or integrate raw material pricing into financial models.
Select the List Commodities template to fetch commodity records. No additional parameters are required beyond the credential.
Each record in the response represents a single commodity and includes fields such as commodity name, price, unit, and date.
This endpoint returns a list of benchmark indices and their performance metrics, enabling comparative analysis of portfolio or security performance against standard market benchmarks. Use this endpoint to power performance attribution, risk-adjusted return calculations, or benchmark tracking dashboards.
Select the List Benchmarks template to fetch benchmark index records. No additional parameters are required beyond the credential.
Each record in the response represents a benchmark index and includes performance metrics such as index level, daily return, and historical values.
This endpoint retrieves foreign exchange (forex) currency pair rates. Use this endpoint to access live or historical exchange rate data for currency conversion, international financial reporting, or FX risk management workflows.
Select the List Forex template to fetch currency pair rate records. No additional parameters are required beyond the credential.
Each record in the response represents a currency pair and includes the exchange rate and associated metadata.
This endpoint retrieves market index levels and compositions, providing data on major stock market indices including their constituent weights and performance. Use this endpoint to analyze index-level market trends, build index tracking dashboards, or support passive investment strategy research.
Select the List Indices template to fetch market index records. No additional parameters are required beyond the credential.
Each record in the response represents an index level reading and includes index name, value, and date information.
This endpoint retrieves real-time or delayed equity and stock quote data. Use this endpoint to power equity screeners, monitor watchlists, or supply current price data to trading applications and financial dashboards.
Select the List Stocks template to fetch equity quote records. No additional parameters are required beyond the credential.
Each record in the response represents a stock quote and may include fields such as ticker symbol, current price, change, percentage change, and market capitalization.
This endpoint retrieves corporate earnings announcements and earnings-per-share (EPS) data. Use this endpoint to track earnings surprises, build earnings calendars, or enrich stock analysis with fundamental performance metrics.
Select the List Earnings template to fetch earnings records. No additional parameters are required beyond the credential.
Each record in the response represents an earnings event and includes fields such as company name, ticker, reported EPS, estimated EPS, revenue, and announcement date.
This endpoint retrieves Google search volume trends and related stock data, enabling assessment of retail investor sentiment based on search activity. Use this endpoint to correlate search interest with stock price movements, identify emerging retail interest in specific securities, or build sentiment-based trading signals.
Select the List Google Trends template to fetch search trend records. No additional parameters are required beyond the credential.
Each record in the response represents a data point linking a search trend to an associated security, including search volume and related stock information.
This endpoint retrieves a comprehensive list of all stock markets and securities trading exchanges, including MIC codes, exchange names, countries of operation, and status information. Use this endpoint to build exchange reference data, enrich security records with exchange metadata, or support compliance and reporting workflows.
Select the List Market Exchanges template to fetch exchange records. No additional parameters are required beyond the credential.
Each record in the response represents a single trading exchange and includes fields such as MIC code, exchange name, country, and active status.
This endpoint retrieves current and real-time stock prices, price change details, and the last traded timestamp for any ticker. Use this endpoint to power live price feeds, alert systems, or any application that requires the most recent price available for a given security.
Select the List Real-Time Prices template to fetch current price records. No additional parameters are required beyond the credential.
Each record in the response represents the latest price data for a security and includes the current price, price change, percentage change, and last traded timestamp.
This endpoint retrieves the latest and historical buy, sell, and hold consensus ratings, as well as price targets from analysts covering a stock. Use this endpoint to build analyst sentiment dashboards, track changes in consensus ratings over time, or incorporate Wall Street opinions into investment research workflows.
Select the List Analyst Ratings template to fetch analyst rating records. No additional parameters are required beyond the credential.
The response data is extracted from the analysts array within the API result. Each record represents an analyst's rating for a given stock and includes fields such as analyst name, firm, rating, price target, and date.
This endpoint retrieves balance sheet data — assets, liabilities, and equity — for publicly traded companies. Use this endpoint to analyze a company's financial position, calculate solvency and liquidity ratios, or build fundamental analysis workflows that require structured financial statement data.
Select the List Balance Sheets template to fetch balance sheet records. No additional parameters are required beyond the credential.
Each record in the response represents a balance sheet filing period for a company and includes line items such as total assets, total liabilities, stockholders' equity, and reporting date.
This endpoint retrieves cash flow statement data for publicly traded companies, covering operating, investing, and financing activities. Use this endpoint to assess a company's liquidity and cash generation, support free cash flow modeling, or enrich fundamental research with standardized cash flow data.
Select the List Cash Flows template to fetch cash flow statement records. No additional parameters are required beyond the credential.
Each record in the response represents a reporting period for a company and includes line items such as operating cash flow, capital expenditures, free cash flow, and financing activities.
This endpoint retrieves current and historical ETF holdings and constituent weights for any ETF ticker. Use this endpoint to analyze ETF portfolio composition, track changes in holdings over time, or build ETF screening and comparison tools.
Select the List ETF Holdings template to fetch ETF holding records. No additional parameters are required beyond the credential.
Each record in the response represents a holding within an ETF and includes the security name, ticker, weighting percentage, number of shares held, and reporting date.
This endpoint retrieves 200+ financial ratios — including P/E ratio, EV/EBITDA, quick ratio, debt-to-equity, and many more — for publicly traded companies. Use this endpoint to accelerate fundamental analysis, build custom valuation models, or populate financial screening tools with standardized ratio data.
Select the List Financial Ratios template to fetch financial ratio records. No additional parameters are required beyond the credential.
Each record in the response represents a company's ratio snapshot for a given period and includes a broad set of valuation, profitability, liquidity, and leverage metrics.
This endpoint retrieves historical and current income statement data for publicly traded companies, covering revenue, expenses, and net income. Use this endpoint to analyze profitability trends, build earnings models, or integrate structured P&L data into financial research and reporting pipelines.
Select the List Income Statements template to fetch income statement records. No additional parameters are required beyond the credential.
Each record in the response represents an income statement for a specific reporting period and includes line items such as total revenue, gross profit, operating income, net income, and EPS.
This endpoint retrieves insider transactions filed with the SEC, including trade dates, security types, and ownership changes for corporate insiders. Use this endpoint to monitor insider buying and selling activity, identify potential signals of management confidence or concern, or support regulatory compliance research.
Select the List Insider Transactions template to fetch insider transaction records. No additional parameters are required beyond the credential.
Each record in the response represents a single insider transaction and includes the insider's name, role, transaction type (buy/sell), number of shares, transaction price, and filing date.
This endpoint retrieves SEC filing metadata and extracts segments from full regulatory reports, including 10-K annual reports, 10-Q quarterly reports, 8-K current reports, and more. Use this endpoint to build document retrieval pipelines, automate regulatory research workflows, or enrich company data with structured filing records.
Select the List SEC Filings template to fetch SEC filing records. No additional parameters are required beyond the credential.
Each record in the response represents a filing submission and includes metadata such as company name, CIK number, filing type, filing date, and a reference to the filing document.
This endpoint retrieves 50+ technical indicators — including RSI, MACD, Bollinger Bands, moving averages, and more — calculated on historical candlestick data across multiple timeframes. Use this endpoint to power technical analysis dashboards, build algorithmic trading signals, or supply pre-calculated indicators to quantitative research pipelines.
Select the List Technical Indicators template to fetch technical indicator records. No additional parameters are required beyond the credential.
Each record in the response represents a set of indicator values for a specific security and timeframe, enabling direct use in charting or signal generation without manual calculation.
Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving. If the sample data is not as expected, review the selected endpoint and associated settings, make any necessary adjustments, and test again.
Finnworlds data sources can also be manually configured to ingest data from any valid Finnworlds REST API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom query parameters such as filtering by ticker symbol or date range. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.
Finnworlds endpoints use the GET method and follow the pattern https://api.finnworlds.com/api/v1/{endpoint} (for example, https://api.finnworlds.com/api/v1/dividends). Your API key is handled automatically by Nexla via the credential — no request headers are required. Most responses nest records at $.result.output[*], though some endpoints use a named sub-array, such as $.result.output.dividends[*] for dividends, $.result.output.stocksplits[*] for stock splits, and $.result.output.analysts[*] for analyst ratings.
Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Finnworlds data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.
