Documentation
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.Â
https://finnworlds.com/api/v1/identifiers
?key=YOUR-KEY
&stock_ticker_symbol=aapl
{
"status": {
"message": "Success"
},
"results": [
{
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"cik_code": "0000320193"
"cusip_number": "037833100"
"employer_id": "942404110"
"exchange": "nasdaq"
"ipo_date": "1980:11:12"
"founded_date": "1976:04:01"
"industry": "technology"
"sector": "consumer electronics"
}
[
}
https://finnworlds.com/api/v1/identifiers
?key=YOUR-KEY
&stock_ticker_symbol=aapl,fb
{
"status": {
"message": "Success"
},
"results": [
{
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"cik_code": "0000320193"
"cusip_number": "037833100"
"employer_id": "942404110"
"exchange": "nasdaq"
"ipo_date": "1980:11:12"
"founded_date": "1976:04:01"
"industry": "technology"
"sector": "consumer electronics"
},
"name": "Facebook, Inc",
"stock_ticker_symbol": "FB"
"isin_identifier": "US30303M1027"
"cik_code": "0001326801"
"cusip_number": "30303M102"
"employer_id": "201665019"
"exchange": "nasdaq"
"ipo_date": "2012:05:18"
"founded_date": "2004:01:04"
"industry": "Internet Content & Information"
"sector": "Communication Services"
}
[
}
https://finnworlds.com/api/v1/identifiers
?key=YOUR-KEY
&isin_identifier=US0378331005
{
"status": {
"message": "Success"
},
"results": [
{
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"cik_code": "0000320193"
"cusip_number": "037833100"
"employer_id": "942404110"
"exchange": "nasdaq"
"ipo_date": "1980:11:12"
"founded_date": "1976:04:01"
"industry": "technology"
"sector": "consumer electronics"
}
[
}
https://finnworlds.com/api/v1/identifiers
?key=YOUR-KEY
&cusip_number=037833100
{
"status": {
"message": "Success"
},
"results": [
{
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"cik_code": "0000320193"
"cusip_number": "037833100"
"employer_id": "942404110"
"exchange": "nasdaq"
"ipo_date": "1980:11:12"
"founded_date": "1976:04:01"
"industry": "technology"
"sector": "consumer electronics"
}
[
}
https://finnworlds.com/api/v1/identifiers
?key=YOUR-KEY
&cusip_number=037833100
{
"status": {
"message": "Success"
},
"results": [
{
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"cik_code": "0000320193"
"cusip_number": "037833100"
"employer_id": "942404110"
"exchange": "nasdaq"
"ipo_date": "1980:11:12"
"founded_date": "1976:04:01"
"industry": "technology"
"sector": "consumer electronics"
}
[
}
https://finnworlds.com/api/v1/identifiers
?key=YOUR-KEY
&employer_id=942404110
{
"status": {
"message": "Success"
},
"results": [
{
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"cik_code": "0000320193"
"cusip_number": "037833100"
"employer_id": "942404110"
"exchange": "nasdaq"
"ipo_date": "1980:11:12"
"founded_date": "1976:04:01"
"industry": "technology"
"sector": "consumer electronics"
}
[
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| isin_identifier | International Securities Identification Number. universally recognizable |
| cik_code | Identify corporations and individuals who have filed disclosure with the SEC |
| cusip_number | identifies most financial instruments. Helps with clearance and settlements |
| employer_id | Federal Tax Identification Number (EIN) |
| . | . |
| . | . |
API Response Objects
| Response Objects | Description |
| name | Name of the company or security |
| stock_ticker_symbol | Stock for which you want output |
| isin_identifier | International Securities Identification Number. universally recognizable |
| cik_code | Identify corporations and individuals who have filed disclosure with the SEC |
| cusip_number | identifies most financial instruments. Helps with clearance and settlements |
| employer_id | Federal Tax Identification Number (EIN) |
| exchange_platform | Exchanged where this security is traded on |
| ipo_date | Date of security’s IPO |
| founded_date | Date of founding of company |
| industry | Industries this security is classified under |
| sector | Sectors this security is classified under |
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.Â
https://finnworlds.com/api/v1/information
?key=YOUR-KEY
&stock_ticker_symbol=AAPL
{
"status": {
"message": "Success"
},
"results": [
{
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"industry": "technology"
"sector": "consumer electronics"
"about": "Apple Inc. designs, manufactures,
and markets smartphones, personal computers,
tablets, wearables, and accessories worldwide.
It also sells various related services."
"description": Apple Inc. designs, manufactures,
and markets smartphones, personal computers,
tablets, wearables, and accessories worldwide.
It also sells various related services.
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,
HomePod, iPod touch, and other Apple-branded
and third-party accessories. It also provides
AppleCare support services; cloud services
store 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 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 sells and delivers 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 founded in 1977 and
is headquartered in Cupertino, California.
"mission": "to bring the best personal computing
products and support to students, educators,
designers, scientists, engineers,
businesspersons and consumers in over 140
countries around the world."
"vision": "to make the best products on earth,
and to leave the world better than we found it."
"phone": "408-996-1010"
"address": "One Apple Park Way, Cupertino, CA 95014, United States"
"country": "United States"
"website": "https://www.apple.com"
"fiscal_year_dates":
"reporting_currency": "USD"
"ipo_date": "1980:11:12"
"founded_date": "1976:04:01"
"employees": "147000"
"leadership": {
"leadership_name": "Mr. Timothy D. Cook"
"leadership_function": "CEO & Director"
"leadership_name": "Mr. Luca Maestri"
"leadership_function": "CFO & Sr. VP"
"leadership_name": "Mr. Jeffrey E. Williams"
"leadership_function": "Chief Operating Officer"
"leadership_name": "Ms. Katherine L. Adams"
"leadership_function": "Sr. VP, Gen. Counsel & Sec."
"leadership_name": "Ms. Deirdre O'Brien"
"leadership_function": "Sr. VP of People & Retail"
"leadership_name": "Mr. Chris Kondo"
"leadership_function": "Sr. Director of Corp. Accounting"
"leadership_name": "Mr. James Wilson"
"leadership_function": "Chief Technology Officer"
"leadership_name": "Ms. Mary Demby"
"leadership_function": "Chief Information Officer"
"leadership_name": "Ms. Nancy Paxton"
"leadership_function": "Sr. Director of Investor Relations & Treasury"
"leadership_name": "Mr. Greg Joswiak"
"leadership_function": "Sr. VP of Worldwide Marketing"
}
}
]
}
https://finnworlds.com/api/v1/information
?key=YOUR-KEY
&stock_ticker_symbol=AAPL,FB
{
"status": {
"message": "Success"
},
"results": [
{
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"industry": "technology"
"sector": "consumer electronics"
"about": "Apple Inc. designs, manufactures,
and markets smartphones, personal computers,
tablets, wearables, and accessories worldwide.
It also sells various related services."
"description": Apple Inc. designs, manufactures,
and markets smartphones, personal computers,
tablets, wearables, and accessories worldwide.
It also sells various related services.
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,
HomePod, iPod touch, and other Apple-branded
and third-party accessories. It also provides
AppleCare support services; cloud services
store 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 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 sells and delivers 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 founded in 1977 and
is headquartered in Cupertino, California.
"mission": "to bring the best personal computing
products and support to students, educators,
designers, scientists, engineers,
businesspersons and consumers in over 140
countries around the world."
"vision": "to make the best products on earth,
and to leave the world better than we found it."
"phone": "408-996-1010"
"address": "One Apple Park Way, Cupertino, CA 95014, United States"
"country": "United States"
"website": "https://www.apple.com"
"fiscal_year_dates":
"reporting_currency": "USD"
"ipo_date": "1980:11:12"
"founded_date": "1976:04:01"
"employees": "147000"
"leadership": {
"leadership_name": "Mr. Timothy D. Cook"
"leadership_function": "CEO & Director"
"leadership_name": "Mr. Luca Maestri"
"leadership_function": "CFO & Sr. VP"
"leadership_name": "Mr. Jeffrey E. Williams"
"leadership_function": "Chief Operating Officer"
"leadership_name": "Ms. Katherine L. Adams"
"leadership_function": "Sr. VP, Gen. Counsel & Sec."
"leadership_name": "Ms. Deirdre O'Brien"
"leadership_function": "Sr. VP of People & Retail"
"leadership_name": "Mr. Chris Kondo"
"leadership_function": "Sr. Director of Corp. Accounting"
"leadership_name": "Mr. James Wilson"
"leadership_function": "Chief Technology Officer"
"leadership_name": "Ms. Mary Demby"
"leadership_function": "Chief Information Officer"
"leadership_name": "Ms. Nancy Paxton"
"leadership_function": "Sr. Director of Investor Relations & Treasury"
"leadership_name": "Mr. Greg Joswiak"
"leadership_function": "Sr. VP of Worldwide Marketing"
}
}
]
}
https://finnworlds.com/api/v1/information
?key=YOUR-KEY
&isin_identifier=US0378331005
{
"status": {
"message": "Success"
},
"results": [
{
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"industry": "technology"
"sector": "consumer electronics"
"about": "Apple Inc. designs, manufactures,
and markets smartphones, personal computers,
tablets, wearables, and accessories worldwide.
It also sells various related services."
"description": Apple Inc. designs, manufactures,
and markets smartphones, personal computers,
tablets, wearables, and accessories worldwide.
It also sells various related services.
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,
HomePod, iPod touch, and other Apple-branded
and third-party accessories. It also provides
AppleCare support services; cloud services
store 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 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 sells and delivers 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 founded in 1977 and
is headquartered in Cupertino, California.
"mission": "to bring the best personal computing
products and support to students, educators,
designers, scientists, engineers,
businesspersons and consumers in over 140
countries around the world."
"vision": "to make the best products on earth,
and to leave the world better than we found it."
"phone": "408-996-1010"
"address": "One Apple Park Way, Cupertino, CA 95014, United States"
"country": "United States"
"website": "https://www.apple.com"
"fiscal_year_dates":
"reporting_currency": "USD"
"ipo_date": "1980:11:12"
"founded_date": "1976:04:01"
"employees": "147000"
"leadership": {
"leadership_name": "Mr. Timothy D. Cook"
"leadership_function": "CEO & Director"
"leadership_name": "Mr. Luca Maestri"
"leadership_function": "CFO & Sr. VP"
"leadership_name": "Mr. Jeffrey E. Williams"
"leadership_function": "Chief Operating Officer"
"leadership_name": "Ms. Katherine L. Adams"
"leadership_function": "Sr. VP, Gen. Counsel & Sec."
"leadership_name": "Ms. Deirdre O'Brien"
"leadership_function": "Sr. VP of People & Retail"
"leadership_name": "Mr. Chris Kondo"
"leadership_function": "Sr. Director of Corp. Accounting"
"leadership_name": "Mr. James Wilson"
"leadership_function": "Chief Technology Officer"
"leadership_name": "Ms. Mary Demby"
"leadership_function": "Chief Information Officer"
"leadership_name": "Ms. Nancy Paxton"
"leadership_function": "Sr. Director of Investor Relations & Treasury"
"leadership_name": "Mr. Greg Joswiak"
"leadership_function": "Sr. VP of Worldwide Marketing"
}
}
]
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| isin_identifier | International Securities Identification Number. universally recognizable |
API Response Objects
| Response Objects | Description |
| name | Name of the company or security |
| stock_ticker_symbol | Stock for which you want output |
| isin_identifier | International Securities Identification Number. universally recognizable |
| industry | Industries this security is classified under |
| sector | Sectors this security is classified under |
| about | Short description of the company or security |
| description | Extended description of the company or security |
| mission | The mission of the company |
| vision | The vision of the company |
| phone | Phone number of the company |
| address | Address of the main office of the company |
| country | Country of main operations of the company |
| website | URL link to the website of the company |
| fiscal_year_dates | The starting dates of the company fiscal year |
| reporting_currncy | The currency used in company reporting |
| ipo_date | Date of initial public offering of security |
| founded_date | Date of founding of the company |
| leadership | Boardmembers and C level leadership of the company |
| leadership_name | Name of the member of leadership |
| leadership_function | Function of the member of leadership |
Income Statements
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.
https://finnworlds.com/api/v1/incomestatements
?key=YOUR-KEY
&stock_ticker_symbol=aapl
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "347,155,000",
"operating_revenue": "347,155,000"
"cost_of_revenue": "204,804,000"
"gross_profit": "142,351,000"
"operating_expense": "42,413,000"
"operating_income": "99,938,000"
"net_non_operating_interest_income_expense": "345,000"
"other_income_expense": "577,000"
"pretax_income": "100,860,000"
"tax_provision": "14,058,000"
"net_income_common_stockholders": "86,802,000"
"diluted_ni_available_to_com_stockholders": "86,802,000",
"basic_eps": ""
"diluted_eps": ""
"basic_average_shares": ""
"diluted_average_shares": ""
"total_operating_income_as_reported": "99,938,000"
"total_expenses": "247,217,000"
"net_income_from_continuing_and_discontinued_operation": "86,802,000"
"normalized_income": "86,802,000"
"interest_income": "2,952,000"
"interest_expense": "2,607,000"
"net_interest_income": "345,000"
"ebit": "103,467,000"
"ebitda": "114,464,000"
"reconciled_cost_of_revenue": "204,804,000"
"reconciled_depreciation": "10,997,000",
"net_income_from_continuing_operation_net_minority_interest": "86,802,000"
"total_unusual_items_excluding_goodwill": "0"
"total_unusual_items": "0"
"normalized_ebitda": "114,464,000"
"tax_rate_for_calcs": "0"
"tax_effect_of_unusual_items": "0"
}
[
}
https://finnworlds.com/api/v1/incomestatements
?key=YOUR-KEY
§or=technology
&industry=consumer_electronics
&income_statement=total_revenue
&year=2021
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "347,155,000",
},
"basics": {
"name": "Microsoft Corporation",
"stock_ticker_symbol": "MSFT"
"isin_identifier": "US5949181045"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "168,088,000",
},
"basics": {
"name": "Dell Technologies Inc",
"stock_ticker_symbol": "DELL"
"isin_identifier": "US24703L2025"
"exchange": "NYSE"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "96,814,000",
},
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "...",
}
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "...",
},
}
[
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| sector | Sector this security is classified under |
| industry | Industries this security is classified under |
| income_statement | If you want to highlight specific components of the income statement (operating income, operating expenses, …) See response objects. |
| format | Quarterly results or Yearly results |
| year | Year for which you want results |
| quarter | Quarter for which you want results |
API Response Objects
Â
| Response Objects | Description |
| name | Name of the company or security |
| stock_ticker_symbol | Stock for which you want output |
| isin_identifier | International Securities Identification Number. universally recognizable |
| industry | Industries this security is classified under |
| sector | Sectors this security is classified under |
| total_revenue | Â |
| >operating_revenue | Â |
| cost_of_revenue | Â |
| gross_profit | Â |
| operating_expense | Â |
| >selling_general_and_administrative | Â |
| >research_and_development | Â |
| operating_income | Â |
| net_non_operating_interest_income_expense | Â |
| >interest_income_non_operating | Â |
| >interest_expense_non_operating | Â |
| other_income_expense | Â |
| >special_income_charges | Â |
| >>restructuring_and_mergers_acquisition | Â |
| >other_non_operating_income_expenses | Â |
| pretax_income | Â |
| tax_provision | Â |
| net_income_common_stockholders | Â |
| >net_income | Â |
| >>net_income_including_non_controlling_interests | Â |
| >>>net_income_continuous_operations | Â |
| >>minority_interests | Â |
| diluted_ni_available_to_com_stockholders | Â |
| basic_eps | Â |
| diluted_eps | Â |
| basic_average_shares | Â |
| diluted_average_shares | Â |
| total_operating_income_as_reported | Â |
| total_expenses | Â |
| net_income_from_continuing_and_discontinued_operation | Â |
| normalized_income | Â |
| interest_income | Â |
| interest_expense | Â |
| net_interest_income | Â |
| ebit | Â |
| ebitda | Â |
| reconciled_cost_of_revenue | Â |
| reconciled_depreciation | Â |
| net_income_from_continuing_operation_net_minority_interest | Â |
| total_unusual_items_excluding_goodwill | Â |
| total_unusual_items | Â |
| normalized_ebitda | Â |
| tax_rate_for_calcs | Â |
| tax_effect_of_unusual_items | Â |
| Â | Â |
| Â | Â |
| Â | Â |
| Â | Â |
Â
Balance Sheet
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.
https://finnworlds.com/api/v1/balancesheets
?key=YOUR-KEY
&stock_ticker_symbol=aapl
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "323,888,000",
"total_liabilities_net_minority_interest": "258,549,000"
"total_equity_gross_minority_interest": "65,339,000"
"total_capitalization": "164,006,000"
"common_stock_equity": "65,339,000"
"net_tangible_assets": "65,339,000"
"working_capital": "38,321,000"
"invested_capital": "177,775,000"
"tangible_book_value": "65,339,000"
"total_debt": "112,436,000"
"net_debt": "74,420,000"
"share_issued": "16,976,763",
"ordinary_shares_number": "16,976,763"
}
[
}
https://finnworlds.com/api/v1/balancesheets
?key=YOUR-KEY
§or=technology
&industry=consumer_electronics
&income_statement=total_assets
&year=2021
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "323,888,000",
},
"basics": {
"name": "Microsoft Corporation",
"stock_ticker_symbol": "MSFT"
"isin_identifier": "US5949181045"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "333,779,000",
},
"basics": {
"name": "Dell Technologies Inc",
"stock_ticker_symbol": "DELL"
"isin_identifier": "US24703L2025"
"exchange": "NYSE"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "123,415,000",
},
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "...",
}
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "...",
},
}
[
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| sector | Sector this security is classified under |
| industry | Industries this security is classified under |
| balance_sheet | If you want to highlight specific components of the balance sheet (assets, liabilities, …) See response objects. |
| format | Quarterly results or Yearly results |
| year | Year for which you want results |
| quarter | Quarter for which you want results |
API Response Objects
| Response Objects | Description |
| name | Name of the company or security |
| stock_ticker_symbol | Stock for which you want output |
| isin_identifier | International Securities Identification Number. universally recognizable |
| industry | Industries this security is classified under |
| sector | Sectors this security is classified under |
| total_assets | Â |
| >tba | Â |
| total_liabilities_net_minority_interest | Â |
| >tba | Â |
| total_equity_gross_minority_interest | Â |
| >tba | Â |
| total_capitalization | Â |
| common_stock_equity | Â |
| net_tangible_assets | Â |
| working_capital | Â |
| invested_capital | Â |
| tangible_book_value | Â |
| total_debt | Â |
| net_debt | Â |
| share_issued | Â |
| ordinary_shares_number | Â |
| Â | Â |
| Â | Â |
Cash Flow
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.
https://finnworlds.com/api/v1/cashflows
?key=YOUR-KEY
&stock_ticker_symbol=aapl
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"operating_cash_flow": "104,414,000",
"investing_cash_flow": "-9,849,000"
"financing_cash_flow": "-94,328,000"
"end_cash_position": "35,276,000"
"income_tax_paid_supplemental_data": "19,627,000"
"interest_paid_supplemental_data": "2,597,000"
"capital_expenditure": "-9,646,000"
"issuance_of_capital_stock": "1,011,000"
"issuance_of_debt": "22,370,000 "
"repayment_of_debt": "-7,500,000"
"repurchase_of_capital_stock": "-83,410,000",
"free_cash_flow": "94,768,000"
}
[
}
https://finnworlds.com/api/v1/balancesheets
?key=YOUR-KEY
§or=technology
&industry=consumer_electronics
&cash_flow=operating_cash_flow
&year=2021
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"operating_cash_flow": "104,414,000",
},
"basics": {
"name": "Microsoft Corporation",
"stock_ticker_symbol": "MSFT"
"isin_identifier": "US5949181045"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"operating_cash_flow": "76,740,000",
},
"basics": {
"name": "Dell Technologies Inc",
"stock_ticker_symbol": "DELL"
"isin_identifier": "US24703L2025"
"exchange": "NYSE"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"operating_cash_flow": "14,441,000",
},
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"operating_cash_flow": "...",
}
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"operating_cash_flow": "...",
},
}
[
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| sector | Sector this security is classified under |
| industry | Industries this security is classified under |
| cash_flow | If you want to highlight specific components of the cash flow (operating cash flow, investing cash flow, …) See response objects. |
| format | Quarterly results or Yearly results |
| year | Year for which you want results |
| quarter | Quarter for which you want results |
API Response Objects
| Response Objects | Description |
| name | Name of the company or security |
| stock_ticker_symbol | Stock for which you want output |
| isin_identifier | International Securities Identification Number. universally recognizable |
| industry | Industries this security is classified under |
| sector | Sectors this security is classified under |
| operating_cash_flow | Â |
| >tba | Â |
| investing_cash_flow | Â |
| >tba | Â |
| financing_cash_flow | Â |
| >tba | Â |
| end_cash_position | Â |
| >tba | Â |
| income_tax_paid_supplemental_data | Â |
| interest_paid_supplemental_data | Â |
| capital_expenditure | Â |
| issuance_of_capital_stock | Â |
| issuance_of_capital_stock | Â |
| issuance_of_debt | Â |
| repayment_of_debt | Â |
| repurchase_of_capital_stock | Â |
| free_cash_flow | Â |
| Â | Â |
Financial Ratios
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. You could for example take all quick ratios of all companies within sector Technology, industry Consumer electronicsÂ
https://finnworlds.com/api/v1/financialratios
?key=YOUR-KEY
&stock_ticker_symbol=aapl
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"currentRatio": "1.3636044481554577"
"quickRatio": "1.2181949294064065"
"cashRatio": "0.36071049035979963"
"daysOfSalesOutstanding": "49.78753437881355"
"daysOfInventoryOutstanding": "8.741883356235881"
"operatingCycle": "58.52941773504943"
"daysOfPayablesOutstanding": "91.04818971567418"
"cashConversionCycle": "-32.518771980624756"
"grossProfitMargin": "0.38233247727810865"
"operatingProfitMargin": "0.24147314354406862"
"pretaxProfitMargin": "0.24439830246070343"
"netProfitMargin": "0.20913611278072236"
"effectiveTaxRate":" 0.14428164731484103"
"returnOnAssets": "0.1772557180259843"
"returnOnEquity": "0.8786635853012749"
"returnOnCapitalEmployed": "0.3033831282952548"
"netIncomePerEBT": "0.855718352685159"
"ebtPerEbit": "1.0121138064204682"
"ebitPerRevenue": "0.24147314354406862"
"debtRatio": "0.7982666847799239"
"debtEquityRatio": "3.957039440456695"
"longTermDebtToCapitalization": "0.6016060388034584"
"totalDebtToCapitalization": "0.6324623822247223"
"interestCoverage": "23.07274625826662"
"cashFlowToDebtRatio": "0.7175104059198122"
"companyEquityMultiplier": "4.957039440456695"
"receivablesTurnover": "7.331152356789959"
"payablesTurnover": "4.008866086627577"
"inventoryTurnover": "41.75301649839941"
"fixedAssetTurnover": "7.466545177609748"
"assetTurnover": "0.8475615027416885"
"operatingCashFlowPerShare": "4.649230448454163"
"freeCashFlowPerShare": "4.2280138811865"
}
[
}
https://finnworlds.com/api/v1/financialratios
?key=YOUR-KEY
&stock_ticker_symbol=aapl,msft,dell
&financial-ratio=current_ratio,quick_ratio,cash_ratio
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.3636044481554577"
"quick_ratio": "1.2181949294064065"
"cash_ratio": "0.36071049035979963"
},
"basics": {
"name": "Microsoft Corporation",
"stock_ticker_symbol": "MSFT"
"isin_identifier": "US5949181045"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.8155457736360444"
"quick_ratio": "1.2940640652181949"
"cash_ratio": "0.49035979963360710"
},
"basics": {
"name": "Dell Technologies Inc",
"stock_ticker_symbol": "DELL"
"isin_identifier": "US24703L2025"
"exchange": "NYSE"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.4815545773636044"
"quick_ratio": "1.2940640218194965"
"cash_ratio": "0.35979963360710490"
},
}
[
}
https://finnworlds.com/api/v1/financialratios
?key=YOUR-KEY
&stock_ticker_symbol=aapl,msft,dell
&financial-ratio=current_ratio,quick_ratio,cash_ratio
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.3636044481554577"
"quick_ratio": "1.2181949294064065"
"cash_ratio": "0.36071049035979963"
},
"basics": {
"name": "Microsoft Corporation",
"stock_ticker_symbol": "MSFT"
"isin_identifier": "US5949181045"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.8155457736360444"
"quick_ratio": "1.2940640652181949"
"cash_ratio": "0.49035979963360710"
},
"basics": {
"name": "Dell Technologies Inc",
"stock_ticker_symbol": "DELL"
"isin_identifier": "US24703L2025"
"exchange": "NYSE"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"current_ratio": "1.4815545773636044"
"quick_ratio": "1.2940640218194965"
"cash_ratio": "0.35979963360710490"
},
}
[
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| sector | Sector this security is classified under |
| industry | Industries this security is classified under |
| financial_ratio | If you want to highlight specific components of the cash flow (operating cash flow, investing cash flow, …) See response objects. |
| format | Quarterly results or Yearly results |
| year | Year for which you want results |
| quarter | Quarter for which you want results |
API Response Objects
| Response Objects | Description |
| name | Name of the company or security |
| stock_ticker_symbol | Stock for which you want output |
| isin_identifier | International Securities Identification Number. universally recognizable |
| industry | Industries this security is classified under |
| sector | Sectors this security is classified under |
| return_on_assets | Â |
| return_on_equity | Â |
| profit_margin | Â |
| current_ratio | Â |
| quick_ratio | Â |
| cash_ratio | Â |
| debt_ratio | Â |
| debt_to_equity_ratio | Â |
| interest_coverage_ratio | Â |
| debt_service_coverage_ratio | Â |
| price_to_earnings_ratio | Â |
| price_earnings_to_growth_ratio | Â |
| price_to_sales_ratio | Â |
| price_to_book_ratio | Â |
| dividend_yield | Â |
| dividend_payout_ratio | Â |
| asset_turnover_ratio | Â |
| inventory_turnover_ratio | Â |
| receivables_turnover_ratio | Â |
| payables_turnover_ratio | Â |
| Â | Â |
Technical Indicators
Technical indicators, calculated based on saved historical prices on the candlesticks of: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 12h, 1d, 1w.
Also includes the ability to identify technical indicators in the past by selecting an earlier endpoint and work back from there.
https://finnworlds.com/api/v1/technicalindicators
?key=YOUR-KEY
&stock_ticker_symbol=aapl&technical_indicator=relative_strength_index
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
},
"output": {
"value": 70.03713323772295,
"backtrack": 0
},
{
"value": 68.55107952179476,
"backtrack": 1
},
{
"value": 72.55100476679559,
"backtrack": 2
},
{
"value": 73.51409814264913,
"backtrack": 3
},
{
"value": 69.91451308499144,
"backtrack": 4
},
{
"value": 65.17308969691057,
"backtrack": 5
},
{
"value": 66.17910755701931,
"backtrack": 6
},
{
"value": 68.41845715627683,
"backtrack": 7
},
{
"value": 64.71596338703083,
"backtrack": 8
},
{
"value": 70.76586249275925,
"backtrack": 9
}
},
}
[
}
https://finnworlds.com/api/v1/technicalindicators
?key=YOUR-KEY
&stock_ticker_symbol=aapl&technical_indicator=stalled_pattern
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
},
"output": {
{
value: "100" // stalled_pattern pattern found at this candle
}
{
value: "0" // stalled_pattern pattern NOT found at this candle
}
},
}
[
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| stock_ticker_symbol | Security for which you want technical indicators |
| exchange | Exchange where the security is trade on |
| technical_indicator | Which technical indicator you want to check for. Choose from the other table |
| interval | The candle interval to check (1m, 5m, 15m, 30m, 1h, 2h, 4h, 12h, 1d, 1w) |
| retrace | Starting point back in time from where to check |
| checks | The number of candles you want to check, going in the direction from the retrace towards the past |
| candle_type | Available candle types are: candle / heikinashi / Renko / Kagi |
API Response Objects
| Response Objects | Description |
| name | Name of the company or security |
| stock_ticker_symbol | Stock for which you want output |
| isin_identifier | International Securities Identification Number. universally recognizable |
| exchange | Exchange where the security is trade on |
| stochastic_indicator | Â |
| bollinger_bands | Â |
| ichimoku_cloud | Â |
| moving_average_convergence_divergence | Â |
| relative_strength_index | Â |
| fibonacci_retracement | Â |
| average_directional_index | Â |
| parabolic_stop_and_reverse | Â |
| money_flow_index | Â |
| average_true_range | Â |
| simple_moving_average | Â |
| exponential_moving_average | Â |
| on_balance_volume | Â |
| pivot_points | Â |
| dynamic_momentum_index | Â |
| directional_movement_index | Â |
| aroon_indicator | Â |
| klinger_oscillator | Â |
| percentage_price_oscillator | Â |
| Â | Â |
| Â | Â |
| Â | Â |
Analyst Ratings
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.Â
https://api.finnworlds.com/api/v1/companyratings
?key=API-KEY
&company_ticker=AAPL
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company_name": "Apple Inc",
"company_ticker": "AAPL"
},
"output": {
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "181.65",
"analyst_highest": "220.00",
"analyst_lowest": "136.00",
"analysts_number": "28",
"buy": "22",
"hold": "5",
"sell": "1",
"consensus_date": "2022-10-18"
},
"analysts": [
{
"analyst_name": "ivan-feinseth",
"analyst_firm": "Tigress Financial",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-10-04T00:00:00",
"price_target": "210.0",
"target_date": "2023-10-04",
"rated": "Buy",
"conclusion": "reiterated",
}
},
{
"analyst_name": "samik-chatterjee",
"analyst_firm": "J.P. Morgan",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-10-03",
"price_target": "None",
"target_date": "2023-10-03",
"rated": "Buy",
"conclusion": "maintained",
}
},
{
"analyst_name": "erik-woodring",
"analyst_firm": "Morgan Stanley",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-10-03",
"price_target": "180.0",
"target_date": "2023-10-03",
"rated": "Buy",
"conclusion": "maintained",
}
},
{
"analyst_name": "angelo-zino",
"analyst_firm": "CFRA",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-10-01",
"price_target": "175.0",
"target_date": "2023-10-01",
"rated": "Buy",
"conclusion": "maintained",
}
},
ETC
https://api.finnworlds.com/api/v1/companyratings
?key=API-KEY
&ticker=AAPL
&date_from=2020-01-10
&rated=buy
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company_name": "Apple Inc",
"company_ticker": "AAPL"
},
"output": {
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "181.65",
"analyst_highest": "220.00",
"analyst_lowest": "136.00",
"analysts_number": "28",
"buy": "22",
"hold": "5",
"sell": "1",
"consensus_date": "2022-10-18"
},
"analysts": [
{
"analyst_name": "ivan-feinseth",
"analyst_firm": "Tigress Financial",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-10-04",
"price_target": "210.0",
"target_date": "2023-10-04",
"rated": "Buy",
"conclusion": "reiterated",
}
},
{
"analyst_name": "samik-chatterjee",
"analyst_firm": "J.P. Morgan",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-10-03",
"price_target": "None",
"target_date": "2023-10-03",
"rated": "Buy",
"conclusion": "maintained",
}
},
{
"analyst_name": "erik-woodring",
"analyst_firm": "Morgan Stanley",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-10-03",
"price_target": "180.0",
"target_date": "2023-10-03",
"rated": "Buy",
"conclusion": "maintained",
}
},
{
"analyst_name": "angelo-zino",
"analyst_firm": "CFRA",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-10-01",
"price_target": "175.0",
"target_date": "2023-10-01",
"rated": "Buy",
"conclusion": "maintained",
}
},
{
"analyst_name": "barton-crockett",
"analyst_firm": "Rosenblatt Securities",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-09-29",
"price_target": "189.0",
"target_date": "2023-09-29",
"rated": "Buy",
"conclusion": "upgraded",
}
},
{
"analyst_name": "david-vogt",
"analyst_firm": "UBS",
"analyst_role": "analyst",
"rating": {
"date_rating": "2022-09-29",
"price_target": "185.0",
"target_date": "2023-09-29",
"rated": "Buy",
"conclusion": "maintained",
}
},
https://api.finnworlds.com/api/v1/analystratings
?key=API-KEY
&analyst_name=daniel-ives
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"analyst_name": "daniel-ives",
"analyst_firm": "Wedbush",
"analyst_role": "analyst"
},
"output": [
{
"company_name": "TWTR",
"company_ticker": "Twitter Inc",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "45.27",
"analyst_highest": "54.20",
"analyst_lowest": "22.00",
"analysts_number": "11",
"buy": "",
"hold": "11",
"sell": "",
"consensus_date": "2022-10-18"
},
"rating": {
"date_rating": "2022-10-05",
"price_target": "54.2",
"target_date": "2023-10-05",
"rated": "Hold",
"conclusion": "rated",
}
},
{
"company_name": "TSLA",
"company_ticker": "Tesla Motors",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "306.97",
"analyst_highest": "400.00",
"analyst_lowest": "73.00",
"analysts_number": "27",
"buy": "18",
"hold": "5",
"sell": "4",
"consensus_date": "2022-10-18"
},
"rating": {
"date_rating": "2022-10-02",
"price_target": "360.0",
"target_date": "2023-10-02",
"rated": "Buy",
"conclusion": "maintained",
}
},
{
"company_name": "AAPL",
"company_ticker": "Apple Inc",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "181.65",
"analyst_highest": "220.00",
"analyst_lowest": "136.00",
"analysts_number": "28",
"buy": "22",
"hold": "5",
"sell": "1",
"consensus_date": "2022-10-18"
},
"rating": {
"date_rating": "2022-09-28",
"price_target": "220.0",
"target_date": "2023-09-28",
"rated": "Buy",
"conclusion": "maintained",
}
},
{
"company_name": "GM",
"company_ticker": "General Motors Company",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "53.29",
"analyst_highest": "90.00",
"analyst_lowest": "30.00",
"analysts_number": "14",
"buy": "10",
"hold": "4",
"sell": "",
"consensus_date": "2022-10-18"
},
"rating": {
"date_rating": "2022-09-22",
"price_target": "42.0",
"target_date": "2023-09-22",
"rated": "Buy",
"conclusion": "maintained",
}
},
{
"company_name": "LICY",
"company_ticker": "Li-Cycle Holdings Corp.",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "9.38",
"analyst_highest": "13.00",
"analyst_lowest": "7.00",
"analysts_number": "8",
"buy": "6",
"hold": "2",
"sell": "",
"consensus_date": "2022-10-18"
},
"rating": {
"date_rating": "2022-09-15",
"price_target": "9.0",
"target_date": "2023-09-15",
"rated": "Buy",
"conclusion": "maintained",
}
},
ETC
https://api.finnworlds.com/api/v1/analystratings
?key=API-KEY
&analyst_firm=wedbush
{
"status": {
"message": "Success."
},
"results": [
{
"basics": {
"analyst_firm": "JP Morgan",
NO EXAMPLE PROVIDED, CONTACT US FOR EXAMPLES
}
}
]
}
https://api.finnworlds.com/api/v1/analystratings
?key=API-KEY
&analyst_name=daniel-ives
&date_from=2020-01-10
&date_to=2021-01-10
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"analyst_name": "daniel-ives",
"analyst_firm": "Wedbush",
"analyst_role": "analyst"
},
"output": [
{
"company_name": "BNFT",
"company_ticker": "Benefitfocus Inc",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "6.00",
"analyst_highest": "6.00",
"analyst_lowest": "6.00",
"analysts_number": "1",
"buy": "",
"hold": "1",
"sell": "",
"consensus_date": "2022-10-18"
},
"rating": {
"date_rating": "2020-03-04",
"price_target": "22.0",
"target_date": "2021-03-04",
"rated": "Buy",
"conclusion": "maintained",
}
},
{
"company_name": "CTXS",
"company_ticker": "Citrix Systems",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "",
"analyst_highest": "",
"analyst_lowest": "",
"analysts_number": "",
"buy": "",
"hold": "",
"sell": "",
"consensus_date": ""
},
"rating": {
"date_rating": "2020-04-24",
"price_target": "135.0",
"target_date": "2021-04-24",
"rated": "Hold",
"conclusion": "maintained",
}
},
{
"company_name": "NLOK",
"company_ticker": "Nortonlifelock Inc.",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "28.50",
"analyst_highest": "29.00",
"analyst_lowest": "28.00",
"analysts_number": "2",
"buy": "1",
"hold": "1",
"sell": "",
"consensus_date": "2022-10-18"
},
"rating": {
"date_rating": "2020-05-15",
"price_target": "23.0",
"target_date": "2021-05-15",
"rated": "Hold",
"conclusion": "maintained",
}
},
{
"company_name": "MNDT",
"company_ticker": "Mandiant, Inc.",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "",
"analyst_highest": "",
"analyst_lowest": "",
"analysts_number": "",
"buy": "",
"hold": "",
"sell": "",
"consensus_date": ""
},
"rating": {
"date_rating": "2020-07-29",
"price_target": "15.0",
"target_date": "2021-07-29",
"rated": "Hold",
"conclusion": "maintained",
}
},
{
"company_name": "CLDR",
"company_ticker": "Cloudera",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "",
"analyst_highest": "",
"analyst_lowest": "",
"analysts_number": "",
"buy": "",
"hold": "",
"sell": "",
"consensus_date": ""
},
"rating": {
"date_rating": "2020-09-03",
"price_target": "16.0",
"target_date": "2021-09-03",
"rated": "Hold",
"conclusion": "maintained",
}
},
{
"company_name": "VMW",
"company_ticker": "VMware Inc",
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "138.83",
"analyst_highest": "142.50",
"analyst_lowest": "136.00",
"analysts_number": "3",
"buy": "1",
"hold": "2",
"sell": "",
"consensus_date": "2022-10-18"
},
"rating": {
"date_rating": "2020-11-25",
"price_target": "175.0",
"target_date": "2021-11-25",
"rated": "Buy",
"conclusion": "maintained",
}
},
ETC
https://api.finnworlds.com/api/v1/consensusratings
?key=API-KEY
&ticker=AAPL
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company_name": "Apple Inc",
"company_ticker": "AAPL"
},
"output": {
"analyst_consensus": {
"consensus_conclusion": "",
"analyst_average": "181.65",
"analyst_highest": "220.00",
"analyst_lowest": "136.00",
"analysts_number": "28",
"buy": "22",
"hold": "5",
"sell": "1",
"consensus_date": "2022-10-18"
}
}
}
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| company_ticker | Stock for which you want output |
| analyst_name | Analyst name from who you want ratings |
| analyst_firm | Analyst firm from which you want ratings |
| rated | In case you want to filter on buy, sell or hold |
| date_from | Used for getting historical ratings in a certain date range |
| date_to | Used for getting historical ratings in a certain date range |
API Response Objects
| Response Objects | Description |
| company_name | Name of company |
| company_ticker | Ticker symbol of company |
| consensus_conclusion | The average of all analysts in words: buy, hold, sell |
| analyst_average | Average price target of analysts with a 12 month price target |
| analyst_highest | Highest rating of analysts |
| analyst_lowest | Lowest rating of analysts |
| buy | Number of analysts with a Buy rating |
| hold | Number of analysts with a Hold rating |
| sell | Number of analysts with a Sell rating |
| analyst_name | Name of the analyst giving the rating |
| analyst_firm | Firm where the analyst works who makes the rating |
| analyst_role | The job or function of the analyst |
| price_target | The price target of the analyst |
| target_date | The target date to which the price target applies, usually 12 months later |
| rated | Buy hold sell rating of an analyst |
| conclusion | Weither the analyst reiterated, maintained, started covering, or other |
ETF Holdings
Information about ETFs and which stocks they hold. This includes the total owned shares, percentage of their portfolio. Different endpoint examples are provided with the Json response for it. You can also use this to identify which ETFs are holding a certain stock.
https://api.finnworlds.com/api/v1/etfinfo
?key=API-KEY
&cik=1137095
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"general": {
"fund_name": "USA Mutuals",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93",
"country": "US",
"state": "US-TX",
"city": "Dallas",
"zip": "75201",
"street": "700 N. Pearl Street",
"phone": "866-264-8783"
},
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"fund_info": {
"total_assets": "111438858.600000000000",
"total_liabilities": "1741129.050000000000",
"net_assets": "109697729.550000000000",
"assets_attr_misc_sec": "0.000000000000",
"invested_assets": "0.000000000000",
"one_yr_banks_borr": "591000.000000000000",
"one_yr_ctrld_comp": "0.000000000000",
"one_yr_oth_affil": "0.000000000000",
"one_yr_other": "0.000000000000",
"aft_one_yr_banks_borr": "0.000000000000",
"aft_one_yr_ctrld_comp": "0.000000000000",
"aft_one_yr_oth_affil": "0.000000000000",
"aft_one_yr_other": "0.000000000000",
"delivery_delay": "0.000000000000",
"standby_commit": "0.000000000000",
"liquid_pref": "0.000000000000",
"cash_not_reported_in_cor_d": "2545141.120000000000",
"non_cash_collateral": "N",
"currency": "Null"
}
},
{
"general": {
"fund_name": "USA Mutuals",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93",
"country": "US",
"state": "US-TX",
"city": "Dallas",
"zip": "75201",
"street": "700 N. Pearl Street",
"phone": "866-264-8783"
},
"attributes": {
"series_name": "USA Mutuals Navigator Fund",
"series_id": "S000058976",
"series_lei": "549300CS0EIS27ZLBG68",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"fund_info": {
"total_assets": "44290035.570000000000",
"total_liabilities": "208427.160000000000",
"net_assets": "44081608.410000000000",
"assets_attr_misc_sec": "0.000000000000",
"invested_assets": "0.000000000000",
"one_yr_banks_borr": "0.000000000000",
"one_yr_ctrld_comp": "0.000000000000",
"one_yr_oth_affil": "0.000000000000",
"one_yr_other": "0.000000000000",
"aft_one_yr_banks_borr": "0.000000000000",
"aft_one_yr_ctrld_comp": "0.000000000000",
"aft_one_yr_oth_affil": "0.000000000000",
"aft_one_yr_other": "0.000000000000",
"delivery_delay": "0.000000000000",
"standby_commit": "0.000000000000",
"liquid_pref": "0.000000000000",
"cash_not_reported_in_cor_d": "34462732.210000000000",
"non_cash_collateral": "N",
"currency": "Null"
}
}
]
}
}
https://api.finnworlds.com/api/v1/etfinfo
?key=API-KEY
&cik=1137095
&series_id=S000005505
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"general": {
"fund_name": "USA Mutuals",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93",
"country": "US",
"state": "US-TX",
"city": "Dallas",
"zip": "75201",
"street": "700 N. Pearl Street",
"phone": "866-264-8783"
},
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"fund_info": {
"total_assets": "111438858.600000000000",
"total_liabilities": "1741129.050000000000",
"net_assets": "109697729.550000000000",
"assets_attr_misc_sec": "0.000000000000",
"invested_assets": "0.000000000000",
"one_yr_banks_borr": "591000.000000000000",
"one_yr_ctrld_comp": "0.000000000000",
"one_yr_oth_affil": "0.000000000000",
"one_yr_other": "0.000000000000",
"aft_one_yr_banks_borr": "0.000000000000",
"aft_one_yr_ctrld_comp": "0.000000000000",
"aft_one_yr_oth_affil": "0.000000000000",
"aft_one_yr_other": "0.000000000000",
"delivery_delay": "0.000000000000",
"standby_commit": "0.000000000000",
"liquid_pref": "0.000000000000",
"cash_not_reported_in_cor_d": "2545141.120000000000",
"non_cash_collateral": "N",
"currency": "Null"
}
}
]
}
}
https://api.finnworlds.com/api/v1/etfreturns
?key=API-KEY
&series_id=S000005505
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"signature": {
"date_signed": "2021-02-09",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "Richard Sapio",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "-6.820000000000",
"rtn2": "15.030000000000",
"rtn3": "4.540000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "-6.780000000000",
"rtn2": "15.000000000000",
"rtn3": "4.530000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "-6.850000000000",
"rtn2": "14.920000000000",
"rtn3": "4.520000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "-6.780000000000",
"rtn2": "15.060000000000",
"rtn3": "4.560000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "1047242.290000000000",
"net_unrealized_appreciation": "-8495540.410000000000"
},
"other_monthly2": {
"net_realized_gain": "682677.450000000000",
"net_unrealized_appreciation": "14452752.560000000000"
},
"other_monthly3": {
"net_realized_gain": "81689.110000000000",
"net_unrealized_appreciation": "4566807.660000000000"
},
"month_1_flow": {
"redemption": "-2555820.560000000000",
"reinvestment": ".000000000000",
"sales": "127367.110000000000"
},
"month_2_flow": {
"redemption": "-3177883.990000000000",
"reinvestment": ".000000000000",
"sales": "769141.370000000000"
},
"month_3_flow": {
"redemption": "-3281011.540000000000",
"reinvestment": "4079781.690000000000",
"sales": "240630.130000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "-68969.790000000000",
"net_unrealized_appreciation": "455219.160000000000"
},
"month2": {
"net_realized_gain": "-107563.080000000000",
"net_unrealized_appreciation": "-708108.530000000000"
},
"month3": {
"net_realized_gain": "162179.700000000000",
"net_unrealized_appreciation": "2346.670000000000"
},
"future_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon2": {
"net_realized_gain": "102949.590000000000",
"net_unrealized_appreciation": "N/A"
},
"instrmon3": {
"net_realized_gain": "199347.040000000000",
"net_unrealized_appreciation": "51156.750000000000"
}
},
"option_category": {
"instrmon1": {
"net_realized_gain": "-68969.790000000000",
"net_unrealized_appreciation": "455219.160000000000"
},
"instrmon2": {
"net_realized_gain": "-210512.670000000000",
"net_unrealized_appreciation": "-708108.530000000000"
},
"instrmon3": {
"net_realized_gain": "-37167.340000000000",
"net_unrealized_appreciation": "-48810.080000000000"
}
}
}
}
}
},
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-09-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-11-23",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "1.610000000000",
"rtn2": "5.250000000000",
"rtn3": "-3.730000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "1.580000000000",
"rtn2": "5.280000000000",
"rtn3": "-3.750000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "1.500000000000",
"rtn2": "5.220000000000",
"rtn3": "-3.810000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "1.590000000000",
"rtn2": "5.310000000000",
"rtn3": "-3.740000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "17728.310000000000",
"net_unrealized_appreciation": "2149139.690000000000"
},
"other_monthly2": {
"net_realized_gain": "425818.750000000000",
"net_unrealized_appreciation": "5464610.260000000000"
},
"other_monthly3": {
"net_realized_gain": "-1692066.620000000000",
"net_unrealized_appreciation": "-2557720.590000000000"
},
"month_1_flow": {
"redemption": "-3327168.330000000000",
"reinvestment": ".000000000000",
"sales": "382606.240000000000"
},
"month_2_flow": {
"redemption": "-3852681.050000000000",
"reinvestment": ".000000000000",
"sales": "120353.170000000000"
},
"month_3_flow": {
"redemption": "-2077752.460000000000",
"reinvestment": ".000000000000",
"sales": "118110.300000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-417175.900000000000"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-337050.000000000000"
},
"month3": {
"net_realized_gain": "-431129.000000000000",
"net_unrealized_appreciation": "538894.960000000000"
},
"option_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-417175.900000000000"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-337050.000000000000"
},
"instrmon3": {
"net_realized_gain": "-431129.000000000000",
"net_unrealized_appreciation": "538894.960000000000"
}
}
}
}
}
},
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-06-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-08-11",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "11.730000000000",
"rtn2": "5.690000000000",
"rtn3": "-1.100000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "11.710000000000",
"rtn2": "5.690000000000",
"rtn3": "-1.110000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "11.610000000000",
"rtn2": "5.620000000000",
"rtn3": "-1.130000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "11.730000000000",
"rtn2": "5.720000000000",
"rtn3": "-1.080000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "-2130751.400000000000",
"net_unrealized_appreciation": "13968148.260000000000"
},
"other_monthly2": {
"net_realized_gain": "52361.540000000000",
"net_unrealized_appreciation": "6134166.550000000000"
},
"other_monthly3": {
"net_realized_gain": "-314956.190000000000",
"net_unrealized_appreciation": "-1040043.970000000000"
},
"month_1_flow": {
"redemption": "-2606649.580000000000",
"reinvestment": ".000000000000",
"sales": "436922.980000000000"
},
"month_2_flow": {
"redemption": "-3384584.510000000000",
"reinvestment": ".000000000000",
"sales": "699109.070000000000"
},
"month_3_flow": {
"redemption": "-3494245.050000000000",
"reinvestment": ".000000000000",
"sales": "408949.640000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"month3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "163161.150000000000"
},
"option_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "163161.150000000000"
}
}
}
}
}
},
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-03-31",
"end_report_period": "2020-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-05-28",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "-1.380000000000",
"rtn2": "-8.420000000000",
"rtn3": "-18.560000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "-1.390000000000",
"rtn2": "-8.430000000000",
"rtn3": "-18.530000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "-1.390000000000",
"rtn2": "-8.540000000000",
"rtn3": "-18.570000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "-1.400000000000",
"rtn2": "-8.400000000000",
"rtn3": "-18.510000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "-1536818.810000000000",
"net_unrealized_appreciation": "-263003.810000000000"
},
"other_monthly2": {
"net_realized_gain": "-253.590000000000",
"net_unrealized_appreciation": "-11963363.090000000000"
},
"other_monthly3": {
"net_realized_gain": "2889957.560000000000",
"net_unrealized_appreciation": "-27422527.950000000000"
},
"month_1_flow": {
"redemption": "-2904481.300000000000",
"reinvestment": ".000000000000",
"sales": "596938.080000000000"
},
"month_2_flow": {
"redemption": "-2857512.430000000000",
"reinvestment": ".000000000000",
"sales": "600369.900000000000"
},
"month_3_flow": {
"redemption": "-4990773.570000000000",
"reinvestment": ".000000000000",
"sales": "689616.070000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-749.980000000000"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"month3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"warrant_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-749.980000000000"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
}
}
}
}
}
}
]
}
}
https://api.finnworlds.com/api/v1/etfholdings
?key=API-KEY
&series_id=S000005505
&date_from=2020-09-01&date_to=2020-12-30
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-09-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-11-23",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"holdings": [
{
"investment_security": {
"name": "Altria Group Inc",
"lei": "XSGZFLO9YTNO9VCQV219",
"isin": "US02209S1033",
"cusip": "02209S103",
"balance": "40000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1545600.000000000000",
"percent_value": "1.4645203739",
"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": "BAE Systems PLC",
"lei": "8SVCSVKSGDWMW2QHOH83",
"isin": "GB0002634946",
"cusip": "G06940103",
"balance": "469194.000000000000",
"units": "NS",
"currency": "GBP",
"value_usd": "2918159.280000000000",
"percent_value": "2.7650774585",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Boeing Co/The",
"lei": "RVHJWBXLJ1RFUBSY1F30",
"isin": "US0970231058",
"cusip": "097023105",
"balance": "17000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "2809420.000000000000",
"percent_value": "2.6620424618",
"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": "British American Tobacco PLC",
"lei": "213800FKA5MF17RJKT63",
"isin": "US1104481072",
"cusip": "110448107",
"balance": "143000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5169450.000000000000",
"percent_value": "4.8982691816",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "Y"
}
},
{
"investment_security": {
"name": "Cameco Corp",
"lei": "N4BHALMXL3GMZKCUON55",
"isin": "CA13321L1085",
"cusip": "13321L108",
"balance": "500000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5050000.000000000000",
"percent_value": "4.7850853315",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "CA",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Constellation Brands Inc",
"lei": "5493005GKEG8QCVY7037",
"isin": "US21036P1084",
"cusip": "21036P108",
"balance": "19000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "3600690.000000000000",
"percent_value": "3.4118037430",
"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": "Diageo PLC",
"lei": "213800ZVIELEA55JMJ32",
"isin": "US25243Q2057",
"cusip": "25243Q205",
"balance": "39500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5437570.000000000000",
"percent_value": "5.1523240487",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "DraftKings Inc",
"lei": "5493008P45UYYL683Z97",
"isin": "US26142R1041",
"cusip": "26142R104",
"balance": "100000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5884000.000000000000",
"percent_value": "5.5753350674",
"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": "Y"
}
},
{
"investment_security": {
"name": "First American Treasury Obliga",
"lei": "N/A",
"isin": "US31846V3289",
"cusip": "31846V328",
"balance": "607103.830000000000",
"units": "NS",
"currency": "USD",
"value_usd": "607103.830000000000",
"percent_value": "0.5752561647",
"payoff_profile": "Long",
"asset_category": "STIV",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
ETC
}
]
}
]
}
}
https://api.finnworlds.com/api/v1/etfreturns
?key=API-KEY
&series_id=S000005505
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"signature": {
"date_signed": "2021-02-09",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "Richard Sapio",
"title": "President"
},
"holdings": [
{
"investment_security": {
"name": "BAE Systems PLC",
"lei": "8SVCSVKSGDWMW2QHOH83",
"isin": "GB0002634946",
"cusip": "G06940103",
"balance": "477704.000000000000",
"units": "NS",
"currency": "GBP",
"value_usd": "3193142.180000000000",
"percent_value": "2.9108553049",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "British American Tobacco PLC",
"lei": "213800FKA5MF17RJKT63",
"isin": "US1104481072",
"cusip": "110448107",
"balance": "143000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5361070.000000000000",
"percent_value": "4.8871294073",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Cameco Corp",
"lei": "N4BHALMXL3GMZKCUON55",
"isin": "CA13321L1085",
"cusip": "13321L108",
"balance": "500000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "6700000.000000000000",
"percent_value": "6.1076924996",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "CA",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Constellation Brands Inc",
"lei": "5493005GKEG8QCVY7037",
"isin": "US21036P1084",
"cusip": "21036P108",
"balance": "19000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "4161950.000000000000",
"percent_value": "3.7940165371",
"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": "Diageo PLC",
"lei": "213800ZVIELEA55JMJ32",
"isin": "US25243Q2057",
"cusip": "25243Q205",
"balance": "39500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "6272995.000000000000",
"percent_value": "5.7184364943",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Direxion Russell 1000 Value Ov",
"lei": "5493003NCTXSFN4SD519",
"isin": "US25460E4558",
"cusip": "25460E455",
"balance": "7000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "343727.300000000000",
"percent_value": "0.3133403958",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "DraftKings Inc",
"lei": "5493008P45UYYL683Z97",
"isin": "US26142R1041",
"cusip": "26142R104",
"balance": "100000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "4656000.000000000000",
"percent_value": "4.2443904893",
"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": "Y"
}
},
{
"investment_security": {
"name": "First American Treasury Obliga",
"lei": "N/A",
"isin": "US31846V3289",
"cusip": "31846V328",
"balance": "851.730000000000",
"units": "NS",
"currency": "USD",
"value_usd": "851.730000000000",
"percent_value": "0.0007764336",
"payoff_profile": "Long",
"asset_category": "STIV",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Gaming and Leisure Properties",
"lei": "5493006GWRDBCZYWTM57",
"isin": "US36467J1088",
"cusip": "36467J108",
"balance": "28322.427000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1200870.900000000000",
"percent_value": "1.0947089834",
"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": {
ETC
}
}
}
}
}
}
]
}
}
https://api.finnworlds.com/api/v1/etfreturns
?key=API-KEY
&series_id=S000005505
&date_from=2020-09-01&date_to=2020-12-30
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-09-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-11-23",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"holdings": [
{
"investment_security": {
"name": "Altria Group Inc",
"lei": "XSGZFLO9YTNO9VCQV219",
"isin": "US02209S1033",
"cusip": "02209S103",
"balance": "40000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1545600.000000000000",
"percent_value": "1.4645203739",
"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": "BAE Systems PLC",
"lei": "8SVCSVKSGDWMW2QHOH83",
"isin": "GB0002634946",
"cusip": "G06940103",
"balance": "469194.000000000000",
"units": "NS",
"currency": "GBP",
"value_usd": "2918159.280000000000",
"percent_value": "2.7650774585",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Boeing Co/The",
"lei": "RVHJWBXLJ1RFUBSY1F30",
"isin": "US0970231058",
"cusip": "097023105",
"balance": "17000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "2809420.000000000000",
"percent_value": "2.6620424618",
"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": "British American Tobacco PLC",
"lei": "213800FKA5MF17RJKT63",
"isin": "US1104481072",
"cusip": "110448107",
"balance": "143000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5169450.000000000000",
"percent_value": "4.8982691816",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "Y"
}
},
{
"investment_security": {
"name": "Cameco Corp",
"lei": "N4BHALMXL3GMZKCUON55",
"isin": "CA13321L1085",
"cusip": "13321L108",
"balance": "500000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5050000.000000000000",
"percent_value": "4.7850853315",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "CA",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Constellation Brands Inc",
"lei": "5493005GKEG8QCVY7037",
"isin": "US21036P1084",
"cusip": "21036P108",
"balance": "19000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "3600690.000000000000",
"percent_value": "3.4118037430",
"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": "Diageo PLC",
"lei": "213800ZVIELEA55JMJ32",
"isin": "US25243Q2057",
"cusip": "25243Q205",
"balance": "39500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5437570.000000000000",
"percent_value": "5.1523240487",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "DraftKings Inc",
"lei": "5493008P45UYYL683Z97",
"isin": "US26142R1041",
"cusip": "26142R104",
"balance": "100000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5884000.000000000000",
"percent_value": "5.5753350674",
"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": "Y"
}
},
{
"investment_security": {
"name": "First American Treasury Obliga",
"lei": "N/A",
"isin": "US31846V3289",
"cusip": "31846V328",
"balance": "607103.830000000000",
"units": "NS",
"currency": "USD",
"value_usd": "607103.830000000000",
"percent_value": "0.5752561647",
"payoff_profile": "Long",
"asset_category": "STIV",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Gaming and Leisure Properties",
"lei": "5493006GWRDBCZYWTM57",
"isin": "US36467J1088",
"cusip": "36467J108",
"balance": "27936.930000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1031710.820000000000",
"percent_value": "0.9775889725",
"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": "General Dynamics Corp",
"lei": "9C1X8XOOTYY2FNYTVH06",
"isin": "US3695501086",
"cusip": "369550108",
"balance": "26500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "3668395.000000000000",
"percent_value": "3.4759570504",
"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": {
ETC
}
}
]
}
]
}
}
GET Request Parameters
Endpoints:
GET /etfinfo – Basic information about the ETF
GET /etfreturns – Returns or periodical returns of the ETF
GET /etfholdings – Holdings of the ETF at any point in time
| Objects | Description |
| cik | SEC assigned key of the main trust fund |
| reg lei | LEI identifier of the main trust fund |
| series_id | The ID of the ETF held by the fund |
| series_lei | The LEI of the ETF held by the fund |
| date_from / date_to | Date range YYYY-MM-DD based on “date_report_period”, the starting date of the reporting period of the ETF |
API Response Objects
| Response Objects | Description |
| name | Name of the security |
| lei | lei of the security |
| isin | ISIN of the security |
| cusip | Cusip of the security |
| balance | balance held in this security |
| units | Number of units held in this security |
| currency | The currency of this security |
| value_usd | The value in USD of this security holding |
| percent_value | Percentage of the total value of the security |
| payoff_profile | Payoff profile of security, for example “long” |
| asset_category | x |
| issuer_category | x |
| invested_country | Country where the security is based |
| restricted_sec | x |
| fair_value_level | x |
| cash_collateral | x |
| non_cash_collateral | x |
| loan_by_fund | x |
Mutual Fund Holdings
Information about mutual funds and which stocks they hold. This includes the total owned shares, percentage of their portfolio. Different endpoint examples are provided with the Json response for it. You can also use this to identify which mutual funds are holding a certain stock.
https://api.finnworlds.com/api/v1/mutualfundinfo
?key=API-KEY
&cik=1137095
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"general": {
"fund_name": "USA Mutuals",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93",
"country": "US",
"state": "US-TX",
"city": "Dallas",
"zip": "75201",
"street": "700 N. Pearl Street",
"phone": "866-264-8783"
},
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"fund_info": {
"total_assets": "111438858.600000000000",
"total_liabilities": "1741129.050000000000",
"net_assets": "109697729.550000000000",
"assets_attr_misc_sec": "0.000000000000",
"invested_assets": "0.000000000000",
"one_yr_banks_borr": "591000.000000000000",
"one_yr_ctrld_comp": "0.000000000000",
"one_yr_oth_affil": "0.000000000000",
"one_yr_other": "0.000000000000",
"aft_one_yr_banks_borr": "0.000000000000",
"aft_one_yr_ctrld_comp": "0.000000000000",
"aft_one_yr_oth_affil": "0.000000000000",
"aft_one_yr_other": "0.000000000000",
"delivery_delay": "0.000000000000",
"standby_commit": "0.000000000000",
"liquid_pref": "0.000000000000",
"cash_not_reported_in_cor_d": "2545141.120000000000",
"non_cash_collateral": "N",
"currency": "Null"
}
},
{
"general": {
"fund_name": "USA Mutuals",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93",
"country": "US",
"state": "US-TX",
"city": "Dallas",
"zip": "75201",
"street": "700 N. Pearl Street",
"phone": "866-264-8783"
},
"attributes": {
"series_name": "USA Mutuals Navigator Fund",
"series_id": "S000058976",
"series_lei": "549300CS0EIS27ZLBG68",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"fund_info": {
"total_assets": "44290035.570000000000",
"total_liabilities": "208427.160000000000",
"net_assets": "44081608.410000000000",
"assets_attr_misc_sec": "0.000000000000",
"invested_assets": "0.000000000000",
"one_yr_banks_borr": "0.000000000000",
"one_yr_ctrld_comp": "0.000000000000",
"one_yr_oth_affil": "0.000000000000",
"one_yr_other": "0.000000000000",
"aft_one_yr_banks_borr": "0.000000000000",
"aft_one_yr_ctrld_comp": "0.000000000000",
"aft_one_yr_oth_affil": "0.000000000000",
"aft_one_yr_other": "0.000000000000",
"delivery_delay": "0.000000000000",
"standby_commit": "0.000000000000",
"liquid_pref": "0.000000000000",
"cash_not_reported_in_cor_d": "34462732.210000000000",
"non_cash_collateral": "N",
"currency": "Null"
}
}
]
}
}
https://api.finnworlds.com/api/v1/mutualfundinfo
?key=API-KEY
&cik=1137095
&series_id=S000005505
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"general": {
"fund_name": "USA Mutuals",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93",
"country": "US",
"state": "US-TX",
"city": "Dallas",
"zip": "75201",
"street": "700 N. Pearl Street",
"phone": "866-264-8783"
},
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"fund_info": {
"total_assets": "111438858.600000000000",
"total_liabilities": "1741129.050000000000",
"net_assets": "109697729.550000000000",
"assets_attr_misc_sec": "0.000000000000",
"invested_assets": "0.000000000000",
"one_yr_banks_borr": "591000.000000000000",
"one_yr_ctrld_comp": "0.000000000000",
"one_yr_oth_affil": "0.000000000000",
"one_yr_other": "0.000000000000",
"aft_one_yr_banks_borr": "0.000000000000",
"aft_one_yr_ctrld_comp": "0.000000000000",
"aft_one_yr_oth_affil": "0.000000000000",
"aft_one_yr_other": "0.000000000000",
"delivery_delay": "0.000000000000",
"standby_commit": "0.000000000000",
"liquid_pref": "0.000000000000",
"cash_not_reported_in_cor_d": "2545141.120000000000",
"non_cash_collateral": "N",
"currency": "Null"
}
}
]
}
}
https://api.finnworlds.com/api/v1/mutualfundreturns
?key=API-KEY
&series_id=S000005505
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"signature": {
"date_signed": "2021-02-09",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "Richard Sapio",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "-6.820000000000",
"rtn2": "15.030000000000",
"rtn3": "4.540000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "-6.780000000000",
"rtn2": "15.000000000000",
"rtn3": "4.530000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "-6.850000000000",
"rtn2": "14.920000000000",
"rtn3": "4.520000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "-6.780000000000",
"rtn2": "15.060000000000",
"rtn3": "4.560000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "1047242.290000000000",
"net_unrealized_appreciation": "-8495540.410000000000"
},
"other_monthly2": {
"net_realized_gain": "682677.450000000000",
"net_unrealized_appreciation": "14452752.560000000000"
},
"other_monthly3": {
"net_realized_gain": "81689.110000000000",
"net_unrealized_appreciation": "4566807.660000000000"
},
"month_1_flow": {
"redemption": "-2555820.560000000000",
"reinvestment": ".000000000000",
"sales": "127367.110000000000"
},
"month_2_flow": {
"redemption": "-3177883.990000000000",
"reinvestment": ".000000000000",
"sales": "769141.370000000000"
},
"month_3_flow": {
"redemption": "-3281011.540000000000",
"reinvestment": "4079781.690000000000",
"sales": "240630.130000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "-68969.790000000000",
"net_unrealized_appreciation": "455219.160000000000"
},
"month2": {
"net_realized_gain": "-107563.080000000000",
"net_unrealized_appreciation": "-708108.530000000000"
},
"month3": {
"net_realized_gain": "162179.700000000000",
"net_unrealized_appreciation": "2346.670000000000"
},
"future_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon2": {
"net_realized_gain": "102949.590000000000",
"net_unrealized_appreciation": "N/A"
},
"instrmon3": {
"net_realized_gain": "199347.040000000000",
"net_unrealized_appreciation": "51156.750000000000"
}
},
"option_category": {
"instrmon1": {
"net_realized_gain": "-68969.790000000000",
"net_unrealized_appreciation": "455219.160000000000"
},
"instrmon2": {
"net_realized_gain": "-210512.670000000000",
"net_unrealized_appreciation": "-708108.530000000000"
},
"instrmon3": {
"net_realized_gain": "-37167.340000000000",
"net_unrealized_appreciation": "-48810.080000000000"
}
}
}
}
}
},
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-09-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-11-23",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "1.610000000000",
"rtn2": "5.250000000000",
"rtn3": "-3.730000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "1.580000000000",
"rtn2": "5.280000000000",
"rtn3": "-3.750000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "1.500000000000",
"rtn2": "5.220000000000",
"rtn3": "-3.810000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "1.590000000000",
"rtn2": "5.310000000000",
"rtn3": "-3.740000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "17728.310000000000",
"net_unrealized_appreciation": "2149139.690000000000"
},
"other_monthly2": {
"net_realized_gain": "425818.750000000000",
"net_unrealized_appreciation": "5464610.260000000000"
},
"other_monthly3": {
"net_realized_gain": "-1692066.620000000000",
"net_unrealized_appreciation": "-2557720.590000000000"
},
"month_1_flow": {
"redemption": "-3327168.330000000000",
"reinvestment": ".000000000000",
"sales": "382606.240000000000"
},
"month_2_flow": {
"redemption": "-3852681.050000000000",
"reinvestment": ".000000000000",
"sales": "120353.170000000000"
},
"month_3_flow": {
"redemption": "-2077752.460000000000",
"reinvestment": ".000000000000",
"sales": "118110.300000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-417175.900000000000"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-337050.000000000000"
},
"month3": {
"net_realized_gain": "-431129.000000000000",
"net_unrealized_appreciation": "538894.960000000000"
},
"option_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-417175.900000000000"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-337050.000000000000"
},
"instrmon3": {
"net_realized_gain": "-431129.000000000000",
"net_unrealized_appreciation": "538894.960000000000"
}
}
}
}
}
},
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-06-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-08-11",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "11.730000000000",
"rtn2": "5.690000000000",
"rtn3": "-1.100000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "11.710000000000",
"rtn2": "5.690000000000",
"rtn3": "-1.110000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "11.610000000000",
"rtn2": "5.620000000000",
"rtn3": "-1.130000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "11.730000000000",
"rtn2": "5.720000000000",
"rtn3": "-1.080000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "-2130751.400000000000",
"net_unrealized_appreciation": "13968148.260000000000"
},
"other_monthly2": {
"net_realized_gain": "52361.540000000000",
"net_unrealized_appreciation": "6134166.550000000000"
},
"other_monthly3": {
"net_realized_gain": "-314956.190000000000",
"net_unrealized_appreciation": "-1040043.970000000000"
},
"month_1_flow": {
"redemption": "-2606649.580000000000",
"reinvestment": ".000000000000",
"sales": "436922.980000000000"
},
"month_2_flow": {
"redemption": "-3384584.510000000000",
"reinvestment": ".000000000000",
"sales": "699109.070000000000"
},
"month_3_flow": {
"redemption": "-3494245.050000000000",
"reinvestment": ".000000000000",
"sales": "408949.640000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"month3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "163161.150000000000"
},
"option_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "163161.150000000000"
}
}
}
}
}
},
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-03-31",
"end_report_period": "2020-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-05-28",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "-1.380000000000",
"rtn2": "-8.420000000000",
"rtn3": "-18.560000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "-1.390000000000",
"rtn2": "-8.430000000000",
"rtn3": "-18.530000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "-1.390000000000",
"rtn2": "-8.540000000000",
"rtn3": "-18.570000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "-1.400000000000",
"rtn2": "-8.400000000000",
"rtn3": "-18.510000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "-1536818.810000000000",
"net_unrealized_appreciation": "-263003.810000000000"
},
"other_monthly2": {
"net_realized_gain": "-253.590000000000",
"net_unrealized_appreciation": "-11963363.090000000000"
},
"other_monthly3": {
"net_realized_gain": "2889957.560000000000",
"net_unrealized_appreciation": "-27422527.950000000000"
},
"month_1_flow": {
"redemption": "-2904481.300000000000",
"reinvestment": ".000000000000",
"sales": "596938.080000000000"
},
"month_2_flow": {
"redemption": "-2857512.430000000000",
"reinvestment": ".000000000000",
"sales": "600369.900000000000"
},
"month_3_flow": {
"redemption": "-4990773.570000000000",
"reinvestment": ".000000000000",
"sales": "689616.070000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-749.980000000000"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"month3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"warrant_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-749.980000000000"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
}
}
}
}
}
}
]
}
}
https://api.finnworlds.com/api/v1/mutualfundreturns
?key=API-KEY
&series_id=S000005505
&date_from=2020-09-01&date_to=2020-12-30
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-09-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-11-23",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "1.610000000000",
"rtn2": "5.250000000000",
"rtn3": "-3.730000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "1.580000000000",
"rtn2": "5.280000000000",
"rtn3": "-3.750000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "1.500000000000",
"rtn2": "5.220000000000",
"rtn3": "-3.810000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "1.590000000000",
"rtn2": "5.310000000000",
"rtn3": "-3.740000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "17728.310000000000",
"net_unrealized_appreciation": "2149139.690000000000"
},
"other_monthly2": {
"net_realized_gain": "425818.750000000000",
"net_unrealized_appreciation": "5464610.260000000000"
},
"other_monthly3": {
"net_realized_gain": "-1692066.620000000000",
"net_unrealized_appreciation": "-2557720.590000000000"
},
"month_1_flow": {
"redemption": "-3327168.330000000000",
"reinvestment": ".000000000000",
"sales": "382606.240000000000"
},
"month_2_flow": {
"redemption": "-3852681.050000000000",
"reinvestment": ".000000000000",
"sales": "120353.170000000000"
},
"month_3_flow": {
"redemption": "-2077752.460000000000",
"reinvestment": ".000000000000",
"sales": "118110.300000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-417175.900000000000"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-337050.000000000000"
},
"month3": {
"net_realized_gain": "-431129.000000000000",
"net_unrealized_appreciation": "538894.960000000000"
},
"option_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-417175.900000000000"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-337050.000000000000"
},
"instrmon3": {
"net_realized_gain": "-431129.000000000000",
"net_unrealized_appreciation": "538894.960000000000"
}
}
}
}
}
}
]
}
}
https://api.finnworlds.com/api/v1/mutualfundholdings
?key=API-KEY
&series_id=S000005505
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"signature": {
"date_signed": "2021-02-09",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "Richard Sapio",
"title": "President"
},
"holdings": [
{
"investment_security": {
"name": "BAE Systems PLC",
"lei": "8SVCSVKSGDWMW2QHOH83",
"isin": "GB0002634946",
"cusip": "G06940103",
"balance": "477704.000000000000",
"units": "NS",
"currency": "GBP",
"value_usd": "3193142.180000000000",
"percent_value": "2.9108553049",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "British American Tobacco PLC",
"lei": "213800FKA5MF17RJKT63",
"isin": "US1104481072",
"cusip": "110448107",
"balance": "143000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5361070.000000000000",
"percent_value": "4.8871294073",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Cameco Corp",
"lei": "N4BHALMXL3GMZKCUON55",
"isin": "CA13321L1085",
"cusip": "13321L108",
"balance": "500000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "6700000.000000000000",
"percent_value": "6.1076924996",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "CA",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Constellation Brands Inc",
"lei": "5493005GKEG8QCVY7037",
"isin": "US21036P1084",
"cusip": "21036P108",
"balance": "19000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "4161950.000000000000",
"percent_value": "3.7940165371",
"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": "Diageo PLC",
"lei": "213800ZVIELEA55JMJ32",
"isin": "US25243Q2057",
"cusip": "25243Q205",
"balance": "39500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "6272995.000000000000",
"percent_value": "5.7184364943",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Direxion Russell 1000 Value Ov",
"lei": "5493003NCTXSFN4SD519",
"isin": "US25460E4558",
"cusip": "25460E455",
"balance": "7000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "343727.300000000000",
"percent_value": "0.3133403958",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "DraftKings Inc",
"lei": "5493008P45UYYL683Z97",
"isin": "US26142R1041",
"cusip": "26142R104",
"balance": "100000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "4656000.000000000000",
"percent_value": "4.2443904893",
"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": "Y"
}
},
{
"investment_security": {
"name": "First American Treasury Obliga",
"lei": "N/A",
"isin": "US31846V3289",
"cusip": "31846V328",
"balance": "851.730000000000",
"units": "NS",
"currency": "USD",
"value_usd": "851.730000000000",
"percent_value": "0.0007764336",
"payoff_profile": "Long",
"asset_category": "STIV",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Gaming and Leisure Properties",
"lei": "5493006GWRDBCZYWTM57",
"isin": "US36467J1088",
"cusip": "36467J108",
"balance": "28322.427000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1200870.900000000000",
"percent_value": "1.0947089834",
"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": {
ETC
}
}
}
}
}
}
]
}
}
https://api.finnworlds.com/api/v1/mutualfundholdings
?key=API-KEY
&series_id=S000005505
&date_from=2020-09-01&date_to=2020-12-30
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-09-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-11-23",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"holdings": [
{
"investment_security": {
"name": "Altria Group Inc",
"lei": "XSGZFLO9YTNO9VCQV219",
"isin": "US02209S1033",
"cusip": "02209S103",
"balance": "40000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1545600.000000000000",
"percent_value": "1.4645203739",
"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": "BAE Systems PLC",
"lei": "8SVCSVKSGDWMW2QHOH83",
"isin": "GB0002634946",
"cusip": "G06940103",
"balance": "469194.000000000000",
"units": "NS",
"currency": "GBP",
"value_usd": "2918159.280000000000",
"percent_value": "2.7650774585",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Boeing Co/The",
"lei": "RVHJWBXLJ1RFUBSY1F30",
"isin": "US0970231058",
"cusip": "097023105",
"balance": "17000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "2809420.000000000000",
"percent_value": "2.6620424618",
"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": "British American Tobacco PLC",
"lei": "213800FKA5MF17RJKT63",
"isin": "US1104481072",
"cusip": "110448107",
"balance": "143000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5169450.000000000000",
"percent_value": "4.8982691816",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "Y"
}
},
{
"investment_security": {
"name": "Cameco Corp",
"lei": "N4BHALMXL3GMZKCUON55",
"isin": "CA13321L1085",
"cusip": "13321L108",
"balance": "500000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5050000.000000000000",
"percent_value": "4.7850853315",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "CA",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Constellation Brands Inc",
"lei": "5493005GKEG8QCVY7037",
"isin": "US21036P1084",
"cusip": "21036P108",
"balance": "19000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "3600690.000000000000",
"percent_value": "3.4118037430",
"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": "Diageo PLC",
"lei": "213800ZVIELEA55JMJ32",
"isin": "US25243Q2057",
"cusip": "25243Q205",
"balance": "39500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5437570.000000000000",
"percent_value": "5.1523240487",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "DraftKings Inc",
"lei": "5493008P45UYYL683Z97",
"isin": "US26142R1041",
"cusip": "26142R104",
"balance": "100000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5884000.000000000000",
"percent_value": "5.5753350674",
"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": "Y"
}
},
{
"investment_security": {
"name": "First American Treasury Obliga",
"lei": "N/A",
"isin": "US31846V3289",
"cusip": "31846V328",
"balance": "607103.830000000000",
"units": "NS",
"currency": "USD",
"value_usd": "607103.830000000000",
"percent_value": "0.5752561647",
"payoff_profile": "Long",
"asset_category": "STIV",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
ETC
}
]
}
]
}
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| fund_ticker_symbol | Fund for which you want to know the portfolio |
| fund_isin_identifier | ISIN identifier for the fund for which you want to know the portfolio |
| stock_ticker_symbol | The stock security of which you want to know the ETFs that have invested in it. |
| exchange | The exchange platform where the stock security trades on |
| stock_isin_identifier | The ISIN identifier of the stock security of which you want to know the ETFs that have invested in it. |
| date | The date from which you would like to have the data. It will take the data from the report released closest before the input date. |
API Response Objects
| Response Objects | Description |
| name | Name of the company or Fund |
| fund_ticker_symbol | ETF for which you want to know the portfolio |
| fund_isin_identifier | ISIN identifier for the Fund for which you want to know the portfolio |
| exchange | Exchange where the security is trade on |
| Â | Â |
| date_of_update | The date of the data provided |
| number_of_holdings | The number of securities held by the Funds |
| Â | Â |
| holdings | Following will be the portfolio information |
| stock_ticker_symbol | The ticker symbol of the stock security |
| exchange | Exchange where the security is trade on |
| stock_isin_identifier | The ISIN identifier of the stock security of which you want to know the Funds that have invested in it. |
| number_of_shares | The number of shares owned by the Fund |
| percentage_of_portfolio | The percentage within the Fund’s portfolio |
| market_value_of_those_shares | The market value of those shares at the time of report |
| Â | Â |
Search Terms and Volumes
Search terms and volumes and trends related to stock searches and stock questions as well as the volume. Use this to find related stocks according to google searches. Compare search volumes and trends over time. Different endpoint examples are provided with the Json response for it. Uses Google SERP, Google Trends, Google ads search volume
https://finnworlds.com/api/v1/searchtrends
?key=YOUR-KEY
&stock_ticker_symbol=AAPL
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
},
"terms": {
"search_term": "apple stock"
"search_question": "is apple a good stock to buy?"
},
"output": {
"related_term": "apple stock predictions 2025"
"related_term_volume": "20000"
"related_term": "microsoft stock"
"related_term_volume": "8700000"
"related_term": "amazon stock"
"related_term_volume": "1100000"
"related_term": "apple stock price"
"related_term_volume": "1350000"
"related_question": "can apple stock reach 1000?"
"related_question_volume": "13200"
"related_question": "should I buy apple stock 2021?"
"related_question_volume": "32000"
},
}
[
}
https://finnworlds.com/api/v1/searchtrends
?key=YOUR-KEY
&isin_identifier=US0378331005
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
},
"terms": {
"search_term": "apple stock"
"search_question": "is apple a good stock to buy?"
},
"output": {
"related_term": "apple stock predictions 2025"
"related_term_volume": "20000"
"related_term": "microsoft stock"
"related_term_volume": "8700000"
"related_term": "amazon stock"
"related_term_volume": "1100000"
"related_term": "apple stock price"
"related_term_volume": "1350000"
"related_question": "can apple stock reach 1000?"
"related_question_volume": "13200"
"related_question": "should I buy apple stock 2021?"
"related_question_volume": "32000"
},
}
[
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| stock_ticker_symbol | Ticker of the security for which you want search trends and volumes |
| exchange | The exchange platform where the security trades on |
| stock_isin_identifier | ISIN of the security for which you want search trends and volumes |
| date_from | Set the date range from whitin which you want the results |
| date_to | Set the date range from whitin which you want the results |
API Response Objects
| Response Objects | Description |
| name | Name of the company or Fund |
| stock_ticker_symbol | Ticker symbol of security |
| exchange | Exchange where the security is trade on |
| stock_isin_identifier | ISIN identifier of security |
| Â | Â |
| search_term | Search terms we have available (apple stock price, …) |
| search_question | Search questions we have available (is apple stock worth buying?, …) |
| related_terms | Terms searched by people, related to original search term (fb stock price, amazon stock price, …) |
| related_questions | Questions related to the original search question (why apple stock price is so expensive?, …) |
| stock_ticker_symbol | The ticker symbol of the stock security |
| search_term_volume | Volume per month of original search term |
| related_ search_term_volume | Volume per month of related search terms |
| search_question_volume | Volume per month of original search question |
| related_search_question_volume | Volume per month of related search question |
| Search_term_trend | Volume currently compared to 12 month average. For more details, you need to use date ranges and build this data yourself |
| Â | Â |
| Â | Â |
SEC filing
Get details about SEC filings of all reports aswell as being able to extract segments of data from it or the entire report.Â
https://finnworlds.com/api/v1/secfilings
?key=YOUR-KEY
&stock_ticker_symbol=AAPL&year=2021
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
},
"output": {
"form_type": "10-Q"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2021-04-29"
"reporting_date": "2021-03-27"
},
{
"form_type": "8K"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2021-04-29"
"reporting_date": "2021-03-27"
},
{
"form_type": "10-Q"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2021-04-29"
"reporting_date": "2021-03-27"
},
}
]
}
https://finnworlds.com/api/v1/secfilings
?key=YOUR-KEY
&isin_identifier=US0378331005&year=2021
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
},
"output": {
"form_type": "10-Q"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2021-04-29"
"reporting_date": "2021-03-27"
},
{
"form_type": "8K"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2021-04-29"
"reporting_date": "2021-03-27"
},
{
"form_type": "10-Q"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2021-04-29"
"reporting_date": "2021-03-27"
},
}
]
}
https://finnworlds.com/api/v1/secfilings
?key=YOUR-KEY
&isin_identifier=US0378331005&form_type=10-Q
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
},
"output": {
"form_type": "10-Q"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2021-04-29"
"reporting_date": "2021-03-27"
},
{
"form_type": "10-Q"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2021-01-29"
"reporting_date": "2020-12-27"
},
{
"form_type": "10-Q"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2020-09-29"
"reporting_date": "2020-08-27"
},
{
"form_type": "10-Q"
"title": "Quarterly Report [Sections 13 or 15(d)]"
"link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
"filing_date": "2020-05-29"
"reporting_date": "2020-04-27"
},
}
]
}
GET Request Parameters
For bulk requests, input multiple values separated by commas.
| Objects | Description |
| stock_ticker_symbol | Ticker of the security for which you want SEC filings |
| exchange | The exchange platform where the security trades on |
| stock_isin_identifier | ISIN of the security for which you want search SEC filings of |
| form_type | The type of filing you wish to receive (10Q, 10K, 8K, …) |
| date | Choose a specific date from which you want a filing. |
API Response Objects
| Response Objects | Description |
| name | Name of the company or Fund |
| stock_ticker_symbol | Ticker symbol of security |
| exchange | Exchange where the security is trade on |
| stock_isin_identifier | ISIN identifier of security |
| Â | Â |
| Â | Â |
| form_type | Type of SEC filing (10Q, 10K, 8K, …) |
| title | Title of the SEC filing |
| link | URL link to the SEC website where the SEC filing can be downloaded |
| filing_date | Date of filing of the report |
| reporting_date | Date of the report being made |
| Â | Â |
| Â | Â |
| Â | Â |
| Â | Â |
| Â | Â |
| Â | Â |
Commodity prices
Get commodity prices of energy, metals, industrial, agricultural and livestock categories. Updated every minute.
https://api.finnworlds.com/api/v1/commodities
?key=API-key
&category=energy
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"category": "energy",
"commodity_name": "brent",
"commodity_unit": "usd/bbl",
"commodity_price": "90.398",
"price_change_day": "1.222",
"percentage_day": "-1.33%",
"percentage_week": "-4.13%",
"percentage_month": "-0.29%",
"percentage_year": "6.25%",
"quarter4_22": "104.512",
"quarter1_23": "105.802",
"quarter2_23": "95.713",
"quarter3_23": "99.325",
"date": "2022:10:18"
},
{
"category": "energy",
"commodity_name": "coal",
"commodity_unit": "usd/t",
"commodity_price": "392.15",
"price_change_day": "0.35",
"percentage_day": "-0.09%",
"percentage_week": "1.46%",
"percentage_month": "-10.68%",
"percentage_year": "63.84%",
"quarter4_22": "462.47",
"quarter1_23": "500.994",
"quarter2_23": "419.46",
"quarter3_23": "446.338",
"date": "2022:10:17"
},
{
"category": "energy",
"commodity_name": "crude oil",
"commodity_unit": "usd/bbl",
"commodity_price": "83.585",
"price_change_day": "1.876",
"percentage_day": "-2.19%",
"percentage_week": "-6.45%",
"percentage_month": "-2.08%",
"percentage_year": "2.56%",
"quarter4_22": "98.313",
"quarter1_23": "98.617",
"quarter2_23": "90.471",
"quarter3_23": "93.342",
"date": "2022:10:18"
},
{
"category": "energy",
"commodity_name": "ethanol",
"commodity_unit": "usd/gal",
"commodity_price": "2.415",
"price_change_day": "0.0100",
"percentage_day": "-0.41%",
"percentage_week": "-0.82%",
"percentage_month": "-1.83%",
"percentage_year": "-2.42%",
"quarter4_22": "2.743",
"quarter1_23": "2.764",
"quarter2_23": "2.553",
"quarter3_23": "2.608",
"date": "2022:10:17"
},
{
"category": "energy",
"commodity_name": "gasoline",
"commodity_unit": "usd/gal",
"commodity_price": "2.558",
"price_change_day": "0.0351",
"percentage_day": "-1.35%",
"percentage_week": "-2.64%",
"percentage_month": "5.92%",
"percentage_year": "3.33%",
"quarter4_22": "2.956",
"quarter1_23": "3.102",
"quarter2_23": "2.696",
"quarter3_23": "2.815",
"date": "2022:10:18"
},
{
"category": "energy",
"commodity_name": "heating oil",
"commodity_unit": "usd/gal",
"commodity_price": "4.018",
"price_change_day": "0.0672",
"percentage_day": "-1.64%",
"percentage_week": "2.22%",
"percentage_month": "23.30%",
"percentage_year": "57.46%",
"quarter4_22": "4.558",
"quarter1_23": "4.7",
"quarter2_23": "4.228",
"quarter3_23": "4.33",
"date": "2022:10:18"
},
{
"category": "energy",
"commodity_name": "methanol",
"commodity_unit": "cny/t",
"commodity_price": "2778",
"price_change_day": "17.00",
"percentage_day": "-0.61%",
"percentage_week": "-1.80%",
"percentage_month": "1.02%",
"percentage_year": "-26.06%",
"quarter4_22": "3045.201",
"quarter1_23": "3070.945",
"quarter2_23": "2949.509",
"quarter3_23": "2968.053",
"date": "2022:10:18"
},
{
"category": "energy",
"commodity_name": "naphtha",
"commodity_unit": "usd/t",
"commodity_price": "664.82",
"price_change_day": "4.10",
"percentage_day": "0.62%",
"percentage_week": "-1.82%",
"percentage_month": "5.40%",
"percentage_year": "-12.66%",
"quarter4_22": "721.416",
"quarter1_23": "732.233",
"quarter2_23": "671.769",
"quarter3_23": "696.244",
"date": "2022:10:17"
},
{
"category": "energy",
"commodity_name": "natural gas",
"commodity_unit": "usd/mmbtu",
"commodity_price": "5.7304",
"price_change_day": "0.2686",
"percentage_day": "-4.48%",
"percentage_week": "-13.12%",
"percentage_month": "-26.57%",
"percentage_year": "12.63%",
"quarter4_22": "7.829",
"quarter1_23": "8.125",
"quarter2_23": "6.77",
"quarter3_23": "7.369",
"date": "2022:10:18"
},
{
"category": "energy",
"commodity_name": "propane",
"commodity_unit": "usd/gal",
"commodity_price": "0.83",
"price_change_day": "0.00",
"percentage_day": "-0.14%",
"percentage_week": "-5.82%",
"percentage_month": "-19.86%",
"percentage_year": "-43.75%",
"quarter4_22": "0.904",
"quarter1_23": "0.929",
"quarter2_23": "0.851",
"quarter3_23": "0.889",
"date": "2022:10:17"
},
{
"category": "energy",
"commodity_name": "ttf gas",
"commodity_unit": "eur/mwh",
"commodity_price": "113.22",
"price_change_day": "14.76",
"percentage_day": "-11.53%",
"percentage_week": "-27.78%",
"percentage_month": "-37.88%",
"percentage_year": "25.90%",
"quarter4_22": "196.26",
"quarter1_23": "220.869",
"quarter2_23": "159.886",
"quarter3_23": "177.032",
"date": "2022:10:18"
},
{
"category": "energy",
"commodity_name": "uk gas",
"commodity_unit": "gbp/thm",
"commodity_price": "191",
"price_change_day": "41.2500",
"percentage_day": "-17.76%",
"percentage_week": "-33.26%",
"percentage_month": "-32.37%",
"percentage_year": "-15.45%",
"quarter4_22": "396.232",
"quarter1_23": "460.053",
"quarter2_23": "293.985",
"quarter3_23": "341.386",
"date": "2022:10:18"
},
{
"category": "energy",
"commodity_name": "urals oil",
"commodity_unit": "usd/bbl",
"commodity_price": "72.57",
"price_change_day": "1.87",
"percentage_day": "-2.51%",
"percentage_week": "-8.73%",
"percentage_month": "1.06%",
"percentage_year": "-11.76%",
"quarter4_22": "86.229",
"quarter1_23": "91.96",
"quarter2_23": "80.613",
"quarter3_23": "83.4",
"date": "2022:10:17"
},
{
"category": "energy",
"commodity_name": "uranium",
"commodity_unit": "usd/lbs",
"commodity_price": "51",
"price_change_day": "0.4000",
"percentage_day": "0.79%",
"percentage_week": "4.51%",
"percentage_month": "4.62%",
"percentage_year": "6.03%",
"quarter4_22": "54.748",
"quarter1_23": "55.786",
"quarter2_23": "52.207",
"quarter3_23": "52.508",
"date": "2022:10:17"
}
]
}
}
https://api.finnworlds.com/api/v1/commodities
?key=API-key
&commodity_name=crude_oil
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"category": "energy",
"commodity_name": "crude oil",
"commodity_unit": "usd/bbl",
"commodity_price": "83.585",
"price_change_day": "1.876",
"percentage_day": "-2.19%",
"percentage_week": "-6.45%",
"percentage_month": "-2.08%",
"percentage_year": "2.56%",
"quarter4_22": "98.313",
"quarter1_23": "98.617",
"quarter2_23": "90.471",
"quarter3_23": "93.342",
"date": "2022:10:18"
}
]
}
}
GET Request Parameters
| Objects | Description |
| commodity_name | The name of the commodity that you need information about |
| category | The commodity category of which you want information about all commodities. Metals, Energy, Livestock, Agricultural, Industrial |
API Response Objects
| Response Objects | Description |
| category | Category of the commodity |
| commodity_name | Name of the commodity |
| commodity_unit | The unit of measurement related to this commodity |
| commodity_price | The price of the commodity at last update |
| price_change_day | The price change since last trading day |
| percentage_day | The percentage change since last trading day |
| percentage_week | The percentage change since last trading week |
| percentage_month | The percentage change since last trading month |
| percentage_year | The YoY percentage change |
| quarterX_YY | The forecast of this commodity in future quarters |
| date | The date and time that our system has updated the price |
Stock Market Index
Stock market index API shows all the benchmarks and indexes of all regions and countries in the world.
https://api.finnworlds.com/api/v1/benchmark
?key=API-KEY
&country=france
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"region": "europe",
"country": "france",
"benchmark": "fr40",
"price": "6158",
"price_change_day": "27",
"percentage_day": "0.44%",
"percentage_week": "1.50%",
"percentage_month": "6.74%",
"percentage_year": "-8.99%",
"date": "2022:10:25"
}
]
}
}
https://api.finnworlds.com/api/v1/benchmark
?key=API-KEY
®ion=europe
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"region": "europe",
"country": "austria",
"benchmark": "atx",
"price": "2819",
"price_change_day": "1",
"percentage_day": "-0.04%",
"percentage_week": "0.82%",
"percentage_month": "3.61%",
"percentage_year": "-25.43%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "bosnia and herzegovina",
"benchmark": "sasx-10",
"price": "1127",
"price_change_day": "1",
"percentage_day": "-0.10%",
"percentage_week": "-3.69%",
"percentage_month": "7.52%",
"percentage_year": "7.99%",
"date": "2022:10:24"
},
{
"region": "europe",
"country": "belgium",
"benchmark": "be20",
"price": "3486",
"price_change_day": "9",
"percentage_day": "-0.26%",
"percentage_week": "0.06%",
"percentage_month": "2.86%",
"percentage_year": "-17.41%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "bulgaria",
"benchmark": "sofix",
"price": "581",
"price_change_day": "1",
"percentage_day": "0.13%",
"percentage_week": "0.18%",
"percentage_month": "-1.83%",
"percentage_year": "1.58%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "switzerland",
"benchmark": "ch20",
"price": "10661",
"price_change_day": "65",
"percentage_day": "0.61%",
"percentage_week": "0.77%",
"percentage_month": "5.84%",
"percentage_year": "-12.23%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "cyprus",
"benchmark": "cse general",
"price": "76",
"price_change_day": "0",
"percentage_day": "0.38%",
"percentage_week": "2.77%",
"percentage_month": "-0.60%",
"percentage_year": "15.12%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "czech republic",
"benchmark": "px",
"price": "1166",
"price_change_day": "5",
"percentage_day": "-0.42%",
"percentage_week": "-0.12%",
"percentage_month": "1.34%",
"percentage_year": "-13.00%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "germany",
"benchmark": "de40",
"price": "12803",
"price_change_day": "128",
"percentage_day": "-0.99%",
"percentage_week": "0.30%",
"percentage_month": "4.71%",
"percentage_year": "-18.75%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "denmark",
"benchmark": "copenhagen",
"price": "1625",
"price_change_day": "15",
"percentage_day": "0.93%",
"percentage_week": "-0.11%",
"percentage_month": "6.67%",
"percentage_year": "-11.48%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "europe",
"benchmark": "eu600",
"price": "401.37",
"price_change_day": "0.47",
"percentage_day": "-0.12%",
"percentage_week": "0.38%",
"percentage_month": "3.25%",
"percentage_year": "-15.63%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "estonia",
"benchmark": "tallinn",
"price": "1659",
"price_change_day": "8",
"percentage_day": "-0.50%",
"percentage_week": "-0.80%",
"percentage_month": "-2.24%",
"percentage_year": "-15.08%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "spain",
"benchmark": "es35",
"price": "7680",
"price_change_day": "0",
"percentage_day": "0.00%",
"percentage_week": "0.91%",
"percentage_month": "2.29%",
"percentage_year": "-14.68%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "finland",
"benchmark": "helsinki 25",
"price": "4561",
"price_change_day": "19",
"percentage_day": "-0.42%",
"percentage_week": "-1.02%",
"percentage_month": "4.40%",
"percentage_year": "-17.25%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "france",
"benchmark": "fr40",
"price": "6142",
"price_change_day": "10",
"percentage_day": "0.17%",
"percentage_week": "1.23%",
"percentage_month": "6.45%",
"percentage_year": "-9.23%",
"date": "2022:10:25"
},
{
"region": "europe",
"country": "united kingdom",
"benchmark": "gb100",
"price": "6956",
"price_change_day": "58",
"percentage_day": "-0.83%",
"percentage_week": "0.28%",
"percentage_month": "-0.93%",
"percentage_year": "-4.42%",
"date": "2022:10:25"
},
{ ETC
https://api.finnworlds.com/api/v1/benchmark
?key=API-KEY
&benchmark=us500
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"region": "america",
"country": "united states",
"benchmark": "us500",
"price": "3783.36",
"price_change_day": "13.21",
"percentage_day": "-0.35%",
"percentage_week": "1.94%",
"percentage_month": "3.55%",
"percentage_year": "-17.27%",
"date": "2022:10:25"
}
]
}
}
GET Request Parameters
| Objects | Description |
| country | Name of the country of which you want all indexes and benchmarks |
| region | Name of the region of which you want all indexes and benchmarks |
| benchmark | Specific benchmark or index name of which you want the data |
API Response Objects
| Objects | Description |
| region | Region or continent of which you want all benchmarks |
| country | Country of which you want all benchmarks |
| benchmark | Specific benchmark of which you want the data |
| price | Last known price of benchmark (updated every minute) |
| price_change_day | The point change of the day of the price |
| percentage_day | The day to day percentage change |
| percentage_week | The week-based percentage change |
| percentage_month | The month-based percentage change |
| percentage_year | The Year over Year percentage change |
| date | The date of the given information |
Bond Yields
API of Yield returns of bonds of different countries, regions and timeperiods.
https://api.finnworlds.com/api/v1/bond
?key=API-KEY
&country=us
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"region": "america",
"country": "united states",
"type": "10Y",
"yield": "4.1501",
"price_change_day": "0.0819",
"percentage_week": "0.15%",
"percentage_month": "0.27%",
"percentage_year": "2.54%",
"date": "2022:10:25"
}
]
}
}
https://api.finnworlds.com/api/v1/bond
?key=API-KEY
®ion=america
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"region": "america",
"country": "brazil",
"type": "10Y",
"yield": "12.13",
"price_change_day": "0.1900",
"percentage_week": "0.22%",
"percentage_month": "0.06%",
"percentage_year": "0.17%",
"date": "2022:10:24"
},
{
"region": "america",
"country": "canada",
"type": "10Y",
"yield": "3.511",
"price_change_day": "0.0640",
"percentage_week": "0.16%",
"percentage_month": "0.28%",
"percentage_year": "1.88%",
"date": "2022:10:25"
},
{
"region": "america",
"country": "chile",
"type": "10Y",
"yield": "6.75",
"price_change_day": "0.0300",
"percentage_week": "0.17%",
"percentage_month": "-0.20%",
"percentage_year": "0.37%",
"date": "2022:10:24"
},
{
"region": "america",
"country": "colombia",
"type": "10Y",
"yield": "14.625",
"price_change_day": "0.3400",
"percentage_week": "0.53%",
"percentage_month": "1.92%",
"percentage_year": "6.93%",
"date": "2022:10:24"
},
{
"region": "america",
"country": "mexico",
"type": "10Y",
"yield": "9.954",
"price_change_day": "0.0040",
"percentage_week": "0.10%",
"percentage_month": "0.30%",
"percentage_year": "2.37%",
"date": "2022:10:25"
},
{
"region": "america",
"country": "united states",
"type": "10Y",
"yield": "4.1481",
"price_change_day": "0.0839",
"percentage_week": "0.15%",
"percentage_month": "0.27%",
"percentage_year": "2.54%",
"date": "2022:10:25"
},
{
"region": "america",
"country": "venezuela",
"type": "10Y",
"yield": "10.429",
"price_change_day": "0.0000",
"percentage_week": "0.00%",
"percentage_month": "0.00%",
"percentage_year": "0.00%",
"date": "2022:10:24"
}
]
}
}
https://api.finnworlds.com/api/v1/bond
?key=API-KEY
&country=us
&type=10y
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"output": [
{
"region": "america",
"country": "united states",
"type": "10Y",
"yield": "4.1481",
"price_change_day": "0.0839",
"percentage_week": "0.15%",
"percentage_month": "0.27%",
"percentage_year": "2.54%",
"date": "2022:10:25"
}
]
}
}
GET Request Parameters
| Objects | Description |
| country | Country of which you want all bond yields |
| region | Region or continent of which you want all bond yields |
| type | The bond type you wish to know the yields for. For example 10y |
API Response Objects
| Objects | Description |
| region | Region or continent of which you want all bond yields |
| country | Country of which you want all bond yields |
| type | Specific type of bond of which you want the data (10y for example) |
| price | Last known yield of the bond (updated every minute) |
| price_change_day | The point change of the day of the yield |
| percentage_day | The day to day percentage change |
| percentage_week | The week-based percentage change |
| percentage_month | The month-based percentage change |
| percentage_year | The Year over Year percentage change |
| date | The date of the given information |
SDKs
Java
PHP
NodeJS
Python
Go
Ruby
C#
R
Strest
Rust
Swift
Scala
Java
URL url = new URL(“https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE”);
try (BufferedReader reader = new BufferedReader(new InputStreamReader(url.openStream(), “UTF-8”))) {
for (String line; (line = reader.readLine()) != null;) {
System.out.println(line);
}
}
PHP
set_time_limit(0);
$url_info = “https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE”;
$channel = curl_init();
curl_setopt($channel, CURLOPT_AUTOREFERER, TRUE);
curl_setopt($channel, CURLOPT_HEADER, 0);
curl_setopt($channel, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($channel, CURLOPT_URL, $url_info);
curl_setopt($channel, CURLOPT_FOLLOWLOCATION, TRUE);
curl_setopt($channel, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
curl_setopt($channel, CURLOPT_TIMEOUT, 0);
curl_setopt($channel, CURLOPT_CONNECTTIMEOUT, 0);
curl_setopt($channel, CURLOPT_SSL_VERIFYHOST, FALSE);
curl_setopt($channel, CURLOPT_SSL_VERIFYPEER, FALSE);
$output = curl_exec($channel);
if (curl_error($channel)) {
return ‘error:’ . curl_error($channel);
} else {
$outputJSON = json_decode($output);
var_dump($outputJSON);
}
NodeJS
const https = require(‘https’)
const options = {
hostname: ‘api.finnworlds.com’,
port: 443,
path: ‘/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE’,
method: ‘GET’
}
const req = https.request(options, (res) => {
res.on(‘data’, (d) => {
process.stdout.write(d)
})
})
req.on(‘error’, (error) => {
console.error(error)
})
req.end()
Python
#!/usr/bin/env python
try:
# For Python 3.0 and later
from urllib.request import urlopen
except ImportError:
# Fall back to Python 2’s urllib2
from urllib2 import urlopen
import json
def get_jsonparsed_data(url):
“””
Receive the content of “url“, parse it as JSON and return the object.
Parameters
———-
url : str
Returns
——-
dict
“””
response = urlopen(url)
data = response.read().decode(“utf-8”)
return json.loads(data)
url = (“https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE”)
print(get_jsonparsed_data(url))
Go
package main
import (
“fmt”
“io/ioutil”
“log”
“net/http”
)
func main() {
url := “https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE”
response, err := http.Get(url)
if err != nil {
log.Fatal(err)
}
defer response.Body.Close()
responseData, err := ioutil.ReadAll(response.Body)
if err != nil {
log.Fatal(err)
}
responseString := string(responseData)
fmt.Println(responseString)
}
Ruby
require ‘net/http’
require ‘uri’
uri = URI.parse(“https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE”)
request = Net::HTTP::Get.new(uri)
request[“Upgrade-Insecure-Requests”] = “1”
req_options = {
use_ssl: uri.scheme == “https”,
}
response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
http.request(request)
end
# response.code
# response.body
C#
using (var httpClient = new HttpClient())
{
using (var request = new HttpRequestMessage(new HttpMethod(“GET”), “https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE”))
{
request.Headers.TryAddWithoutValidation(“Upgrade-Insecure-Requests”, “1”);
var response = await httpClient.SendAsync(request);
}
}
R
require(httr)
headers = c(
`Upgrade-Insecure-Requests` = ‘1’,
)
params = list(
`datatype` = ‘json’
)
res <- httr::GET(url = ‘https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE’, httr::add_headers(.headers=headers), query = params)
Strest
version: 2
requests:
curl_converter:
request:
url: ‘https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE’
method: GET
headers:
–
name: Upgrade-Insecure-Requests
value: ‘1’
–
queryString:
–
name: datatype
value: json
Rust
extern crate reqwest;
use reqwest::headers::*;
fn main() -> Result<(), reqwest::Error> {
let mut headers = HeaderMap::new();
headers.insert(UPGRADE_INSECURE_REQUESTS, “1”.parse().unwrap());
let res = reqwest::Client::new()
.get(“https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE”)
.headers(headers)
.send()?
.text()?;
println!(“{}”, res);
Ok(())
}
Swift
import PlaygroundSupport
import Foundation
let url = URL(string: “https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE”)
var request = URLRequest(url: url!)
request.addValue(“application/json”, forHTTPHeaderField: “Accept”)
let task = URLSession.shared.dataTask(with: url!) { data, response, error in
guard error == nil else {
print(error!)
return
}
guard let data = data else {
print(“Data is empty”)
return
}
let json = try! JSONSerialization.jsonObject(with: data, options: [])
print(json)
}
task.resume()
PlaygroundPage.current.needsIndefiniteExecution = true
Scala
import scala.io.Source.fromURL
val json = fromURL(“https://api.finnworlds.com/api/v1/ENDPOINT?key=API-KEY&FILTER=VALUE&FILTER=VALUE”).mkString
print(json)