Skip to main content

Standard API

The Standard API is the Trader API on the main Figure Markets web hosts (www.figuremarkets.dev / www.figuremarkets.com), under path /trader. It covers Accounts (portfolio balances and transfer history), Orders ( YLDS placement, order-book reporting, longer-retention history), margin (leverage), and OAuth.

It does not include low-latency order entry on trade.figuremarkets.* — that is Trading (low-latency REST).

You use the same Trader API credentials and bearer token as for low-latency trading, but every call in this section goes to the www.figuremarkets.*/trader, not to trade.figuremarkets.*.


Base path (main domain)

Standard REST uses the main host — the same hostname as the Figure Markets web app — plus /trader.

  • UAT: https://www.figuremarkets.dev/trader
  • Production: https://www.figuremarkets.com/trader

Paths in this section are relative to that base (for example GET /api/v2/accounts/balances, POST /api/v1/margin, GET /api/v1/orders/trades). Full URL = REST base + path.

Send Authorization: Bearer {access_token} on every request. OAuth uses the same base: in UAT, POST https://www.figuremarkets.dev/auth/oauth2/token (not on the trade.figuremarkets.* host). See Authentication — Obtaining an access token.

Versioning: We do not remove fields or change types for existing keys within a given API version. We may add new fields without a version bump. See API versioning for the full policy.


Sections

SectionWhat it coversGuide
AccountsPortfolio balances; account transfer history.Accounts
OrdersYLDS placement; get an order; search/list orders and trades; longer-retention order history vs low-latency trading API.Orders
Leverage (margin)Enable margin, create margin loans, repay loans, loan balances and history.Leverage (margin)

Public (unauthenticated) data such as leverage pools and market data is in the Public API; we link to that from the guides above and do not duplicate it here.


Specs

OpenAPI: Trader API (standard REST).

Also listed in OpenAPI specs.