Account Management
Private
Retrieves the open position for a specific instrument. Returns detailed position information including size, average entry price, mark price, unrealized P&L, initial margin, maintenance margin, and other position-related metrics.
If no position exists for the specified instrument, the response will indicate a zero position.
Scope: trade:read
get/private/get_position
Request
- Base URLhttps://test.deribit.com/api/v2
- URLhttps://test.deribit.com/api/v2/private/get_position
- Authnone declared
Query parameters
instrument_namestring required
Unique instrument identifier
Example:BTC-PERPETUAL
Instrument name
Response
Success response
Example response
{
"result": {
"instrument_name": "BTC-PERPETUAL",
"user_id": 57874
}
}Changes
- breaking
the
/////response's property type changed fromintegertonumberfor status
- breaking
- info
added the required property
/////to the response with the status
- info