Account

In the account section you can manage the accounts on the exchanges (order destinations).

Get accounts GET

Code samples

curl --request GET \
  --url https://ems-mgmt.coinapi.io/v1/accounts \
  --header 'Accept: application/json' \
  --header 'X-CoinAPI-Key: API_KEY'

GET /v1/accounts

Get all accounts maintained for your subscription in the EMS API.

Parameters
ParameterInTypeRequiredDescription
filter_exchange_idqueryarray[string]falseExchange id of the specific account to provide single account instead of the list of all accounts

Example responses

200 Response

[
  {
    "exchange_id": "string",
    "parameters": [
      {
        "key": "PublicApiKey",
        "value": "36279b02-d24f-40be-a61b-e9fd7de46dd6"
      }
    ]
  }
]

Responses

StatusMeaningDescriptionSchema
200OK (opens in a new tab)OKInline

Response Schema

Status Code 200

NameTypeRequiredDescription
» exchange_idstringfalseExchange identifier and optional tag identifying specific account configured when the software will be managing multiple accounts on the same exchange; for eg:
BITSTAMP
BITSTAMP/7c177641-74bd-4dbe-9b01-2497c12a5f70`
BITSTAMP/2574
Allowed separators between the exchange identifier and the tag: ~/.,:;!@#$%^&*-_+=.
» parameters[KeyValue]falseExchange specific configuration parameters
»» keystringfalseNo description
»» valuestringfalseNo description

Add or update account POST

Code samples

curl --request POST \
  --url https://ems-mgmt.coinapi.io/v1/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-CoinAPI-Key: API_KEY' \
  --data '{"exchange_id":"string","parameters":[{"key":"PublicApiKey","value":"36279b02-d24f-40be-a61b-e9fd7de46dd6"}]}'

POST /v1/accounts

Add new or update existing exchange account for your subscription in the EMS API.

Body parameter

{
  "exchange_id": "string",
  "parameters": [
    {
      "key": "PublicApiKey",
      "value": "36279b02-d24f-40be-a61b-e9fd7de46dd6"
    }
  ]
}
Parameters
ParameterInTypeRequiredDescription
bodybodyAccountDatatrueExchange account object that needs to be add/update to the EMS
» exchange_idbodystringfalseExchange identifier and optional tag identifying specific account configured when the software will be managing multiple accounts on the same exchange; for eg:
» parametersbody[KeyValue]falseParameters required to log into the exchange
»» keybodystringfalseNo description
»» valuebodystringfalseNo description
Detailed descriptions

» exchange_id: Exchange identifier and optional tag identifying specific account configured when the software will be managing multiple accounts on the same exchange; for eg: BITSTAMP BITSTAMP/7c177641-74bd-4dbe-9b01-2497c12a5f70` BITSTAMP/2574 Allowed separators between the exchange identifier and the tag: ~/.,:;!@#$%^&*-_+=.

Responses

StatusMeaningDescriptionSchema
400Bad Request (opens in a new tab)Invalid exchange idNone
405Method Not Allowed (opens in a new tab)Validation exceptionNone

Delete account DELETE

Code samples

curl --request DELETE \
  --url 'https://ems-mgmt.coinapi.io/v1/accounts?exchange_id=string' \
  --header 'X-CoinAPI-Key: API_KEY'

DELETE /v1/accounts

Delete specific exchange account maintained by the EMS API for your subscription.

Parameters
ParameterInTypeRequiredDescription
exchange_idqueryarray[string]trueExchange identifier of the account to delete

Responses

StatusMeaningDescriptionSchema
404Not Found (opens in a new tab)Exchange account not foundNone

Delete all accounts DELETE

Code samples

curl --request DELETE \
  --url https://ems-mgmt.coinapi.io/v1/accounts/all \
  --header 'X-CoinAPI-Key: API_KEY'

DELETE /v1/accounts/all

Delete all exchange accounts maintained by the EMS API for your subscription.

Responses

StatusMeaningDescriptionSchema
200OK (opens in a new tab)OKNone

Copyright 2022 COINAPI LTD or its affiliates. All rights reserved.
StatusPage: