Exchange

Calculate the exchange rate

post

Get info about exchange rates. This endpoint has limitation up to 30 requests per minute from one IP address. In case this amount is exceeded a new successful response can only be obtained after a minute-long break.

Authorizations

xProcessingKey & xProcessingSignature

X-processing-keystringRequired

Your API key.

X-processing-signaturestringRequired

The request body, signed with HMAC-SHA512 with your secret key. You can find the secret key in your account.

Body

application/json

sender_currencystringRequired

Currency to exchange from. For a list of all available currencies, see Supported currencies.

receiver_currencystringRequired

Currency to exchange to. For a list of all available currencies, see Supported currencies.

sender_amountnumber · floatOptional

Amount you want to exchange. You must include either this parameter or receiver_amount.

receiver_amountnumber · floatOptional

Amount you want to exchange. You must include either this parameter or receiver_amount.

Responses

200

OK

application/json

400

Exchange is unavailable

application/json

403

Bad key header

application/json

post

/exchange/calculate

HTTPcURLJavaScriptPython

POST /api/v2/exchange/calculate HTTP/1.1
Host: app.cryptoprocessing.com
X-processing-key: YOUR_API_KEY
X-processing-signature: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "sender_currency": "BTC",
  "receiver_currency": "EUR",
  "sender_amount": 0.03
}

{
  "data": {
    "sender_currency": "EUR",
    "sender_amount": "25.00000000",
    "receiver_currency": "BTC",
    "receiver_amount": "0.00123001",
    "fee_currency": "CPD",
    "fee_amount": "0.17266485",
    "price": "0.00004920",
    "ts_fixed": 1665008630,
    "ts_release": 1665008690,
    "fix_period": 60
  }
}

Exchange at a fixed exchange rate

post

Execute the exchange at a given fixed exchange rate.

Authorizations

xProcessingKey & xProcessingSignature

X-processing-keystringRequired

Your API key.

X-processing-signaturestringRequired

The request body, signed with HMAC-SHA512 with your secret key. You can find the secret key in your account.

Body

application/json

sender_currencystringOptional

Currency to exchange from. For a list of all available currencies, see Supported currencies.

receiver_currencystringOptional

Currency to exchange to. For a list of all available currencies, see Supported currencies.

sender_amountnumberOptional

Amount you want to exchange.

receiver_amountnumberOptional

Amount you want to exchange.

foreign_idstring · max: 255Required

Unique foreign ID in your system. Must not contain personal data, such as the user's name or email address.

pricenumberRequired

Exchange rate price on which exchange will be placed.

Responses

200

OK

application/json

403

Bad key header

application/json

post

/exchange/fixed

HTTPcURLJavaScriptPython

POST /api/v2/exchange/fixed HTTP/1.1
Host: app.cryptoprocessing.com
X-processing-key: YOUR_API_KEY
X-processing-signature: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "sender_currency": "BTC",
  "receiver_currency": "BTC",
  "sender_amount": 0,
  "receiver_amount": 0,
  "foreign_id": "string",
  "price": 0
}

{
  "data": {
    "id": 2687667,
    "foreign_id": "knwi24op9",
    "type": "exchange",
    "sender_amount": "0.01",
    "sender_currency": "BTC",
    "receiver_amount": "63.52069015",
    "receiver_currency": "EUR",
    "fee_amount": "6.98727592",
    "fee_currency": "EUR",
    "price": "6352.06901520",
    "status": "processing"
  }
}

Exchange regardless of the exchange rate

post

Execute the exchange regardless of the price.

Authorizations

xProcessingKey & xProcessingSignature

X-processing-keystringRequired

Your API key.

X-processing-signaturestringRequired

The request body, signed with HMAC-SHA512 with your secret key. You can find the secret key in your account.

Body

application/json

sender_currencystringRequired

Currency to exchange from. For a list of all available currencies, see Supported currencies.

receiver_currencystringRequired

Currency to exchange to. For a list of all available currencies, see Supported currencies.

sender_amountnumberOptional

Amount you want to exchange. You must include either this parameter or receiver_amount.

receiver_amountnumberOptional

Amount you want to exchange. You must include either this parameter or sender_amount.

foreign_idstring · max: 255Required

Unique foreign ID in your system. Must not contain personal data, such as the user's name or email address.

Responses

200

OK

application/json

403

Bad key header

application/json

post

/exchange/now

HTTPcURLJavaScriptPython

POST /api/v2/exchange/now HTTP/1.1
Host: app.cryptoprocessing.com
X-processing-key: YOUR_API_KEY
X-processing-signature: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 114

{
  "sender_currency": "BTC",
  "receiver_currency": "BTC",
  "sender_amount": 0,
  "receiver_amount": 0,
  "foreign_id": "user_1714"
}

{
  "data": {
    "sender_currency": "EUR",
    "sender_amount": "1966.61957532",
    "receiver_currency": "BTC",
    "receiver_amount": "0.10000000",
    "fee_currency": "EUR",
    "fee_amount": "19.66619575",
    "price": "0.00005084",
    "id": 678287,
    "foreign_id": "user_1714",
    "type": "exchange",
    "status": "processing"
  }
}