Struct DeribitRawHttpClient 

pub struct DeribitRawHttpClient { /* private fields */ }

Low-level Deribit HTTP client for raw API operations.

This client handles JSON-RPC 2.0 protocol, request signing, rate limiting, and retry logic. It returns venue-specific response types.

Implementations

impl DeribitRawHttpClient

pub fn new( base_url: Option<String>, is_testnet: bool, timeout_secs: Option<u64>, max_retries: Option<u32>, retry_delay_ms: Option<u64>, retry_delay_max_ms: Option<u64>, proxy_url: Option<String>, ) -> Result<Self, DeribitHttpError>

Creates a new DeribitRawHttpClient.

Errors

Returns an error if the HTTP client cannot be created.

pub fn cancellation_token(&self) -> &CancellationToken

Get the cancellation token for this client.

pub fn with_credentials( api_key: String, api_secret: String, base_url: Option<String>, is_testnet: bool, timeout_secs: Option<u64>, max_retries: Option<u32>, retry_delay_ms: Option<u64>, retry_delay_max_ms: Option<u64>, proxy_url: Option<String>, ) -> Result<Self, DeribitHttpError>

Creates a new DeribitRawHttpClient with explicit credentials.

Errors

Returns an error if the HTTP client cannot be created.

pub fn new_with_env( api_key: Option<String>, api_secret: Option<String>, is_testnet: bool, timeout_secs: Option<u64>, max_retries: Option<u32>, retry_delay_ms: Option<u64>, retry_delay_max_ms: Option<u64>, proxy_url: Option<String>, ) -> Result<Self, DeribitHttpError>

Creates a new DeribitRawHttpClient with credentials from environment variables.

If api_key or api_secret are not provided, they will be loaded from environment:

• Mainnet: DERIBIT_API_KEY, DERIBIT_API_SECRET
• Testnet: DERIBIT_TESTNET_API_KEY, DERIBIT_TESTNET_API_SECRET

Errors

Returns an error if:

• The HTTP client cannot be created
• Credentials are not provided and environment variables are not set

pub async fn get_instruments( &self, params: GetInstrumentsParams, ) -> Result<DeribitJsonRpcResponse<Vec<DeribitInstrument>>, DeribitHttpError>

Gets available trading instruments.

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_instrument( &self, params: GetInstrumentParams, ) -> Result<DeribitJsonRpcResponse<DeribitInstrument>, DeribitHttpError>

Gets details for a specific trading instrument.

Errors

Returns an error if the request fails or the response cannot be parsed.

pub async fn get_account_summaries( &self, params: GetAccountSummariesParams, ) -> Result<DeribitJsonRpcResponse<DeribitAccountSummariesResponse>, DeribitHttpError>

Gets account summaries for all currencies.

Errors

Returns an error if:

• Credentials are missing (DeribitHttpError::MissingCredentials)
• Authentication fails (invalid signature, expired timestamp)
• The request fails or the response cannot be parsed

Trait Implementations

impl Debug for DeribitRawHttpClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.