新規発注

post
新規注文(現物)

https://api.liquid.com/orders
現物で新規に注文を出す場合に利用します。
Request
Response
Request
Body Parameters
quantity
required
number
取引する数量を指定します。
order_type
required
string
注文のタイプを指定します。
product_id
required
integer
a取引するマーケットのidを指定します。
side
required
string
buy, sell いずれかを指定します。
order_direction
optional
string
注文の方向を指定します。 one_direction : 両建てなし two_direction : 両建てあり netout : ネットアウト
client_order_id
optional
string
36byteまでの一意の文字列を指定します。 詳しくはページ下部をご覧ください。
Response
200: OK
{
'id': 123456789,
'order_type': 'market',
'quantity': '1.0',
'disc_quantity': '0.0',
'iceberg_total_quantity': '0.0',
'side': 'buy',
'filled_quantity': '1.0',
'price': 27.087,
'created_at': 12345,
'updated_at': 12346,
'status': 'filled',
'leverage_level': 1,
'source_exchange': 'QUOINE',
'product_id': 83,
'margin_type': None,
'take_profit': None,
'stop_loss': None,
'trading_type': 'spot',
'product_code': 'CASH',
'funding_currency': 'JPY',
'crypto_account_id': None,
'currency_pair_code': 'XRPJPY',
'average_price': 0.0,
'target': 'spot',
'order_fee': 0.0,
'source_action': 'manual',
'unwound_trade_id': None,
'trade_id': None,
'client_order_id': None
}

post
新規注文(レバレッジ)

https://api.liquid.com/orders
レバレッジ取引で新規に注文を出す場合に利用します。
Request
Response
Request
Body Parameters
leverage_level
required
integer
レバレッジの倍率を指定します。 2 or 4 が指定できます。
order_type
required
string
注文タイプを指定します。
product_id
required
integer
取引するマーケットのidを指定します。
side
required
string
buy, sell いずれかを指定します。
quantity
required
number
a取引する数量を指定します。
order_direction
optional
string
注文の方向を指定します。 one_direction : 両建てなし two_direction : 両建てあり netout : ネットアウト
margin_type
optional
string
証拠金の運用方法を指定できます。"cross" ,"isolated" のいずれか。 指定しない場合は "cross" になります。
take_profit
optional
number
決済指値の価格を指定します。
stop_loss
optional
number
決済逆指値の価格を指定します。
client_order_id
optional
string
36byteまでの一意の文字列を指定できます。 詳しくはページ下部をご覧ください。
Response
200: OK
レバレッジ4倍でのXRP/JPYのサンプルレスポンス
{
'id': 123456789,
'order_type': 'market',
'quantity': '1.0',
'disc_quantity': '0.0',
'iceberg_total_quantity': '0.0',
'side': 'buy',
'filled_quantity': '1.0',
'price': 27.152,
'created_at': 12345,
'updated_at': 12346,
'status': 'filled',
'leverage_level': 4,
'source_exchange': 'QUOINE',
'product_id': 83,
'margin_type': 'cross',
'take_profit': '0.0',
'stop_loss': '0.0',
'trading_type': 'cfd',
'product_code': 'CASH',
'funding_currency': 'JPY',
'crypto_account_id': None,
'currency_pair_code': 'XRPJPY',
'average_price': 0.0,
'target': 'open',
'order_fee': 0.0,
'source_action': 'manual',
'unwound_trade_id': None,
'trade_id': '98765',
'client_order_id': None
}

Request Body の例

指値
成行
レンジ付き成行
逆指値
トレール
指値
{
"order": {
"order_type": "limit",
"product_id": 5,
"side": "buy",
"quantity": 0.1,
"price": 1000000
}
}
成行
{
"order": {
"order_type": "market",
"product_id": 5,
"side": "buy",
"quantity": 0.1
}
}
レンジ付き成行
{
"order": {
"order_type": "market_with_range",
"product_id": 5,
"side": "buy",
"quantity": 0.1,
"price_range": 1000
}
}
逆指値
{
"order": {
"order_type": "stop",
"product_id": 5,
"side": "buy",
"quantity": 0.1,
"price": 10000
}
}
トレール
# トレール幅を価格で指定する場合
{
"order": {
"order_type": "trailing_stop",
"product_id": 5,
"side": "buy",
"quantity": 0.1,
"trailing_stop_type": "fiat",
"trailing_stop_value": 10000
}
}
# トレール幅を価格の変動割合で指定する場合
"order": {
"order_type": "trailing_stop",
"product_id": 5,
"side": "buy",
"quantity": 0.1,
"trailing_stop_type": "percentage",
"trailing_stop_value": 10
}
}

Client order ID について

Client order ID

client_order_id はAPI新規注文時にで送信できる最大36byteの文字列です。 全ての注文で一意である必要があり、取引システム等で注文を識別するために使用できます。

注文を作成する時に一意の client_order_id を指定するとリクエストの認証に使用されるJWTからnonceパラメータを省略できます。 これによりトレーディングシステムは競合状態のリスク無しで並行して注文する事が可能です。

APIは最近使用した100個の client_order_id のパラメーターを検証します。 その為100を超える注文を出した後に、以前使用した値を再利用した場合は予期しない動作をする場合があります。 client_order_id の再利用にはご注意ください。