ポジション情報

get
ポジション情報の取得

https://api.liquid.com/trades
オープンポジション、クローズポジションの各種情報を取得出来ます。
Request
Response
Request
Query Parameters
funding_currency
optional
string
使用した証拠金を指定します。
status
optional
string
ステータスをいずれかで指定します。 open, closed
Response
200: OK
{
'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/{id}/close
ポジションIDを指定して特定のポジションをクローズします。
Request
Response
Request
Path Parameters
id
required
integer
ポジションIDを指定します。
Query Parameters
closed_quantity
optional
number
指定の数量分だけクローズできます。
Response
200: OK
{
'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
Response
Request
Body Parameters
side
optional
string
"buy", "sell" を指定する事でどちらか一方向だけをクローズする事が可能です。
Response
200: OK
[
{
"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/{id}
まだクローズされていないポジションにTPやSLを設定します。
Request
Response
Request
Path Parameters
id
required
integer
ポジションIDを指定します。
Body Parameters
take_profit
optional
string
決済指値を変更できます。
stop_loss
optional
string
決済逆指値を変更できます。
Response
200: OK
{
"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"
}