curl --request POST \
  --url https://api.paxos.com/v2/profiles/{profile_id}/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "side": "BUY",
  "market": "ETHUSD",
  "type": "LIMIT",
  "price": "190.23",
  "base_amount": "2.35781498",
  "metadata": {
    "customer_id": "9b8c9cba-801e-4418-adc0-ede709df6339"
  }
}'

{
  "id": "f190b163-208f-4d73-8deb-4fb8b24add00",
  "profile_id": "b7b77d82-e6a7-4ae9-9904-36231aedf985",
  "ref_id": "my-order-1",
  "status": "SUBMITTED",
  "market": "ETHUSD",
  "side": "BUY",
  "type": "LIMIT",
  "price": "190.23",
  "base_amount": "2.35781498",
  "quote_amount": "",
  "metadata": {
    "customer_id": "9b8c9cba-801e-4418-adc0-ede709df6339"
  },
  "amount_filled": "0.00000000",
  "volume_weighted_average_price": "0.00000000",
  "time_in_force": "GTC"
}

Orders

Create Order

For limit orders, create an order for buying or selling an asset:

To buy, set side = BUY and set base_amount to the crypto amount you want to buy.
To sell, set side = SELL and set base_amount to the crypto amount you want to sell.

For market orders, create an order for buying or selling an asset:

To buy, set side = BUY and set quote_amount to the dollar amount you want to spend.
To sell, set side = SELL and set base_amount to the crypto amount you want to sell.

There are five types of orders:

Limit Orders: Buy or sell at a specified price or better. Execution not guaranteed. Taker orders will be rejected if price deviates 15% from midpoint.
Post-Only Limit Orders: have the same properties as Limit Orders, but get rejected if they cross the orderbook.
Market Orders: Operate as Immediate or Cancel (IOC) orders. Price is variable, executes at best available price at time of order.
Stop Market Orders: Will convert to a market sell order with the specified quantity when the stop price is hit. The stop price does not guarantee that it will be executed at that price. Market conditions (price) might change between the order being triggered and order being executed. Currently only sell stop loss orders are supported.
Stop Limit Orders: have a Stop Price which when hit, will convert to a limit sell order that will be executed at a specified price (or better)

Maximum notional order size by type:

Order Type	Market	Maximum Notional Value (USD)
Market	all	500,000
Limit	BTCUSD	1,500,000
Limit	ETHUSD	1,500,000
Limit	other	1,000,000

POST

profiles

{profile_id}

orders

curl --request POST \
  --url https://api.paxos.com/v2/profiles/{profile_id}/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "side": "BUY",
  "market": "ETHUSD",
  "type": "LIMIT",
  "price": "190.23",
  "base_amount": "2.35781498",
  "metadata": {
    "customer_id": "9b8c9cba-801e-4418-adc0-ede709df6339"
  }
}'

{
  "id": "f190b163-208f-4d73-8deb-4fb8b24add00",
  "profile_id": "b7b77d82-e6a7-4ae9-9904-36231aedf985",
  "ref_id": "my-order-1",
  "status": "SUBMITTED",
  "market": "ETHUSD",
  "side": "BUY",
  "type": "LIMIT",
  "price": "190.23",
  "base_amount": "2.35781498",
  "quote_amount": "",
  "metadata": {
    "customer_id": "9b8c9cba-801e-4418-adc0-ede709df6339"
  },
  "amount_filled": "0.00000000",
  "volume_weighted_average_price": "0.00000000",
  "time_in_force": "GTC"
}

OAuth Scope

exchange:write_order

Authorizations

Authorization

string

header

required

Path Parameters

profile_id

string

required

Body

application/json

side

enum<string>

required

Available options:

BUY,

SELL

market

enum<string>

required

Available options:

ETHEUR,

ETHSGD,

ETHUSD,

BTCEUR,

BTCSGD,

BTCUSD,

PAXGUSD,

BCHUSD,

LTCUSD,

USDPUSD,

LINKUSD,

MATICUSD,

AAVEUSD,

UNIUSD

type

enum<string>

required

Available options:

LIMIT,

MARKET,

POST_ONLY_LIMIT,

STOP_MARKET,

STOP_LIMIT

ref_id

string

base_amount

string

price

string

quote_amount

string

metadata

object

Show child attributes

await_fill_millis

integer

Required range: x <= 10000

time_in_force

enum<string>

Available options:

GTC,

FOK,

IOC,

GTT

expiration_date

string<uint64>

identity_id

string

identity_account_id

string

stop_price

string

recipient_profile_id

string

self_match_prevention_id

string

Response

string

profile_id

string

ref_id

string

status

enum<string>

Available options:

PENDING_SUBMISSION,

SUBMITTED,

OPEN,

FILLED,

CANCELLED,

REJECTED

side

enum<string>

Available options:

BUY,

SELL

market

enum<string>

Available options:

ETHEUR,

ETHSGD,

ETHUSD,

BTCEUR,

BTCSGD,

BTCUSD,

PAXGUSD,

BCHUSD,

LTCUSD,

USDPUSD,

LINKUSD,

MATICUSD,

AAVEUSD,

UNIUSD

type

enum<string>

Available options:

LIMIT,

MARKET,

POST_ONLY_LIMIT,

STOP_MARKET,

STOP_LIMIT

base_amount

string

price

string

quote_amount

string

metadata

object

Show child attributes

created_at

string<date-time>

modified_at

string<date-time>

amount_filled

string

volume_weighted_average_price

string

time_in_force

enum<string>

Available options:

GTC,

FOK,

IOC,

GTT

expiration_date

string<date-time>

identity_id

string

identity_account_id

string

stop_price

string

recipient_profile_id

string

is_triggered

boolean

List Orders Get Order

⌘I

API Documentation

Deposits and Withdrawals

Identity

Profiles

Sandbox

Settlements

Orchestrations / Conversions

Taxes

Trading

Rewards

Events

API Credentials

Websockets

Webhooks

Problems

Create Order

Authorizations

Path Parameters

Body

Response