EMS - REST API
This section will provide necessary information about the CoinAPI EMS REST API protocol.
This API is also available in the Postman application: https://postman.coinapi.io/ (opens in a new tab)
Implemented Standards:
Endpoints
| Deployment method | Environment | Url |
|---|---|---|
| Managed Cloud | Production | Use Managed Cloud REST API /v1/locations to get specific endpoints to each server site where your deployments span |
| Self Hosted | Production | IP Address of the ems-gateway container/excecutable in the closest server site to the caller location |
Authentication
If the software is deployed as Self-Hosted then API do not require authentication as inside your infrastructure, your company is responsible for the security and access controls.
If the software is deployed in our Managed Cloud, there are 2 methods for authenticating with us, you only need to use one:
- Custom authorization header named
X-CoinAPI-Keywith the API Key - Query string parameter named
apikeywith the API Key - TLS Client Certificate from the
Managed Cloud REST API(/v1/certificate/pem endpoint) while establishing a TLS session with us.
Custom authorization header
You can authorize by providing additional custom header named X-CoinAPI-Key and API key as its value.
Assuming that your API key is 73034021-THIS-IS-SAMPLE-KEY, then the authorization header you should send to us will look like: X-CoinAPI-Key: 73034021-THIS-IS-SAMPLE-KEY
Query string authorization parameter
You can authorize by providing an additional parameter named apikey with a value equal to your API key in the query string of your HTTP request.
Assuming that your API key is 73034021-THIS-IS-SAMPLE-KEY and that you want to request all balances, then your query string should look like this: GET /v1/balances?apikey=73034021-THIS-IS-SAMPLE-KEY