Skip to main content

RateLimiter

polyoxide_core::rate_limit

Struct RateLimiter

pub struct RateLimiter { /* private fields */ }

Expand description

Holds all rate limiters for one API surface.

Created via factory methods like RateLimiter::clob_default() which configure hardcoded limits matching Polymarket’s documented rate limits.

Implementations§

impl RateLimiter

pub async fn acquire(&self, path: &str, method: Option<&Method>)

Await the appropriate limiter(s) for this endpoint.

Always awaits the default (general) limiter, then additionally awaits the first matching endpoint-specific limiter (burst + sustained).

pub fn clob_default() -> Self

CLOB API rate limits.

Transcribed from https://docs.polymarket.com/api-reference/rate-limits as fetched on 2026-07-25, and pinned by the documented_limits tests.

Two things about the published tables need interpreting:

The ledger group cap (900/10s across /trades, /orders, /notifications and /order) is genuinely shared, so those entries hold clones of one shared bucket rather than four of their own.
That group names /order and /orders, which also appear in the trading table at 5,000 and 2,000 per 10s. Both tables can only hold simultaneously if the group cap governs the ledger reads; a 900/10s cap on all methods would make the published trading burst unreachable. The group is therefore scoped to GET.

Ordering matters wherever one pattern is a path-segment prefix of another: /balance-allowance/update must precede /balance-allowance, and the specific /data/* routes must precede the /data catch-all.

pub fn gamma_default() -> Self

Gamma API rate limits.

General: 4,000/10s
/events: 500/10s
/markets: 300/10s
/public-search: 350/10s
/comments: 200/10s
/tags: 200/10s
/ok: 100/10s

Upstream also lists a 900/10s cap shared by /markets + /events. It is not modelled because it can never bind: the per-endpoint caps of 300 and 500 sum to 800, which is already below it.

pub fn data_default() -> Self

Data API rate limits.

General: 1,000/10s
/trades: 200/10s
/positions and /closed-positions: 150/10s
/ok: 100/10s

pub fn relay_default() -> Self

Relay API rate limits.

25 requests per 1 minute (single limiter, no endpoint-specific limits)

Trait Implementations§

impl Clone for RateLimiter

fn clone(&self) -> RateLimiter

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

impl Debug for RateLimiter

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

impl Freeze for RateLimiter

impl RefUnwindSafe for RateLimiter

impl Send for RateLimiter

impl Sync for RateLimiter

impl Unpin for RateLimiter

impl UnsafeUnpin for RateLimiter

impl UnwindSafe for RateLimiter

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dest. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T> Same for T

type Output = T

Should always be Self

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more