EMS - WebSocket API
This section will provide necessary information about the CoinAPI EMS WebSocket API protocol.
WebSocket API provides real-time communication capacity for order management, execution reports, balances and the positions.
Implemented Standards:
- HTTP1.0 (opens in a new tab)
- HTTP1.1 (opens in a new tab)
- HTTP2.0 (opens in a new tab)
- WebSocket (opens in a new tab)
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 exchange rates from BTC asset, then your query string should look like this: GET /v1/exchangerate/BTC?apikey=73034021-THIS-IS-SAMPLE-KEY