Visión general
La API de Deribit permite a los usuarios recuperar los registros históricos de operaciones y pedidos mediante el uso de historical parámetro.
Si bien los registros recientes (30 minutos para pedidos y 24 horas para operaciones) se puede acceder sin este parámetro, solo se almacenan temporalmente y, finalmente, se eliminan. Después de este período, los registros solo están disponibles a través del parámetro histórico.
Periodos de retención:
-
Pedidos recientes: Disponible para 30 minutos antes de la extracción.
-
Operaciones recientes: Disponible para 24 horas antes de la extracción.
-
Registros históricos: Persistir indefinidamente.
Terminales compatibles
Los siguientes puntos finales de API admiten la recuperación de datos históricos:
-
private/get_order_history_by_instrument -
private/get_order_history_by_currency -
private/get_user_trades_by_instrument -
private/get_user_trades_by_instrument_and_time -
private/get_user_trades_by_currency -
private/get_user_trades_by_currency_and_time -
private/get_user_trades_by_order
Uso de la API
Para recuperar operaciones y órdenes históricas, utilice historical parámetro en su solicitud de API a cualquiera de los puntos finales enumerados anteriormente.
-
historical: false→ Recupera los registros recientes (disponibles inmediatamente después de la ejecución). -
historical: true→ Recupera los registros históricos (disponibles tras un breve retraso para su indexación).
Ejemplo de solicitud:
{
"method": "private/get_user_trades_by_currency",
"params": {
"currency": "ETH",
"historical": true
},
"jsonrpc": "2.0",
"id": 2
}
Ejemplo de respuesta:
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"trades": [
{
"timestamp": 1741270338502,
"state": "open",
"price": 1355.9,
"direction": "sell",
"index_price": 2246.9768,
"instrument_name": "ETH_USDC",
"trade_seq": 18009,
"api": false,
"amount": 0.2505,
"mark_price": 2246.9768,
"order_id": "ETH_USDC-109841952",
"matching_id": null,
"tick_direction": 3,
"fee": 0,
"profit_loss": null,
"mmp": false,
"post_only": false,
"self_trade": false,
"contracts": 2505,
"original_order_type": "market",
"trade_id": "ETH_USDC-18820350",
"fee_currency": "USDC",
"order_type": "limit",
"risk_reducing": false,
"liquidity": "M"
},
{
"timestamp": 1741270338460,
"state": "open",
"price": 1355.9,
"direction": "sell",
"index_price": 2246.9768,
"instrument_name": "ETH_USDC",
"trade_seq": 18006,
"api": false,
"amount": 0.2505,
"mark_price": 2246.9768,
"order_id": "ETH_USDC-109841952",
"matching_id": null,
"tick_direction": 3,
"fee": 0,
"profit_loss": null,
"mmp": false,
"post_only": false,
"self_trade": false,
"contracts": 2505,
"original_order_type": "market",
"trade_id": "ETH_USDC-18820345",
"fee_currency": "USDC",
"order_type": "limit",
"risk_reducing": false,
"liquidity": "M"
}
],
"has_more": true
}
}