Get derivatives positions
Returns a list of derivatives positions for a specific currency type with summary information and optional date filtering.
Authorization
LuxorAPIKey Use your API key here.
In: header
Path Parameters
Currency type for derivatives operations
Value in
- "BTC"
- "USD"
Query Parameters
datedate1 <= value11 <= value10Response Body
application/json
application/json
curl -X GET "https://example.com/v2/derivatives/positions/BTC"{ "currency_type": "BTC", "start_date": "2025-09-01", "end_date": "2025-10-01", "summary": { "realized_gain_loss": 32.74492868, "unrealized_gain_loss": 0, "total_gain_loss": 32.74492868, "margin_requirement": 6.9700358 }, "positions": [ { "date": "2025-09-11", "net_position_ph": -37249, "net_position_wavg": 0.00005466, "net_position_reference_rate": null, "wavg_long_hashprice": 0.00005466, "total_ph_long": 9551, "long_gain_loss": -3.37496788, "position_breakdown_reference_rate": null, "short_gain_loss": 4.01998183, "total_ph_short": 46800, "wavg_short_hashprice": 0.00005802, "unrealized_gain_loss": 0, "realized_gain_loss": 0.12599658, "total_gain_loss": 0.12599658, "initial_margin_percentage": 0.87, "maintenance_margin": 0.14, "upfront_long_ph": 1252, "margin_required": 0.12599658, "delivery_quota_ph": 870, "notional_delivery_quota": 4.2773539 } ]}{ "statusCode": 400, "code": "FST_ERR_VALIDATION", "error": "Bad Request", "message": "body/end_date Required"}Get derivatives payments
Returns a list of derivatives payments for a specific currency type with optional filtering by payment type.
Place derivatives orders
Places up to 500 orders in one request — the same bulk path the CSV import uses in the app. Responds 202: the batch is handed to a workflow rather than written straight to the book, and if the workspace requires approvals the orders wait for them. `required_approvals` says how many are outstanding (0 means the batch is already on its way), and the orders appear under GET /v2/derivatives/orders once it completes. The batch is all-or-nothing: if any order is rejected, none are placed. Placing orders requires the Workspace Owner, Workspace Admin or Derivatives Admin role and a signed ISDA agreement; without either the request is rejected with 403.