POST
/
orders

Using the following API, you can create a settlement order on the Copper Network. You need to set the following parameters:

Body

application/json
amount
string
required

The amount of order in baseCurrency

baseCurrency
string
required

The currency of the order amount

externalOrderId
string
required

Unique order identifier from client (should be unique for the portfolio)

limitType
enum<string>
required

The limit type of the order. Used to create settle orders. See details

Available options:
otc
orderType
enum<string>
required

The order type. See details

Available options:
buy,
sell
portfolioId
string
required

The id of the portfolio where the order should be placed

quoteCurrency
string
required

The currency of the quote amount

toCounterpartyId
string
required

The id of the counterparty to transfer money to

deliveryType
enum<string>

Settlement order type only applicable for settle orders. See details

Available options:
free-of-payment,
payment-vs-payment
description
string

The description of the order

includeFeeInWithdraw
boolean
default: false

Indicates, whether the fee should be included in the withdrawal amount or added on top of it

priceLimit
string

The price of the order in quote currency, only applicable for settle orders

quoteAmount
string

The amount of order in quoteCurrency

quoteMainCurrency
string

The main currency of the quote currency

Response

200 - application/json
amount
string
required

Amount of order in baseCurrency

baseCurrency
string
required

Base currency of the order

createdAt
string
required

Order creation timestamp

externalOrderId
string
required

The order ID in the external system

orderId
string
required

Order ID

orderType
enum<string>
required

Order type. See details

Available options:
sell,
buy,
deposit,
withdraw,
multi-withdraw,
retrieved-deposit,
earn-reward
portfolioId
string
required

Portfolio ID

portfolioType
enum<string>
required

Portfolio type. See details

Available options:
custody,
trading-vault,
trading,
external,
clearloop
status
enum<string>
required

Order status. See details

Available options:
new,
waiting-funds,
reserved,
working,
waiting-approve,
co-sign-require,
approved,
processing,
executed,
canceled,
rejected,
declining,
declined,
blocked,
action-required,
require-initializer-approve,
waiting-counterparty-approve,
require-counterparty-approve,
ready-for-settlement,
settled,
part-signed-tx-added,
full-signed-tx-added,
rejected-part-signed-tx-added,
rejected-full-signed-tx-added,
awaiting-settlement,
master-password-required,
manual-resolving,
error,
pending-atomic-settlement-confirmation,
atomic-settlement-reservation-completed
createdBy
string

Creator user id

extra
object

Additional order information

limitType
enum<string>

Limit type of the order. See details

Available options:
otc,
rfq
mainCurrency
string

Blockchain network of a baseCurrency

organizationId
string

Organization id

quoteCurrency
string

The quote currency of the order (in case of a settle order)

quoteMainCurrency
string

Blockchain network of a quoteCurrency

terminatedAt
string

Order termination timestamp

updatedAt
string

Order update timestamp