Create Exchange

Edit online

Links your organization with a cryptocurrency exchange.

HTTP request
POST/exchanges
Authentication
Authentication Type Supported
Organization User (CustomerEmployee) Yes
Delegated User (EndUser) No
Service Account Yes
Required permissions
Exchanges:Create (always required)
Authorization requirements
Header Type Required Description
Authorization string Yes Bearer token used to authenticate the request. See Authentication flows for details.
X-DFNS-USERACTION string Yes User Action Signature used to sign change‑inducing requests. See User Action Signing flows for details.
Request body

Defines the exchange integration to create.

Field Type Required Description
kind enum string Yes Exchange provider type. Supported values: Binance, Kraken, CoinbaseApp, CoinbasePrime.
readConfiguration object Yes
writeConfiguration object Yes
name string No Maximum length is 100 characters. 
curl --request POST \
  --url https://api.digitalassets.ibm.com/exchanges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "kind": "Binance",
  "readConfiguration": {
    "publicApiKey": "<string>",
    "privateApiKey": "<string>",
    "password": "<string>",
    "otp": "<string>"
  },
  "writeConfiguration": {
    "publicApiKey": "<string>",
    "privateApiKey": "<string>",
    "password": "<string>",
    "otp": "<string>"
  },
  "name": "<string>"
}
'
Response
200: Success

Example response:

{{
  "id": "<string>",
  "kind": "Binance",
  "dateCreated": "<string>",
  "name": "<string>"
}