F. A. Q
Each time you successfully pull data via any of the APIs (with correct endpoint, no errors returned), this counts as 1 API call. The response could include a whole list of companies’ data in a certain sector or a single company, and both would count as 1 API call. It’s all about the endpoint you are using.
If the call is unsuccessful for the above reasons, your API call limit will not be consumed.
We have different API subscription plans with different monthly API call limits and different APIs included in them. You may choose whichever fits you the most.
Some plans may be subject to trial month which applies for the first month after which the original rates apply automatically. If you are unclear about the prices or have doubts about picking the right plan for you, feel free to contact us anytime.
You may log in to your dashboard and simply upgrade your API subscription to a higher level and the upgrade with the higher limit will take place right away.
You can track this on your dashboard. Simply log in with your email address and the password sent to you over email when you first subscribed and track your call count anytime.
You may view your invoices anytime on your dashboard.
Sure, please send us an email about how many API calls you may require per month and our team will get back to you with an offer.
You may cancel your subscription anytime on your dashboard or by sending us a request via email at least 5 days before the next renewal date.
The subscription fees are non-refundable even in cases the APIs are not used. This is the standard practice for all subscription-based services. If this happens, let us know and we can carry over your unused calls as an exception for the next time you subscribe.
Test keys typically have a very limited number of API calls assigned to them which is often not enough to make a serious test. Instead, we found out trial month advantage to be more effective for this purpose. The first month of the API plans has an around 90% discounted rate with the full features of the regular months which is perfect for testing.
We have the policy to offer several options for academic and non-profit uses of the APIs. We’d be happy to hear about your project and discuss opportunities! Generally, in cases where we are able to assign a free API key, we only ask for backlinks and online references to help increase our online visibility.
We apply a 10% discount on annual payments for any plan you prefer.
Of course! Basics on how to use the APIs, filters, endpoints, etc. can be found in the documentation or the product pages. If you have any further questions at all, please send us an email and we’d be happy to assist you.
We currently do not have call/video call support, but we find email to be the most useful to provide support. This way, we get to understand your questions better, in writing, and send you example API files, endpoint, data samples, etc. that can be quite useful to visualize the solution. Our team will get back to you within 12 hours every time.
We do not provide direct development support (coding, programming, etc.) but are happy to assist you with any questions you may have on the data, access, and APIs along the way.
The data itself updates very often. However, an API call does not automatically renew. You would have to simply make new API calls frequently and the API will get you the latest data each time.
The APIs do not currently have a push notification feature. However, you could build a system on your end that compares the values for each time the API returns data and displays this as an alert. We have clients who efficiently use this method.
Please contact the team!
Please contact the team!
You will have access to all updated versions in the future without having to buy the databases again. We do not have a pre-determined schedule for standalone database updates but keep in mind that APIs can be more accurate as they allow us to update individual items on the spot.
We have to say that absolute 100% completeness is not possible to achieve for any financial data provider. However, we appreciate any feedback you may have on missing items to make sure we add these the next time the data updates.
We gather the data from the SEC daily, weekly, quarterly, annually or irregularly, and on top of that, from the company websites and reports from the companies, ETFs, mutual funds, and other related bodies as they disclose. This aggregated data is then stored and maintained in our database that you may access anytime via the relevant API or as a standalone database.
It is as accurate as we receive it from our sources which are mostly official ones. Since we gather the data through the SEC, the EDGAR system and other sources affiliated directly with companies or official channels, the accuracy is high.
What we do is to gather the data from these sources and, maintain and update the database constantly so you do not have to do this on your own. This way, you get to focus on your core project without having to spend time and money on finding and maintaining data. Financial data updates very fast and voluminously especially during certain periods like quarter and year-ends, so an API service is probably a good idea to not get overwhelmed by manually-collected data.
We do not recommend using and implementing the APIs for delicate operations where you will have a financial and compensation liability towards your clients in terms of accuracy. Such usage would not be covered with our Service Level Agreement (SLA) and Finnworld cannot be responsible for the damages you may face.
The databases are available in Excel, CSV and SQL formats (all three come in a .RAR file). You can also access the databases through our API which is JSON/REST.
Basically, transferring, displaying the data you receive from us exactly the way you receive it (“as-is”), or building a new API would be against the policy. Implementing the data into any sort of separate project is fine. Our Terms and Conditions has more information about this but if you have any concerns or do not have the time to read it thoroughly, contact us anytime and we will clarify.
Each API has a certain list of filters that you can use. Please see the documentation or the product page for the API you are interested in. Please also stick to the filters specified there because not all values can be used as a filter. If you use a non-existent filter, the API will simply return an error.