API Reference

Get Trading Limits

Provides real-time trading limits based on global, user, and asset-specific exposure limits.

User Limits:

  • The "Active Notional Value" limit is based on the dollar value of outstanding attestations. That is, if a user has a limit of $1,000,000, and has 30 non-expired, non-filled attestation at a value of $999,000, they will not be able to request another attestation for $1000.
  • The "Session Notional Value" limit is based on the dollar value of executed attestations within the current session. That is, if a user has a session notional limit of $10,000,000 and already executed $9,000,000, they can only buy or sell another $1,000,000 until the next session. "Session" is defined as a market session, i.e. premarket/regular/postmarket/overnight.
  • The "Active Attestations" limits the number of non-expired, non-executed attestations. For example if the limit is 50, and a user has 50 outstanding attestations, they must wait for one to execute or expire before requesting another.

If the market is closed or paused, the response will indicate that trading is not allowed and provide the reason. For more information on market hours, see the /v1/status/market endpoint.

Trading Limits Reason Codes

When trading is not allowed, the response will include a reason field which may include one of the following common codes:

  • MARKET_CLOSED: Market is closed.
  • MARKET_PAUSED: Market is temporarily paused.
  • ASSET_PAUSED: Specific asset is paused.
  • MAX_LIMIT_REACHED: Maximum limit has been reached.
  • MAX_ATTESTATIONS: Maximum attestations reached.
Language
Credentials
Header
Click Try It! to start a request and see the response here!