ポジション情報

ポジション情報の取得

GET https://api.liquid.com/trades

オープンポジション、クローズポジションの各種情報を取得出来ます。

Query Parameters

Name	Type	Description
funding_currency	string	使用した証拠金を指定します。
status	string	ステータスをいずれかで指定します。 open, closed

200

{
    'models': [
        {
            'id': 12345,
            'currency_pair_code': 'BTCJPY',
            'status': 'closed',
            'side': 'short',
            'margin_used': '0.0',
            'open_quantity': '0.0',
            'close_quantity': '0.003',
            'quantity': '0.003',
            'leverage_level': 4,
            'product_code': 'CASH',
            'product_id': 5,
            'open_price': '1070000.0',
            'close_price': '1131820.0',
            'trader_id': 93712,
            'open_pnl': 0.0,
            'close_pnl': '-185.46',
            'pnl': -185.46,
            'stop_loss': '0.0',
            'take_profit': '0.0',
            'margin_type': 'cross',
            'funding_currency': 'JPY',
            'total_interest': '9.63',
            'created_at': 12345,
            'updated_at': 12345,
            'total_fee': 0.0,
            'close_fee': '0.0',
            'liquidation_price': None,
            'maintenance_margin': None,
            'trading_type': 'cfd',
            'last_settlement_at': None
        }
    ],
    'current_page': 0,
    'total_pages': 10000
}

ポジション決済（単一）

PUT https://api.liquid.com/trades/{trade_id}/close

ポジションIDを指定して特定のポジションをクローズします。

Path Parameters

Name	Type	Description
trade_id*	integer	ポジションIDを指定します。

Query Parameters

Name	Type	Description
closed_quantity	number	指定の数量分だけクローズできます。

200

{
    'id': 12345,
    'currency_pair_code': 'XRPJPY',
    'status': 'open',
    'side': 'long',
    'margin_used': '7.91075',
    'open_quantity': '1.0',
    'close_quantity': '0.0',
    'quantity': '1.0',
    'leverage_level': 4,
    'product_code': 'CASH',
    'product_id': 83,
    'open_price': '31.643',
    'close_price': '31.666',
    'trader_id': 93712,
    'open_pnl': 0.023,
    'close_pnl': '0.0',
    'pnl': 0.023,
    'stop_loss': '0.0',
    'take_profit': '0.0',
    'margin_type': 'isolated',
    'funding_currency': 'JPY',
    'total_interest': '0.0',
    'created_at': 12345,
    'updated_at': 12345,
    'total_fee': 0.0,
    'close_fee': '0.0',
    'liquidation_price': '24.99797',
    'maintenance_margin': '1.26572',
    'trading_type': 'cfd',
    'last_settlement_at': None
}

ポジジョン決済（全て）

PUT https://api.liquid.com/trades/close_all

保有しているポジションを全てクローズします。 オプションを使用して特定の方向のみクローズする事も可能です。

Request Body

Name	Type	Description
side	string	"buy", "sell" を指定する事でどちらか一方向だけをクローズする事が可能です。

200

[
  {
    "id": 12345,
    "currency_pair_code": "BTCUSD",
    "status": "closed",
    "side": "short",
    "margin_type": "cross",
    "margin_used": "0.83588",
    "liquidation_price": null,
    "maintenance_margin": null,
    "open_quantity": "0.01",
    "close_quantity": "0.0",
    "quantity": "0.01",
    "leverage_level": 5,
    "product_code": "CASH",
    "product_id": 1,
    "open_price": "417.65",
    "close_price": "417.0",
    "trader_id": 3020,
    "open_pnl": "0.0",
    "close_pnl": "0.0065",
    "pnl": "0.0065",
    "stop_loss": "0.0",
    "take_profit": "0.0",
    "funding_currency": "USD",
    "created_at": 12345,
    "updated_at": 12345,
    "total_interest": "0.02"
  }, 
  ...
]

ポジション編集

PUT https://api.liquid.com/trades/{trade_id}

まだクローズされていないポジションにTPやSLを設定します。

Path Parameters

Name	Type	Description
trade_id*	integer	ポジションIDを指定します。

Request Body

Name	Type	Description
take_profit	string	決済指値を変更できます。
stop_loss	string	決済逆指値を変更できます。

200

{
  "id": 12345,
  "currency_pair_code": "BTCUSD",
  "status": "open",
  "side": "short",
  "margin_type": "cross",
  "margin_used": "0.83588",
  "liquidation_price": null,
  "maintenance_margin": null,
  "open_quantity": "0.01",
  "close_quantity": "0.0",
  "quantity": "0.01",
  "leverage_level": 5,
  "product_code": "CASH",
  "product_id": 1,
  "open_price": "417.65",
  "close_price": "0",
  "trader_id": 3020,
  "open_pnl": "0.0",
  "close_pnl": "0.0065",
  "pnl": "0.0065",
  "stop_loss": "300.0",
  "take_profit": "600.0",
  "funding_currency": "USD",
  "created_at": 12345,
  "updated_at": 12345,
  "total_interest": "0.02"
}