Struct PolymarketGammaHttpClient 

pub struct PolymarketGammaHttpClient { /* private fields */ }

Provides a domain HTTP client for Polymarket instrument fetching.

Wraps PolymarketGammaRawHttpClient with instrument parsing: fetch from the Gamma API and parse into Nautilus types. Stateless with respect to instrument storage; caching is handled by the instrument provider.

Implementations

impl PolymarketGammaHttpClient

pub fn new( gamma_base_url: Option<String>, timeout_secs: u64, retry_config: RetryConfig, ) -> StdResult<Self, HttpClientError>

Creates a new PolymarketGammaHttpClient.

Errors

Returns an error if the underlying HTTP client cannot be created.

pub async fn request_instruments(&self) -> Result<Vec<InstrumentAny>>

Fetches instruments from the Gamma API and returns Nautilus domain types.

Errors

Returns an error if the HTTP request or parsing fails.

pub async fn request_instruments_by_slugs( &self, slugs: Vec<String>, ) -> Result<Vec<InstrumentAny>>

Fetches instruments for the given slugs concurrently.

Each slug is queried individually via the Gamma API. Missing or unparsable slugs are logged and skipped.

Errors

Returns an error if all slug requests fail. Individual slug failures are warned and skipped when at least one slug succeeds.

pub async fn request_instruments_by_slugs_with_retry( &self, slugs: Vec<String>, ) -> Result<Vec<InstrumentAny>>

Fetches instruments for the given slugs with retry on empty results.

Uses the client’s [RetryManager] with exponential backoff. Gamma API may not have indexed a newly created market yet, so empty results are treated as retryable (indexing lag). HTTP errors are also retried per the standard is_retryable() classification.

pub async fn request_instruments_by_event_slugs( &self, event_slugs: Vec<String>, ) -> Result<Vec<InstrumentAny>>

Fetches instruments from event slugs concurrently.

Each slug queries GET /events?slug=, extracts the markets array from the first matching event, and parses each market into instruments.

pub async fn request_instruments_by_params( &self, base_params: GetGammaMarketsParams, ) -> Result<Vec<InstrumentAny>>

Fetches instruments using arbitrary Gamma API query params with auto-pagination.

pub async fn request_instruments_by_event_query( &self, event_slug: &str, params: GetGammaMarketsParams, ) -> Result<Vec<InstrumentAny>>

Fetches instruments from an event slug with client-side sorting and limiting.

The /events?slug= response already includes the full markets array, so no second API call is needed. Sorting and truncation are applied client-side using fields from GetGammaMarketsParams:

• order: sort field ("liquidity", "volume", "volume24hr")
• ascending: sort direction (default: descending)
• max_markets: truncate after sorting

pub async fn request_instruments_by_event_params( &self, params: GetGammaEventsParams, ) -> Result<Vec<InstrumentAny>>

Fetches instruments from events matching full query params (paginated).

pub async fn request_instruments_by_search( &self, params: GetSearchParams, ) -> Result<Vec<InstrumentAny>>

Searches for instruments via the Gamma public search endpoint.

pub async fn request_tags(&self) -> Result<Vec<GammaTag>>

Fetches available tags from the Gamma API.

pub fn inner(&self) -> &Arc<PolymarketGammaRawHttpClient>

Returns a reference to the underlying raw HTTP client.

Trait Implementations

impl Clone for PolymarketGammaHttpClient

fn clone(&self) -> PolymarketGammaHttpClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PolymarketGammaHttpClient

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

Formats the value using the given formatter.