The IDX Protocol is a technical specification for achieving interoperability in the impact investments space. It enables the seamless and interoperable exchange of investment opportunity data between different systems.
The IDX Protocol aims to serve impact investors and investees by increasing the efficiency of deal sourcing through the exchange of investment opportunity data. The interoperability enabled by the protocol supports:
- Reducing friction and cost of impact investment decision making for both investors and investees
- Increasing the number of investments in SDG-related solutions
- Improving transparency and accountability of impact investments
The IDX Data Model consists of the Opportunity
data type that contains information relating to a single investment opportunity. It includes properties such as:
- Unique identifier and lifecycle management (
id
,previousIds
,status
) - Basic information about the entity (
companyName
,email
,city
,country
) - Funding details (
fundingAsk
,fundingCurrency
) - Optional information about sustainable practices, previous investors, income sources, and cost structure
The IDX Protocol defines an HTTP-based API for the interoperable exchange of opportunity data between host systems. Key aspects include:
-
Authentication Flow: Host systems must implement OAuth2 client credentials authentication
- Authentication endpoint discovery via OpenID Connect discovery document
- Bearer token authentication
-
Actions:
OpportunityExchange
: Lists the data owner's opportunity data with support for pagination
-
Host System Requirements:
- Must offer an OpenID Provider Configuration Document
- Must implement the Authentication Flow and OpportunityExchange action
- Must offer actions under HTTPS only
The protocol currently supports the following data transaction:
Opportunity Data Exchange: Enables an investee (such as a farmer or cooperative) to make investment opportunity data available to investors or impact funds. It also allows investors to share opportunities with other investors.
Host systems implementing the IDX Protocol must:
- Offer a discoverable authentication endpoint
- Implement OAuth2 client credentials authentication
- Provide opportunities through the defined HTTP API endpoints
- Support pagination for opportunity data
- Handle the lifecycle of opportunities (creation, updates, closing)
The following topics and concerns are not within the scope of this specification:
- KYC or AML-related topics
- Legal or regulatory aspects of impact investments
- The definition of impact investment or the impact investments space
- Data provenance and data security aspects
The protocol includes a conformance testing framework to assess interoperability between host systems. Test cases are categorized as:
- Mandatory Tests: Required for conformance (authentication discovery, successful authentication, opportunity exchange)
- Recommended Tests: Additional tests to demonstrate robustness (error handling, pagination, etc.)
The exchange protocol is made available under the Creative Commons CC BY-SA license. This license enables reusers to distribute, remix, adapt, and build upon the material in any medium or format, so long as attribution is given to the creator. The license allows for commercial use. If you remix, adapt, or build upon the material, you must license the modified material under identical terms.