As part of its multi-year Digital Experience Transformation, FINRA is launching a new API Developer Center (developer.finra.org) to connect with developers, across the financial services industry, and support their goal of building automation to decrease risks, lower regulatory costs, and create new capabilities. The creation of a centralized catalog of APIs and a standard platform for accessing them is a clear signal that FINRA is embracing the fact that many firms and their service providers have software and systems that they want to easily and quickly integrate with FINRA products and services.
Available APIs and Datasets
In Q4 of 2019, FINRA will make available its first two API products via the API Developer Center:
1. Market Transparency API
There are three datasets available with the Market Transparency API:
- The market transparency dataset contains aggregated OTC (ATS & Non-ATS trade data in order to facilitate transparency in the applicable markets. This data is also available on the OTC Transparency website (otctransparency.finra.org). The available API endpoints provide a mechanism to retrieve this data using a machine-to-machine interface.
- The threshold list dataset contains a list of fail to deliver positions in a Threshold Security for 13 consecutive settlement days in accordance with Regulation SHO or FINRA Rule 4320. This data is also available on the OTC Equities website (otce.finra.org). The available API endpoints provide a mechanism to retrieve this data using a machine-to-machine interface.
- The equity short interest dataset contains OTC equity short positions reported by FINRA member firms. This data is also available on the OTC Equities website (otce.finra.org). The available API endpoints provide a mechanism to retrieve this data using a machine-to-machine interface.
2. Registration API
The Registration API supports registration automation by providing access to a firm's registered individual and branch data as stored in the Central Registration Repository.
There are two registration datasets available:
- Individual API provides comprehensive data about each registered individual associated with a firm.
- Branch API provides comprehensive data about each branch associated with a firm as well as those registered individuals associated with a branch.
- This data is only available on a firm-by-firm basis. It is not possible to view all registered individuals across all FINRA firms at this point.
- A further restriction on the registration API is that production access to the API will be limited to those firms with a valid WebEFT subscription.
The registration APIs are being made available in this way to facilitate early testing and feedback from the industry while FINRA continues to refine numerous aspects of the API Developer Center go-to-market plan including pricing, entitlement, operations, support etc.
1. Request an API Key
Access to the FINRA API platform requires the provisioning of one or more API keys. To get started you will need to request an API key that provides access to our test environment. Select the REQUEST API KEY menu option to get started. The username and password you select when requesting an API key represent the API Client ID and API Client Secret needed to access test data via API.
Click on the REQUEST API KEY menu option to request API credentials.
This API key WILL NOT provide access to production data via the API platform. You will need to follow the process in step 3 below to access production data.
NOTE: After completing the API key provisioning process, you will receive a confirmation email containing a temporary password. You MUST follow the instructions provided in the confirmation email to reset the temporary password in order to fully activate your API key. If you do not complete this process in a timely manner, or fail to make at least one API call within 30 days, this account may be terminated according to FINRA Entitlement Program rules.
2. Research and Development
API developers can utilize the API key received in Step 1 above to begin to test and evaluate available APIs. Each dataset delivered via the API platform will have test data available. The test data will be representative but randomized or mock data. This data can be used by third-party developers to evaluate available APIs and to to test their integrations with the FINRA API platform.
Visit the API Basics page to learn about the fundamentals of using the FINRA API platform.
Visit the Datasets page to find details about the available test datasets.
If you have questions regarding the use of the FINRA API platform click on the SUPPORT menu option to review frequently ask questions or to submit a support request. FINRA staff will respond to all questions as soon as possible.
NOTE: FINRA staff cannot write or debug code for third-party developers.
3. Go Live
Once you are ready to move your integration with the FINRA API platform into production, reach out to the FINRA API Developer Center product team by submitting a Go Live request via the Support Center. A member of the FINRA API product team will coordinate a go-live conference call with you to walk through and coordinate the process of obtaining a production API Key.
NOTE: If you are a service provider or other vendor providing services on behalf of a FINRA member firm, we will need to coordinate with you AND a representative of the member firm in order to provision a production API Key. Service provider access on behalf of firms cannot be done without the approval of the responsible representatives of the firm.