新規注文

新規注文(現物)

POST https://api.liquid.com/orders

現物で新規に注文を出す場合に利用します。

Request Body

Name	Type	Description
quantity	number	取引する数量を指定します。
order_type	string	注文のタイプを指定します。
product_id	integer	取引するマーケットのidを指定します。
side	string	buy, sell いずれかを指定します。
order_direction	string	注文の方向を指定します。 one_direction : 両建てなし two_direction : 両建てあり netout : ネットアウト
client_order_id	string	36byteまでの一意の文字列を指定します。 詳しくはページ下部をご覧ください。

200

{
    '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 Body

Name	Type	Description
leverage_level	integer	レバレッジの倍率を指定します。 2 が指定できます。 法人アカウントの場合は通貨ペアにより異なります。詳しくはこちらhttps://support-jp.liquid.com/hc/ja/articles/360060026131
order_type	string	注文タイプを指定します。
product_id	integer	取引するマーケットのidを指定します。
side	string	buy, sell いずれかを指定します。
quantity	number	取引する数量を指定します。
order_direction	string	注文の方向を指定します。 one_direction : 両建てなし two_direction : 両建てあり netout : ネットアウト
take_profit	number	決済指値の価格を指定します。
stop_loss	number	決済逆指値の価格を指定します。
client_order_id	string	36byteまでの一意の文字列を指定できます。 詳しくはページ下部をご覧ください。

200 レバレッジ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 の再利用にはご注意ください。