Quick Start Guide
The API works by sending GET requests to our server and returning data in JSON format.
To start using the Fin2Dev API, follow these three simple steps.
Step 1 — Choose and pay for a pricing plan
Choose a suitable tariff plan and complete the payment.
Get started easily: Start with Basic Plan
Or explore pricing options: View Pricing Plans
Step 2 — Get your API key
After payment, an email containing your API key will be sent to your email address.
Your API key is required to authorize all API requests.
In the examples below, it is shown as YOUR_API_KEY
Security note: Do not share your API key with anyone and do not make it public.
Step 3 — Send a GET request to the server
In simple terms, you need to create a special link (URL) with the required parameters, open it in your browser (or send it via your application), and get structured JSON data in response.
Important Notice
In our documentation, you will find some example links (URLs) that open in a new browser tab.
If you see the following error message in a new tab:
{"error":"Invalid key"}
See the example in the screenshot:
This is normal. It simply means that you need to replace YOUR_API_KEY
in the URL with your actual API key.
Correct Request Example
Below is an example of how a correctly formatted request URL should look:
GET Request Format
All requests must start with the base URL:
https://apidata.fin2dev.com/v1/
After the base URL, specify the method name (endpoint), for example:
macrocalendar
Next, you must include the required key parameter with your API key:
?key=YOUR_API_KEY
If the method requires additional parameters (for example, country or ticker), they are added using the
& symbol:
&country=United_Kingdom
General Request Structure
https://apidata.fin2dev.com/v1/{METHOD}?key={YOUR_API_KEY}&{PARAMETER}={VALUE}
Example of a Complete Request
https://apidata.fin2dev.com/v1/macrocalendar?key=12345abcde&country=United_KingdomGeneral Principles
This API provides access to financial information through a RESTful interface.
All endpoints are accessed via the base URL:
https://apidata.fin2dev.com/v1/.
API Structure
Each endpoint follows the structure:
https://apidata.fin2dev.com/v1/{endpoint}?key={YOUR_API_KEY}&{PARAMETER1}={VALUE1}&{PARAMETER2}={VALUE2}
- Base URL:
https://apidata.fin2dev.com/v1/ - Endpoint: Specific resource, e.g.
companyratings - key: Mandatory API key provided after purchasing a plan.
- PARAMETER1, PARAMETER2: Endpoint-specific parameters
Authentication
All requests require a valid API key (your API key) passed as a query parameter key.
To obtain your API key, purchase a pricing plan.
Response Format
All responses are returned in JSON format. Make sure to handle possible errors as described in each endpoint’s documentation.
Testing the API in a Browser
You can test the API directly in your web browser without using any additional tools. This is the fastest way to check whether your API key works and to understand how the API responds.
Step-by-Step Guide
-
Use the base API URL
https://apidata.fin2dev.com/v1/ -
Choose an endpoint (for example:
companyratings)
https://apidata.fin2dev.com/v1/companyratings
-
Add your API key
ReplaceYOUR_API_KEYwith your actual key:https://apidata.fin2dev.com/v1/companyratings?key=YOUR_API_KEY
-
Add required parameters
Some endpoints require additional parameters such as a ticker symbol:https://apidata.fin2dev.com/v1/companyratings?key=YOUR_API_KEY&ticker=AAPL -
Press Enter
If the request is valid, the browser will return a JSON response.
If you see raw JSON data in the browser, the request was successful. For better readability, you can use browser extensions or online JSON formatters.
Simple Code Examples
cURL
curl "https://apidata.fin2dev.com/v1/companyratings?key=YOUR_API_KEY&ticker=AAPL"JavaScript (Fetch API)
fetch('https://apidata.fin2dev.com/v1/companyratings?key=YOUR_API_KEY&ticker=AAPL')
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
PHP
$url = "https://apidata.fin2dev.com/v1/companyratings?key=YOUR_API_KEY&ticker=AAPL";
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);
Company Ratings
Retrieve analyst ratings for a specific company using the stock ticker.
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Analyst Ratings API (Stock Ratings API) page.
Endpoint
https://apidata.fin2dev.com/v1/companyratings?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker * | string (query) | Stock ticker (e.g., AAPL, GOOG, TSLA). One ticker at a time. |
| date_from | string (query) | Start date for historical ratings (format: YYYY-MM-DD). |
| date_to | string (query) | End date for historical ratings (format: YYYY-MM-DD). |
| rated | string (query) | Filter by rating: buy, sell, or hold. |
Example Request
https://apidata.fin2dev.com/v1/companyratings?key={YOUR_API_KEY}&ticker=MSFT&date_from=2021-06-01&rated=buyExample Response
{
"status": {
"code": "200",
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company_name": "Microsoft Corporation",
"ticker": "MSFT"
},
"output": {
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "305.75",
"analyst_highest": "350.00",
"analyst_lowest": "270.00",
"analysts_number": "25",
"buy": "20",
"hold": "4",
"sell": "1",
"consensus_date": "2023-11-05"
},
"analysts": {
"analyst_name": "sarah wilson",
"analyst_firm": "GlobalTech",
"analyst_role": "analyst",
"rating": {
"date_rating": "2023-03-22",
"target_date": "2024-03-22",
"price_target": "310.0",
"rated": "Buy",
"conclusion": "upgraded"
}
}
}
}
}Analyst Ratings
Retrieve ratings from a specific analyst or firm.
Endpoint
https://apidata.fin2dev.com/v1/analystratings?key={YOUR_API_KEY}&analyst_name={ANALYST_NAME}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| analyst_name | string (query) | Name of the analyst (e.g., john_doe). |
| analyst_firm | string (query) | Name of the analyst firm (e.g., goldman_sachs). |
| date_from | string (query) | Start date for historical ratings (format: YYYY-MM-DD). |
| date_to | string (query) | End date for historical ratings (format: YYYY-MM-DD). |
| rated | string (query) | Filter by rating: buy, sell, or hold. |
Example Request
https://apidata.fin2dev.com/v1/analystratings?key={YOUR_API_KEY}&analyst_name=michael_brown&rated=holdExample Response
{
"status": {
"code": "200",
"message": "OK",
"details": ""
},
"result": {
"basics": {
"analyst_name": "michael brown",
"analyst_firm": "TechTrend",
"analyst_role": "analyst"
},
"output": {
"company_name": "Amazon Inc",
"ticker": "AMZN",
"rating": {
"date_rating": "2023-05-15",
"target_date": "2024-05-15",
"price_target": "145.0",
"rated": "Hold",
"conclusion": "maintained"
},
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "150.20",
"analyst_highest": "180.00",
"analyst_lowest": "120.00",
"analysts_number": "18",
"buy": "10",
"hold": "7",
"sell": "1",
"consensus_date": "2023-06-10"
}
}
}
}Consensus Ratings
Retrieve consensus analyst ratings and estimates for a specific company.
Endpoint
https://apidata.fin2dev.com/v1/consensusratings?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker * | string (query) | Stock ticker (e.g., AAPL, GOOG, TSLA). One ticker at a time. |
Example Request
https://apidata.fin2dev.com/v1/consensusratings?key={YOUR_API_KEY}&ticker=GOOGExample Response
{
"status": {
"code": "200",
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company_name": "Alphabet Inc",
"ticker": "GOOG"
},
"output": {
"analyst_consensus": {
"consensus_conclusion": "",
"stock_price": "135.40",
"analyst_average": "145.80",
"analyst_highest": "165.00",
"analyst_lowest": "115.00",
"analysts_number": "27",
"buy": "22",
"hold": "5",
"sell": "0",
"consensus_date": "2023-07-18"
},
"earnings_estimate": {
"previous_quarter": {
"analysts_number": "22",
"average_estimate": "1.65",
"low_estimate": "1.50",
"high_estimate": "1.80",
"last_year_eps": "1.70",
"date": "quarter3_23"
},
"current_quarter": {
"analysts_number": "20",
"average_estimate": "1.45",
"low_estimate": "1.30",
"high_estimate": "1.60",
"last_year_eps": "1.40",
"date": "quarter4_23"
},
"next_quarter": "",
"next_year": {
"analysts_number": "30",
"average_estimate": "6.80",
"low_estimate": "6.10",
"high_estimate": "7.50",
"last_year_eps": "6.20",
"year": "2024"
}
},
"earnings_history": {
"3_month_ago": "",
"6_month_ago": {
"estimated_eps": "1.30",
"real_eps": "1.25",
"difference_points": "-0.05",
"difference_perc": "-3.85%",
"date": "quarter2_23"
},
"9_month_ago": {
"estimated_eps": "1.15",
"real_eps": "1.18",
"difference_points": "0.03",
"difference_perc": "2.61%",
"date": "quarter1_23"
},
"12_month_ago": {
"estimated_eps": "1.05",
"real_eps": "1.10",
"difference_points": "0.05",
"difference_perc": "4.76%",
"date": "quarter4_22"
}
},
"revenue_estimate": {
"previous_quarter": {
"analysts_number": "21",
"average_estimate": "75.20B",
"low_estimate": "73.50B",
"high_estimate": "77.80B",
"sales_last_year": "74.60B",
"growth_perc": "0.80%",
"date": "quarter3_23"
},
"current_quarter": {
"analysts_number": "20",
"average_estimate": "80.10B",
"low_estimate": "78.00B",
"high_estimate": "82.50B",
"sales_last_year": "76.90B",
"growth_perc": "4.16%",
"date": "quarter4_23"
},
"next_quarter": "",
"next_year": {
"analysts_number": "32",
"average_estimate": "340.50B",
"low_estimate": "330.00B",
"high_estimate": "350.00B",
"sales_last_year": "320.10B",
"growth_perc": "6.37%",
"year": "2024"
}
}
}
}
}Analyst List
Retrieve a list of tickers, analyst names, or firms.
Endpoint
https://apidata.fin2dev.com/v1/analystlist?key={YOUR_API_KEY}&list={LIST_TYPE}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| list * | string (query) | Type of list to retrieve: ‘ticker’, ‘analyst_name’, or ‘analyst_firm’. |
Example Request
https://apidata.fin2dev.com/v1/analystlist?key={YOUR_API_KEY}&list=analyst_nameExample Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"pagination": {
"total_data": "12345",
"total_pages": 13,
"current_page": 1
},
"output": [
{
"analyst_name": "emma_thompson"
}
]
}
}ETF Info
Retrieve key identifying information about an Exchange-Traded Fund (ETF), such as its ticker symbol, ISIN, series ID, and LEI.
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the ETF Holdings API (ETF Data API) page.
Endpoint
https://apidata.fin2dev.com/v1/etfinfo?key={YOUR_API_KEY}&cik={CIK}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| cik * | string (query) | SEC assigned CIK number of the main trust fund. |
| ticker | string (query) | Ticker of the ETF. |
| isin | string (query) | ISIN of the ETF. |
| series_id | string (query) | The ID of the ETF held by the fund. |
| series_lei | string (query) | The LEI of the ETF held by the fund. |
Example Request
https://apidata.fin2dev.com/v1/etfinfo?key={YOUR_API_KEY}&cik=0001579982&isin=US00214Q5009Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "ARK ETF Trust",
"file_number": "811-22883",
"cik": "0001579982",
"reg_lei": "2549000Z0EWMH3U0CQ16"
},
"output": [
{
"general": {
"fund_name": "ARK ETF Trust",
"cik": "0001579982",
"reg_lei": "2549000Z0EWMH3U0CQ16",
"country": "US",
"state": "US-FL",
"city": "St. Petersburg",
"zip": "33701",
"street": "200 Central Avenue",
"phone": "727-810-8160"
},
"0": {
"attributes": {
"series_name": "The 3D Printing ETF",
"series_id": "S000052298",
"series_lei": "2549004LVF58DT442303",
"ticker": "ARKF,ARKG,ARKK,ARKW,CTRU,IZRL,PRNT",
"isin": "US00214Q5009",
"date_report_period": "2022-10-31",
"end_report_period": "2023-07-31",
"final_filing": 0
},
"fund_info": {
"total_assets": "181250377.41",
"total_liabilities": "157684.66",
"net_assets": "181092692.75",
"assets_attr_misc_sec": "0.00000000",
"invested_assets": "0.00000000",
"one_yr_banks_borr": "0.00000000",
"one_yr_ctrld_comp": "0.00000000",
"one_yr_oth_affil": "0.00000000",
"one_yr_other": "0.00000000",
"aft_one_yr_banks_borr": "0.00000000",
"aft_one_yr_ctrld_comp": "0.00000000",
"aft_one_yr_oth_affil": "0.00000000",
"aft_one_yr_other": "0.00000000",
"delivery_delay": "0.00000000",
"standby_commit": "0.00000000",
"liquid_pref": "0.00000000",
"cash_not_reported_in_cor_d": "None",
"non_cash_collateral": "N",
"currency": "None"
}
}
}
]
}
}
ETF Returns
Returns or periodical returns of the ETF.
Endpoint
https://apidata.fin2dev.com/v1/etfreturns?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker | string (query) | Ticker of the ETF. |
| isin | string (query) | ISIN of the ETF. |
| series_id | string (query) | The ID of the ETF held by the fund. |
| series_lei | string (query) | The LEI of the ETF held by the fund. |
| date_from | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). |
| date_to | string (query) | End date of the reporting period (format: YYYY-MM-DD). |
Example Request
https://apidata.fin2dev.com/v1/etfreturns?key={YOUR_API_KEY}&ticker=ULVM&date_from=2025-01-01&date_to=2025-07-30Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "Victory Portfolios II",
"file_number": "811-22696",
"cik": "0001547580",
"reg_lei": "5493002SUQLUY3T5P040"
},
"output": [
{
"attributes": {
"series_name": "VictoryShares US Value Momentum ETF",
"series_id": "S000065156",
"series_lei": "5493006WYTPO22TMZG75",
"ticker": "ULVM",
"isin": "US92647N5766",
"date_report_period": "2025-03-31",
"end_report_period": "2025-06-30",
"final_filing": 0
},
"signature": {
"date_signed": "2025-04-30",
"name_of_applicant": "Victory Portfolios II",
"signature": "Carol Trevino",
"signer_name": "Carol Trevino",
"title": "Treasurer"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000210925",
"0": {
"rtn1": "5.04000000",
"rtn2": "-0.44000000",
"rtn3": "-4.20000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "0.00000000",
"net_unrealized_appreciation": "7306612.44000000"
},
"other_monthly2": {
"net_realized_gain": "-5.53000000",
"net_unrealized_appreciation": "-965413.36000000"
},
"other_monthly3": {
"net_realized_gain": "871105.71000000",
"net_unrealized_appreciation": "-7765329.48000000"
},
"month_1_flow": {
"redemption": "0.00000000",
"reinvestment": "0.00000000",
"sales": "0.00000000"
},
"month_2_flow": {
"redemption": "0.00000000",
"reinvestment": "0.00000000",
"sales": "0.00000000"
},
"month_3_flow": {
"redemption": "0.00000000",
"reinvestment": "0.00000000",
"sales": "0.00000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "-2566.00000000",
"net_unrealized_appreciation": "20845.00000000"
},
"month2": {
"net_realized_gain": "2379.00000000",
"net_unrealized_appreciation": "-15400.00000000"
},
"month3": {
"net_realized_gain": "-39454.50000000",
"net_unrealized_appreciation": "8535.00000000"
},
"future_category": {
"instrmon1": {
"net_realized_gain": "-2566.00000000",
"net_unrealized_appreciation": "20845.00000000"
},
"instrmon2": {
"net_realized_gain": "2379.00000000",
"net_unrealized_appreciation": "-15400.00000000"
},
"instrmon3": {
"net_realized_gain": "-39454.50000000",
"net_unrealized_appreciation": "8535.00000000"
}
}
}
}
}
}
]
}
}
ETF Holdings
Holding allocation and values of the ETF.
Endpoint
https://apidata.fin2dev.com/v1/etfholdings?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker | string (query) | Ticker of the ETF. |
| isin | string (query) | ISIN of the ETF. |
| series_id | string (query) | The ID of the ETF held by the fund. |
| series_lei | string (query) | The LEI of the ETF held by the fund. |
| date_from | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). |
| date_to | string (query) | End date of the reporting period (format: YYYY-MM-DD). |
Example Request
https://apidata.fin2dev.com/v1/etfholdings?key={YOUR_API_KEY}&ticker=ULVM&date_from=2025-01-01&date_to=2025-07-30Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "Victory Portfolios II",
"file_number": "811-22696",
"cik": "0001547580",
"reg_lei": "5493002SUQLUY3T5P040"
},
"output": [
{
"attributes": {
"series_name": "VictoryShares US Value Momentum ETF",
"series_id": "S000065156",
"series_lei": "5493006WYTPO22TMZG75",
"ticker": "ULVM",
"isin": "US92647N5766",
"date_report_period": "2025-03-31",
"end_report_period": "2025-06-30",
"final_filing": 0
},
"signature": {
"date_signed": "2025-04-30",
"name_of_applicant": "Victory Portfolios II",
"signature": "Carol Trevino",
"signer_name": "Carol Trevino",
"title": "Treasurer"
},
"holdings": [
{
"investment_security": {
"name": "Truist Financial Corporation",
"lei": "549300DRQQI75D2JP341",
"isin": "US89832Q1094",
"title": "TRUIST FINANCIAL CORP",
"cusip": "89832Q109",
"balance": "27240.00000000",
"units": "NS",
"currency": "USD",
"value_usd": "1120926.00000000",
"percent_value": "0.754819706865",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "TAPESTRY, INC.",
"lei": "549300LJNVY5SW3VTN33",
"isin": "US8760301072",
"title": "TAPESTRY INC",
"cusip": "876030107",
"balance": "10268.00000000",
"units": "NS",
"currency": "USD",
"value_usd": "722969.88000000",
"percent_value": "0.486840266792",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "INTEL CORPORATION",
"lei": "KNX4USFCNGPY45LOCE31",
"isin": "US4581401001",
"title": "INTEL CORP",
"cusip": "458140100",
"balance": "23805.00000000",
"units": "NS",
"currency": "USD",
"value_usd": "540611.55000000",
"percent_value": "0.364042097069",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},....
}
}
}
ETF List
List endpoint to get all ETFs currently supported.
Endpoint
https://apidata.fin2dev.com/v1/etflist?key={YOUR_API_KEY}&list=ticker
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| list * | string (query) | Choose isin, ticker, reg_lei or cik. |
Example Request
https://apidata.fin2dev.com/v1/etflist?key={YOUR_API_KEY}&list=isinExample Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"pagination": {
"total_data": "48560",
"total_pages": 49,
"current_page": 1
},
"output": [
{
"isin": " US00123Q8722"
},
{
"isin": " US257559AK07"
},
{
"isin": " US31846V3362"
},
{
"isin": " US67058H3003"
},
{
"isin": "AEA000201011"
},
{
"isin": "AEA001201010"
},
{
"isin": "AEA002001013"
},
{
"isin": "AEA002301017"
},....
}
}
Bonds
API of yield returns of bonds of different countries, regions and time periods. When the yield type is not specified, the default is 10y.
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Bonds API (Government Bond Yields API) page.
Endpoint
https://apidata.fin2dev.com/v1/bonds?key=YOUR_API_KEY&country=us&type=10y
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| country | string (query) | Specify the country of the bond yield data. |
| region | string (query) | Region or continent for the bond yield data, returns all countries in the given region. |
| type | string (query) | The bond yield type; for example, 3m, 6m, 5y, 10y, 20y, 10y_TIPs, etc. |
Example Request
https://apidata.fin2dev.com/v1/bonds?key=YOUR_API_KEY®ion=europe&type=2yExample Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"region": "europe",
"country": "belgium",
"type": "2y",
"yield": "2.04",
"price_change_day": "-0.028%",
"percentage_week": "",
"percentage_month": "0.013%",
"percentage_year": "-0.508%",
"datetime": "2025-08-26T00:00:00.000"
},
{
"region": "europe",
"country": "switzerland",
"type": "2y",
"yield": "-0.11",
"price_change_day": "-0.029%",
"percentage_week": "",
"percentage_month": "0.031%",
"percentage_year": "-0.663%",
"datetime": "2025-08-26T00:00:00.000"
},
{
"region": "europe",
"country": "germany",
"type": "2y",
"yield": "1.95",
"price_change_day": "-0.025%",
"percentage_week": "",
"percentage_month": "0.050%",
"percentage_year": "-0.444%",
"datetime": "2025-08-26T00:00:00.000"
},....
}
}
Historical Bond Yields
Focuses on government bonds worldwide and returns historical yield price data based on daily or monthly intervals optionally.
Endpoint
https://apidata.fin2dev.com/v1/bondshistorical?key=YOUR_API_KEY&country=germany&type=2y
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| country * | string (query) | Bond country to be requested |
| type | string (query) | Yield type (e.g., 6m, 52w, 2y, 10y, 10_tips, 20y, etc.) |
| frequency | string (query) | Interval of historical data (day or month). Default is day. |
| date_from | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). |
| date_to | string (query) | End date of the reporting period (format: YYYY-MM-DD). |
Example Request
https://apidata.fin2dev.com/v1/bondshistorical?key=YOUR_API_KEY&country=germany&type=2y&date_from=2010-01-01&date_to=2010-01-10Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"frequency": "1d"
},
"output": {
"region": "europe",
"country": "Germany",
"bond_type": "2y",
"prices": [
{
"price": "1.251",
"date_time": "2010-01-08"
},
{
"price": "1.293",
"date_time": "2010-01-07"
},
{
"price": "1.321",
"date_time": "2010-01-06"
},
{
"price": "1.311",
"date_time": "2010-01-05"
},
{
"price": "1.366",
"date_time": "2010-01-04"
},
{
"price": "1.323",
"date_time": "2010-01-01"
}
]
}
}
}
Commodity Prices API
Get price and price forecast data of energy, metals, industrial, agricultural and livestock commodities.
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Commodity Prices API (Commodities Price API) page.
Endpoint
https://apidata.fin2dev.com/v1/commodities?key={YOUR_API_KEY}&commodity_name={COMMODITY_NAME}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| commodity_name * | string (query) | The name of the commodity for price data (one commodity can be requested at a time). |
Example Request
https://apidata.fin2dev.com/v1/commodities?key={YOUR_API_KEY}&commodity_name=crude_oilExample Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"commodity_name": "crude oil",
"commodity_unit": "usd/bbl",
"commodity_price": "63.72",
"price_change_day": "-1.08",
"percentage_day": "-1.67%",
"percentage_week": "3.14%",
"percentage_month": "-4.50%",
"percentage_year": "-15.65%",
"quarter3_25": "65.647",
"quarter4_25": "67.644",
"quarter1_26": "63.848",
"datetime": "2025-08-26T11:23:00.000"
}
]
}
}
Economic Calendar API (Macroeconomic Calendar API)
The Economic Calendar API provides automated access to a curated list of significant international macroeconomic events. These events, detailed in the calendar, are anticipated to influence the global economy, financial markets, and the valuation of assets in real-time.
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Economic Calendar API (Macroeconomic Calendar API) page.
Endpoint
https://apidata.fin2dev.com/v1/macrocalendar?key={YOUR_API_KEY}&country={COUNTRY}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| country | string (query) | The country name of macroeconomic event data to be requested. |
| iso_country_code | string (query) | Two-letter ISO country code. |
| date | string (query) | Specifies the target date for retrieving macroeconomic events. |
| date_from PRO | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). Available in PRO plans |
| date_to PRO | string (query) | End date of the reporting period (format: YYYY-MM-DD). Available in PRO plans |
Example Request
https://apidata.fin2dev.com/v1/macrocalendar?key={YOUR_API_KEY}&country=United_Kingdom&date=2024-01-19Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"datetime": "2024-01-19 07:00:00",
"iso_country_code": "GB",
"country": "United Kingdom",
"report_name": "Retail Sales MoM",
"report_date": "12",
"actual": "-3.2",
"previous": "1.4",
"consensus": "-0.5",
"unit": "percent",
"impact": "1"
},
{
"datetime": "2024-01-19 07:00:00",
"iso_country_code": "GB",
"country": "United Kingdom",
"report_name": "Retail Sales ex Fuel MoM",
"report_date": "12",
"actual": "-3.3",
"previous": "1.5",
"consensus": "-0.6",
"unit": "percent",
"impact": "2"
},
{
"datetime": "2024-01-19 07:00:00",
"iso_country_code": "GB",
"country": "United Kingdom",
"report_name": "Retail Sales YoY",
"report_date": "12",
"actual": "-2.4",
"previous": "0.2",
"consensus": "1.1",
"unit": "percent",
"impact": "2"
},
{
"datetime": "2024-01-19 07:00:00",
"iso_country_code": "GB",
"country": "United Kingdom",
"report_name": "Retail Sales ex Fuel YoY",
"report_date": "12",
"actual": "-2.1",
"previous": "0.5",
"consensus": " ",
"unit": "percent",
"impact": "3"
}
]
}
}
Economic (Macroeconomic) Calendar country list
List of supported countries.
Endpoint
https://apidata.fin2dev.com/v1/macrolist?key={YOUR_API_KEY}&list={country}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| list * | string (query) | Use the ‘list=country’ parameter to retrieve a comprehensive list of countries we have data about. |
Example Request
https://apidata.fin2dev.com/v1/macrolist?key={YOUR_API_KEY}&list=countryExample Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"pagination": {
"total_data": "143",
"total_pages": 1,
"current_page": 1
},
"output": [
{
"country": "Afghanistan"
},
{
"country": "Albania"
},
{
"country": "Algeria"
},
{
"country": "Angola"
},
{
"country": "Argentina"
},
{
"country": "Armenia"
},....
Economic Data API (Macroeconomic Data API)
Macroeconomic Data API provides real-time data from reliable sources on the most important macroeconomic indicators from 196 countries, such as GDP, inflation, industrial production, unemployment, trade balances, demographic trends and much more.
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Economic Data API (Macroeconomic Data API) page.
Endpoint
https://apidata.fin2dev.com/v1/macroindicator?key={YOUR_API_KEY}&country={COUNTRY}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| country | string (query) | Country for the macroeconomic indicator data. |
| report_name | string (query) | Returns a specific macroeconomic indicator or report. |
| iso_country_code | string (query) | Two-letter ISO country code. |
Example Request
https://apidata.fin2dev.com/v1/macroindicator?key={YOUR_API_KEY}&iso_country_code=gbExample Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"report_name": "Electric Car Registrations",
"previous": "47354",
"actual": "32738",
"unit": "Units",
"report_date": "2025-06"
},
{
"report_name": "Business Confidence",
"previous": "-27",
"actual": "-33",
"unit": "points",
"report_date": "2025-09"
},
{
"report_name": "Manufacturing PMI",
"previous": "47.3",
"actual": "48",
"unit": "points",
"report_date": "2025-08"
},...
Company Identification
Different endpoint examples are provided with the Json response for it. You can combine various Parameters to filter the response. See below also the description of all parameter and response objects. .
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Stock and Company Identification API page.
Endpoint
https://apidata.fin2dev.com/v1/identifiers?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker | string (query) | The ticker symbol of the company. |
| cik | string (query) | The CIK number of the company as assigned by the SEC. |
| isin | string (query) | The ISIN of the company. |
| cusip | string (query) | The CUSIP of the company. |
Example Request
https://apidata.fin2dev.com/v1/identifiers?key={YOUR_API_KEY}&isin=US0378331005Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company": "Apple Inc.",
"ticker": "AAPL",
"isin": "US0378331005"
},
"output": {
"name": "Apple Inc.",
"ticker": "AAPL",
"cik": "320193",
"isin": "US0378331005",
"cusip": "037833100",
"ein_employer_id": "942404110",
"lei": "HWUPKR0MPOU8FGXBT394",
"series_id": "",
"item_type": "equity",
"sector": "Technology",
"industry": "Consumer Electronics",
"sic_code": "3571",
"sic_name": "Electronic Computers",
"previous_names": [
{
"name": "APPLE INC",
"from": "2007-01-10"
},
{
"name": "APPLE COMPUTER INC/ FA",
"from": "1997-07-28"
},
{
"name": "APPLE COMPUTER INC",
"from": "1994-01-26"
}
]
}
}
}
Company Information
Different endpoint examples are provided with the Json response for it. You can combine various Parameters to filter the response. See below also the description of all parameter and response objects.
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Company Information API page.
Endpoint
https://apidata.fin2dev.com/v1/information?key={YOUR_API_KEY}&cik={CIK}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker | string (query) | The ticker symbol of the company. |
| cik | string (query) | The CIK number of the company as assigned by the SEC. |
| isin | string (query) | The ISIN of the company. |
| cusip | string (query) | The CUSIP of the company. |
Example Request
https://apidata.fin2dev.com/v1/information?key={YOUR_API_KEY}&cusip=037833100Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company": "Apple Inc.",
"ticker": "AAPL",
"isin": "US0378331005",
"sector": "Technology",
"industry": "Consumer Electronics"
},
"output": {
"name": "Apple Inc.",
"ticker": "AAPL",
"cik": "320193",
"isin": "US0378331005",
"cusip": "037833100",
"ein_employer_id": "942404110",
"lei": "HWUPKR0MPOU8FGXBT394",
"series_id": "",
"item_type": "equity",
"sector": "Technology",
"industry": "Consumer Electronics",
"sic_code": "3571",
"sic_name": "Electronic Computers",
"exchange_code": "NMS",
"exchanges": [
{
"exchange_name": "Investors Exchange",
"acronym1": "IEX",
"exchange_mic": "IEXG",
"country": "USA",
"alpha2_code": "US",
"city": "New York",
"website": "www.iextrading.com"
},
{
"exchange_name": "NASDAQ - ALL MARKETS",
"acronym1": "NASDAQ",
"exchange_mic": "XNAS",
"country": "",
"alpha2_code": "US",
"city": "NEW YORK",
"website": "www.nasdaq.com"
},
{
"exchange_name": "NASDAQ Stock Exchange",
"acronym1": "NASDAQ",
"exchange_mic": "XNAS",
"country": "USA",
"alpha2_code": "US",
"city": "New York",
"website": "www.nasdaq.com"
}
],
"full_time_employees": "164000",
"ipo_date": "",
"date_founded": "",
"key_executives": [
{
"name": "Mr. Greg Joswiak",
"function": "Senior Vice President of Worldwide Marketing",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Kristin Huguet Quayle",
"function": "Vice President of Worldwide Communications",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Suhasini Chandramouli",
"function": "Director of Investor Relations",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. Chris Kondo",
"function": "Senior Director of Corporate Accounting",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. Sabih Khan",
"function": "Chief Operating Officer",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. Jeffrey E. Williams",
"function": "Senior Vice President of Design, Watch, & Health",
"salary": "5.02M",
"exercised": "",
"birth_year": "1964"
},
{
"name": "Ms. Deirdre O'Brien",
"function": "Chief People Officer & Senior VP of Retail",
"salary": "5.02M",
"exercised": "",
"birth_year": "1967"
},
{
"name": "Ms. Katherine L. Adams",
"function": "Senior VP, General Counsel & Secretary",
"salary": "5.02M",
"exercised": "",
"birth_year": "1964"
},
{
"name": "Ms. Ann Thai",
"function": "Director of Product Management for the App Store",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Jennifer Bailey",
"function": "Vice President of Pay",
"salary": "",
"exercised": "",
"birth_year": "1963"
},
{
"name": "Mr. Wyatt Mitchell",
"function": "Director of App Design",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. Kevin M. Lynch",
"function": "Vice President of Technology",
"salary": "",
"exercised": "",
"birth_year": "1967"
},
{
"name": "Mr. Roger Rosner",
"function": "Vice President of Applications",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ashish Chowdhary",
"function": "Head of Indian Business",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. Matthew Cherniss",
"function": "Head of Programming for Apple TV+",
"salary": "",
"exercised": "",
"birth_year": "1973"
},
{
"name": "Molly Thompson",
"function": "Head of Documentaries for Apple TV+",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Deirdre O'Brien",
"function": "Chief People Officer & Senior VP of Retail",
"salary": "5.02M",
"exercised": "",
"birth_year": "1967"
},
{
"name": "Ms. Katherine L. Adams",
"function": "Senior VP, General Counsel & Secretary",
"salary": "5.02M",
"exercised": "",
"birth_year": "1964"
},
{
"name": "Mr. Jeffrey E. Williams",
"function": "Chief Operating Officer",
"salary": "5.02M",
"exercised": "",
"birth_year": "1964"
},
{
"name": "Mr. Timothy D. Cook",
"function": "CEO & Director",
"salary": "16.52M",
"exercised": "",
"birth_year": "1961"
},
{
"name": "Mr. Adrian Perica",
"function": "Vice President of Corporate Development",
"salary": "",
"exercised": "",
"birth_year": "1974"
},
{
"name": "Ms. Kristin Huguet Quayle",
"function": "Vice President of Worldwide Communications",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. Kevan Parekh",
"function": "Senior VP & CFO",
"salary": "",
"exercised": "",
"birth_year": "1972"
},
{
"name": "Mr. Michael Fenger",
"function": "VP of Worldwide Sales",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Deirdre O'Brien",
"function": "Chief People Officer & Senior VP of Retail",
"salary": "4.61M",
"exercised": "",
"birth_year": "1967"
},
{
"name": "Mr. Adrian Perica",
"function": "Head of Corporate Development",
"salary": "",
"exercised": "",
"birth_year": "1974"
},
{
"name": "Mr. Greg Joswiak",
"function": "Senior Vice President of Worldwide Marketing",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Suhasini Chandramouli",
"function": "Director of Investor Relations",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Deirdre O'Brien",
"function": "Senior Vice President of Retail",
"salary": "4.61M",
"exercised": "",
"birth_year": "1967"
},
{
"name": "Ms. Katherine L. Adams",
"function": "Senior VP, General Counsel & Secretary",
"salary": "4.62M",
"exercised": "",
"birth_year": "1964"
},
{
"name": "Mr. Jeffrey E. Williams",
"function": "Chief Operating Officer",
"salary": "4.64M",
"exercised": "",
"birth_year": "1964"
},
{
"name": "Mr. Luca Maestri",
"function": "CFO & Senior VP",
"salary": "4.61M",
"exercised": "",
"birth_year": "1963"
},
{
"name": "Mr. Timothy D. Cook",
"function": "CEO & Director",
"salary": "16.24M",
"exercised": "",
"birth_year": "1961"
},
{
"name": "Suhasini Chandramouli",
"function": "Director of Investor Relations",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. Greg Joswiak",
"function": "Senior Vice President of Worldwide Marketing",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Nancy Paxton",
"function": "Senior Director of Investor Relations & Treasury",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. Chris Kondo",
"function": "Senior Director of Corporate Accounting",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Deirdre O'Brien",
"function": "Senior Vice President of Retail",
"salary": "5.02M",
"exercised": "",
"birth_year": "1967"
},
{
"name": "Ms. Katherine L. Adams",
"function": "Senior VP, General Counsel & Secretary",
"salary": "5.02M",
"exercised": "",
"birth_year": "1964"
},
{
"name": "Mr. Luca Maestri",
"function": "CFO & Senior VP",
"salary": "5.02M",
"exercised": "",
"birth_year": "1963"
},
{
"name": "Mr. Greg Joswiak",
"function": "Sr. VP of Worldwide Marketing",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Nancy Paxton",
"function": "Sr. Director of Investor Relations & Treasury",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Mary Demby",
"function": "Chief Information Officer",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. James Wilson",
"function": "Chief Technology Officer",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Mr. Chris Kondo",
"function": "Sr. Director of Corp. Accounting",
"salary": "",
"exercised": "",
"birth_year": ""
},
{
"name": "Ms. Deirdre O'Brien",
"function": "Sr. VP of Retail",
"salary": "5.02M",
"exercised": "",
"birth_year": "1967"
},
{
"name": "Ms. Katherine L. Adams",
"function": "Sr. VP, Gen. Counsel & Sec.",
"salary": "5.02M",
"exercised": "",
"birth_year": "1964"
},
{
"name": "Mr. Jeffrey E. Williams",
"function": "Chief Operating Officer",
"salary": "5.02M",
"exercised": "",
"birth_year": "1964"
},
{
"name": "Mr. Luca Maestri",
"function": "CFO & Sr. VP",
"salary": "5.02M",
"exercised": "",
"birth_year": "1963"
},
{
"name": "Mr. Timothy D. Cook",
"function": "CEO & Director",
"salary": "16.43M",
"exercised": "",
"birth_year": "1961"
}
],
"incorporation": "CA",
"incorporation_description": "CA",
"start_fiscal": "",
"end_fiscal": "0930",
"reporting_currency": "",
"address": {
"street1": "ONE APPLE PARK WAY",
"street2": "",
"city": "CUPERTINO",
"stateOrCountry": "CA",
"postal_code": "95014",
"state_or_country_description": "CA"
},
"post_address": {
"street1": "ONE APPLE PARK WAY",
"street2": "",
"city": "CUPERTINO",
"stateOrCountry": "CA",
"postal_code": "95014",
"state_or_country_description": "CA"
},
"phone": "(408) 996-1010",
"website": "https://www.apple.com",
"previous_names": [
{
"name": "APPLE INC",
"from": "2007-01-10"
},
{
"name": "APPLE COMPUTER INC/ FA",
"from": "1997-07-28"
},
{
"name": "APPLE COMPUTER INC",
"from": "1994-01-26"
}
],
"about": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide. The company offers iPhone, a line of smartphones; Mac, a line of personal computers; iPad, a line of multi-purpose tablets; and wearables, home, and accessories comprising AirPods, Apple TV, Apple Watch, Beats products, and HomePod. It also provides AppleCare support and cloud services; and operates various platforms, including the App Store that allow customers to discover and download applications and digital content, such as books, music, video, games, and podcasts. In addition, the company offers various services, such as Apple Arcade, a game subscription service; Apple Fitness+, a personalized fitness service; Apple Music, which offers users a curated listening experience with on-demand radio stations; Apple News+, a subscription news and magazine service; Apple TV+, which offers exclusive original content; Apple Card, a co-branded credit card; and Apple Pay, a cashless payment service, as well as licenses its intellectual property. The company serves consumers, and small and mid-sized businesses; and the education, enterprise, and government markets. It distributes third-party applications for its products through the App Store. The company also sells its products through its retail and online stores, and direct sales force; and third-party cellular network carriers, wholesalers, retailers, and resellers. Apple Inc. was incorporated in 1977 and is headquartered in Cupertino, California.",
"mission": "",
"vision": ""
}
}
}
Income Statement API list
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Financial Statements API page.
Endpoint
https://apidata.fin2dev.com/v1/statementslist?key={YOUR_API_KEY}&list=ticker
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| list * | string (query) | Use the ‘list=ticker’ parameter to retrieve a comprehensive list of all available tickers. |
| page | string (query) | The page filter is used to specify which segment of a paginated dataset to retrieve. |
Example Request
https://apidata.fin2dev.com/v1/statementslist?key={YOUR_API_KEY}&list=ticker&page=7Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"pagination": {
"total_data": "119038",
"total_pages": 120,
"current_page": 7
},
"output": [
{
"ticker": "0005.HK"
},
{
"ticker": "0083.KL"
},
{
"ticker": "0933.HK"
},
{
"ticker": "1023.KL"
},
{
"ticker": "1066.KL"
},
{
"ticker": "1278.HK"
},
{
"ticker": "1589.KL"
},...
}
}
Income Statement API
You can combine a lot of parameters to get very customized results. For example if you want to compare all Cost of sales and Gross Profit and other components of the income statement of all companies within the technology sector in the consumer electronics industry, this is possible. On top of that, you can choose the years and quarters for which you want these results.
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Income Statement API page.
Endpoint
https://apidata.fin2dev.com/v1/incomestatements?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker | string (query) | The ticker symbol of the company. |
| type | string (query) | Select one of the available options: year, quarter, ttm (trailing twelve months). |
| date_from | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). |
| date_to | string (query) | End date of the reporting period (format: YYYY-MM-DD). |
Example Request
https://apidata.fin2dev.com/v1/incomestatements?key={YOUR_API_KEY}&ticker=AAPL&type=quarter&date_from=2024-04-31&date_to=2024-06-31Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"ticker": "AAPL",
"period": "quarterly"
},
"output": {
"income_statement": [
{
"date": "2024-06-30",
"basic_average_shares": "15287521000",
"basic_eps": "1.4",
"cost_of_revenue": "46099000000",
"diluted_average_shares": "15348175000",
"diluted_eps": "1.4",
"diluted_niavailto_com_stockholders": "21448000000",
"ebit": "25352000000",
"ebitda": "28202000000",
"gross_profit": "39678000000",
"net_income": "21448000000",
"net_income_common_stockholders": "21448000000",
"net_income_continuous_operations": "21448000000",
"net_income_from_continuing_and_discontinued_operation": "21448000000",
"net_income_from_continuing_operation_net_minority_interest": "21448000000",
"net_income_including_noncontrolling_interests": "21448000000",
"normalized_ebitda": "28202000000",
"normalized_income": "21448000000",
"operating_expense": "14326000000",
"operating_income": "25352000000",
"operating_revenue": "85777000000",
"other_income_expense": "142000000",
"other_non_operating_income_expenses": "142000000",
"pretax_income": "25494000000",
"reconciled_cost_of_revenue": "46099000000",
"reconciled_depreciation": "2850000000",
"research_and_development": "8006000000",
"selling_general_and_administration": "6320000000",
"tax_effect_of_unusual_items": "0",
"tax_provision": "4046000000",
"tax_rate_for_calcs": "0.159",
"total_expenses": "60425000000",
"total_operating_income_as_reported": "25352000000",
"total_revenue": "85777000000"
}
]
}
}
}
Balance Sheet API
You can combine a lot of parameters to get very customized results. For example if you want to compare all Assets and Liabilities and other components of the Balance Sheet of all companies within the technology sector in the consumer electronics industry, this is possible. On top of that, you can choose the years and quarters for which you want these results.
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Balance Sheet API page.
Endpoint
https://apidata.fin2dev.com/v1/balancesheets?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker | string (query) | The ticker symbol of the company. |
| type | string (query) | Select one of the available options: year, quarter, ttm (trailing twelve months). |
| date_from | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). |
| date_to | string (query) | End date of the reporting period (format: YYYY-MM-DD). |
Example Request
https://apidata.fin2dev.com/v1/balancesheets?key={YOUR_API_KEY}&ticker=AAPL&type=year&date_from=2023-07-31&date_to=2023-09-31Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"ticker": "AAPL",
"period": "annual"
},
"output": {
"balance_sheet": [
{
"date": "2023-09-30 00:00:00",
"accounts_payable": "62611000000",
"accounts_receivable": "29508000000",
"accumulated_depreciation": "-70884000000",
"available_for_sale_securities": "100544000000",
"capital_lease_obligations": "12842000000",
"capital_stock": "73812000000",
"cash_and_cash_equivalents": "29965000000",
"cash_cash_equivalents_and_short_term_investments": "61555000000",
"cash_equivalents": "1606000000",
"cash_financial": "28359000000",
"commercial_paper": "5985000000",
"common_stock": "73812000000",
"common_stock_equity": "62146000000",
"current_assets": "143566000000",
"current_capital_lease_obligation": "1575000000",
"current_debt": "15807000000",
"current_debt_and_capital_lease_obligation": "15807000000",
"current_deferred_liabilities": "8061000000",
"current_deferred_revenue": "8061000000",
"current_liabilities": "145308000000",
"gains_losses_not_affecting_retained_earnings": "-11452000000",
"gross_ppe": "114599000000",
"income_tax_payable": "8819000000",
"inventory": "6331000000",
"invested_capital": "173234000000",
"investmentin_financial_assets": "100544000000",
"investments_and_advances": "100544000000",
"land_and_improvements": "23446000000",
"leases": "12839000000",
"long_term_capital_lease_obligation": "11267000000",
"long_term_debt": "95281000000",
"long_term_debt_and_capital_lease_obligation": "95281000000",
"machinery_furniture_equipment": "78314000000",
"net_debt": "81123000000",
"net_ppe": "43715000000",
"net_tangible_assets": "62146000000",
"non_current_deferred_assets": "17852000000",
"non_current_deferred_taxes_assets": "17852000000",
"ordinary_shares_number": "15550061000",
"other_current_assets": "14695000000",
"other_current_borrowings": "9822000000",
"other_current_liabilities": "50010000000",
"other_equity_adjustments": "-11452000000",
"other_non_current_assets": "46906000000",
"other_non_current_liabilities": "34391000000",
"other_properties": "10661000000",
"other_receivables": "31477000000",
"other_short_term_investments": "31590000000",
"payables": "71430000000",
"payables_and_accrued_expenses": "71430000000",
"properties": "0",
"receivables": "60985000000",
"retained_earnings": "-214000000",
"share_issued": "15550061000",
"stockholders_equity": "62146000000",
"tangible_book_value": "62146000000",
"total_assets": "352583000000",
"total_capitalization": "157427000000",
"total_debt": "111088000000",
"total_equity_gross_minority_interest": "62146000000",
"total_liabilities_net_minority_interest": "290437000000",
"total_non_current_assets": "209017000000",
"total_non_current_liabilities_net_minority_interest": "145129000000",
"total_tax_payable": "8819000000",
"tradeand_other_payables_non_current": "15457000000",
"treasury_shares_number": "0",
"working_capital": "-1742000000"
}
]
}
}
}
Cash Flow Statement API
You can combine a lot of parameters to get very customized results. For example if you want to compare all Operating Cashflow and Capital Expenditure and other components of the income statement of all companies within the technology sector in the consumer electronics industry, this is possible. On top of that, you can choose the years and quarters for which you want these results.
Endpoint
https://apidata.fin2dev.com/v1/cashflows?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker | string (query) | The ticker symbol of the company. |
| type | string (query) | Select one of the available options: year, quarter, ttm (trailing twelve months). |
| date_from | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). |
| date_to | string (query) | End date of the reporting period (format: YYYY-MM-DD). |
Example Request
https://apidata.fin2dev.com/v1/cashflows?key={YOUR_API_KEY}ticker=AAPL&type=quarter&date_from=2024-11-31&date_to=2024-12-31Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"ticker": "AAPL",
"period": "quarterly"
},
"output": {
"cash_flow": [
{
"date": "2024-06-30 00:00:00",
"beginning_cash_position": "33921000000",
"capital_expenditure": "-2151000000",
"cash_dividends_paid": "-3895000000",
"cash_flow_from_continuing_financing_activities": "-36017000000",
"cash_flow_from_continuing_investing_activities": "-127000000",
"cash_flow_from_continuing_operating_activities": "28858000000",
"change_in_account_payable": "1539000000",
"change_in_inventory": "-12000000",
"change_in_other_current_assets": "-1188000000",
"change_in_other_current_liabilities": "3439000000",
"change_in_payable": "1539000000",
"change_in_payables_and_accrued_expense": "1539000000",
"change_in_receivables": "-2094000000",
"change_in_working_capital": "1684000000",
"changes_in_account_receivables": "-1030000000",
"changes_in_cash": "-7286000000",
"common_stock_dividend_paid": "-3895000000",
"common_stock_payments": "-26522000000",
"depreciation_amortization_depletion": "2850000000",
"depreciation_and_amortization": "2850000000",
"end_cash_position": "26635000000",
"financing_cash_flow": "-36017000000",
"free_cash_flow": "26707000000",
"income_tax_paid_supplemental_data": "4699000000",
"investing_cash_flow": "-127000000",
"long_term_debt_payments": "-4250000000",
"net_common_stock_issuance": "-26522000000",
"net_income_from_continuing_operations": "21448000000",
"net_investment_purchase_and_sale": "2412000000",
"net_issuance_payments_of_debt": "-3253000000",
"net_long_term_debt_issuance": "-4250000000",
"net_other_financing_charges": "-2347000000",
"net_other_investing_changes": "-388000000",
"net_ppepurchase_and_sale": "-2151000000",
"net_short_term_debt_issuance": "997000000",
"operating_cash_flow": "28858000000",
"other_non_cash_items": "7000000",
"purchase_of_investment": "-13032000000",
"purchase_of_ppe": "-2151000000",
"repayment_of_debt": "-3253000000",
"repurchase_of_capital_stock": "-26522000000",
"sale_of_investment": "15444000000",
"short_term_debt_payments": "997000000",
"stock_based_compensation": "2869000000"
}
]
}
}
}
Historical Dividends list
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Historical Dividends API page.
Endpoint
https://apidata.fin2dev.com/v1/dividendslist?key={YOUR_API_KEY}&list=ticker
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| list * | string (query) | Use the ‘list=ticker’ parameter to retrieve a comprehensive list of all available tickers. |
| page | string (query) | The page filter is used to specify which segment of a paginated dataset to retrieve. |
Example Request
https://apidata.fin2dev.com/v1/dividendslist?key={YOUR_API_KEY}&list=ticker&page=15Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"pagination": {
"total_data": "170921",
"total_pages": 171,
"current_page": 15
},
"output": [
{
"ticker": "HUFV-A.ST"
},
{
"ticker": "0147.HK"
},
{
"ticker": "IHEVA.IS"
},
{
"ticker": "AWT.F"
},
{
"ticker": "0146.HK"
},
{
"ticker": "0136.HK"
},
{
"ticker": "AOC.SG"
},
{
"ticker": "0127.HK"
},
{
"ticker": "9ME.MU"
},
{
"ticker": "AWN.SG"
},
{
"ticker": "LOIMY"
},
{
"ticker": "0125.HK"
},
{
"ticker": "ABT.OL"
},
{
"ticker": "0110.HK"
},
{
"ticker": "ABE.VI"
},
{
"ticker": "0106.HK"
},
{
"ticker": "A1OS.SG"
},
{
"ticker": "AWC.SI"
},
{
"ticker": "0102.HK"
},
{
"ticker": "2674.KL"
},
{
"ticker": "AWE.F"
},...
}
}
Historical Dividends
Dividends API that gives clear and detailed account of public companies and their respective dividend-paying stocks. The API works well with the Financial Statements Report API as the data is constantly tracked and updated in both the historical dividend database and the financial statements report database.
Endpoint
https://apidata.fin2dev.com/v1/dividends?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker | string (query) | The ticker symbol of the company. |
| download | string (query) | You can download the data in json format with this parameter. &download= |
| date_from | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). |
| date_to | string (query) | End date of the reporting period (format: YYYY-MM-DD). |
Example Request
https://apidata.fin2dev.com/v1/dividends?key={YOUR_API_KEY}&ticker=AAPL&date_from=2023-09-20&date_to=2023-12-20Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"ticker": "AAPL"
},
"output": {
"dividends": [
{
"dividend_rate": "0.24",
"date": "2023-11-10"
}
]
}
}
}
Historical Candlestick list
API Overview & Features
Learn more about features, data coverage, historical data, use cases, pricing, and integration examples on the Historical Candlestick API (OHLC Data API) page.
Endpoint
https://apidata.fin2dev.com/v1/candlesticklist?key={YOUR_API_KEY}&list=ticker
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| list * | string (query) | Use the ‘list=ticker’ parameter to retrieve a comprehensive list of all available tickers. |
| page | string (query) | The page filter is used to specify which segment of a paginated dataset to retrieve. |
Example Request
https://apidata.fin2dev.com/v1/candlesticklist?key={YOUR_API_KEY}&list=ticker&page=11Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"pagination": {
"total_data": "646931",
"total_pages": 647,
"current_page": 11
},
"output": [
{
"ticker": "0003.HK"
},
{
"ticker": "0004.HK"
},
{
"ticker": "0006.HK"
},
{
"ticker": "0008.HK"
},
{
"ticker": "0011.HK"
},
{
"ticker": "0016.HK"
},
{
"ticker": "0017.HK"
},
{
"ticker": "0020.HK"
},...
}
}
Historical Candlestick
Historical Candlestick API provides historical candlestick data for stocks and other assets.
Endpoint
https://apidata.fin2dev.com/v1/historicalcandlestick?key={YOUR_API_KEY}&ticker={TICKER}
Parameters
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| ticker | string (query) | The ticker symbol of the company. |
| download | string (query) | You can download the data in json format with this parameter. &download= |
| date_from | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). |
| date_to | string (query) | End date of the reporting period (format: YYYY-MM-DD). |
Example Request
https://apidata.fin2dev.com/v1/historicalcandlestick?key={YOUR_API_KEY}&ticker=AAPL&date_from=2022-03-20&date_to=2022-03-23Example Response
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"ticker": "AAPL",
"date_start": "2022-03-23",
"date_end": "2022-03-21"
},
"output": {
"daily_stock_data": [
{
"date": "2022-03-23",
"opentime": 1648027800,
"open": "167.990005493164",
"high": "172.639999389648",
"low": "167.649993896484",
"close": "170.210006713867",
"closetime": 1648051200,
"adjusted_close": "169.185134887695",
"trade_volume": "98062700",
"stock_split": "",
"dividend_rate": ""
},
{
"date": "2022-03-22",
"opentime": 1647941400,
"open": "165.509994506836",
"high": "169.419998168945",
"low": "164.910003662109",
"close": "168.820007324219",
"closetime": 1647964800,
"adjusted_close": "167.803497314453",
"trade_volume": "81532000",
"stock_split": "",
"dividend_rate": ""
},
{
"date": "2022-03-21",
"opentime": 1647855000,
"open": "163.509994506836",
"high": "166.350006103516",
"low": "163.009994506836",
"close": "165.380004882812",
"closetime": 1647878400,
"adjusted_close": "164.384216308594",
"trade_volume": "95811400",
"stock_split": "",
"dividend_rate": ""
}
]
}
}
}