Generate a DCA code.

POST

/api/v1/user/dca-code

Authorizations

• Client
• User

Request Body ^required

object

sourceCurrency

CAIP-19 identifier for the source currency. Alternative to currencyPair — when both sourceCurrency and targetCurrency are provided, currencyPair is derived automatically.

string

nullable

Example

swift:0/iso4217:EUR

targetCurrency

CAIP-19 identifier for the target currency. Alternative to currencyPair — when both sourceCurrency and targetCurrency are provided, currencyPair is derived automatically.

string

nullable

Example

bip122:000000000019d6689c085ae165831e93/slip44:0

currencyPair

required

The currency pair for the DCA code.

string

Example

BTC-EUR

walletAddress

required

The wallet address we send the cryptos to after the payment is completed.

string

Example

3FZbgi29cpjq2GjdwV8eyHuJJnkLtktZc5

destinationTag

The destination tag where we send the cryptos to after the payment is completed.

string|integer

nullable

Example

ABC12345

Responses

200

Returns the data (IBAN, BIC, payment description, etc) for the DCA.

object

name

Name of the account holder.

string

Example

Doe

iban

The IBAN where the fiat need to be sent to.

string

Example

NL37BUNQ2025406444

description

The code that needs to be sent in the description field.

string

Example

12345678

bic

The BIC of the bank.

string

Example

BUNQNL2A

400

A list of possible errors for this endpoint.

object

code

required

string

Allowed values: ER006 ER007 ER008 ER016 ER017 ER800 ER801 ER802 ER803 ER805 ER806 ER999

message

required

string

solution

required

string

Example

{
  "errors": {
    "ER006": {
      "code": "ER006",
      "message": "The provided quote has expired.",
      "solution": "Request a new quote."
    },
    "ER007": {
      "code": "ER007",
      "message": "The provided quote contains invalid data. It is possible it has been tampered with.",
      "solution": "Provide a valid quote."
    },
    "ER008": {
      "code": "ER008",
      "message": "The selected currency is down for maintenance.",
      "solution": "Check /api/v1/system/currency-pairs to see whether the selected currency is enabled, and try again."
    },
    "ER016": {
      "code": "ER016",
      "message": "Selling is down for maintenance.",
      "solution": "Check /api/v1/system/currency-pairs to see whether buying has been enabled, and try again."
    },
    "ER017": {
      "code": "ER017",
      "message": "The provided quote is not a sell quote.",
      "solution": "Request a new sell quote."
    },
    "ER800": {
      "code": "ER800",
      "message": "Authorization token is invalid.",
      "solution": "Provide a valid authorization token."
    },
    "ER801": {
      "code": "ER801",
      "message": "Authorization token has expired.",
      "solution": "Request a new authorization token."
    },
    "ER802": {
      "code": "ER802",
      "message": "Authorization token not found.",
      "solution": "Provide an authorization token."
    },
    "ER803": {
      "code": "ER803",
      "message": "Multiple authorization methods used.",
      "solution": "Use exactly one authorization method."
    },
    "ER805": {
      "code": "ER805",
      "message": "API key is invalid.",
      "solution": "Provide a valid API key."
    },
    "ER806": {
      "code": "ER806",
      "message": "API key not found.",
      "solution": "Provide an API key."
    },
    "ER999": {
      "code": "ER999",
      "message": "A general error has occurred. Please contact our support team.",
      "solution": "Contact our support team."
    }
  }
}