For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /documentation/changelog.md.
API Change Log
Every documented change across the True Markets API references, in one timeline, newest first. Each entry links to the reference it belongs to; the version shown is that API's own, which advances independently of the others.
| Date | API | Version | Notes |
|---|---|---|---|
| 2026-10-13 | Trading REST | v1.39.0 | Breaking: the allocation and release endpoints moved from /cefi/ to /custody/: GET/POST /custody/allocations, GET /custody/allocations/{id}, GET/POST /custody/releases and GET /custody/releases/{id}. The /cefi/ paths are no longer served. Their tag is renamed from CeFi to Custody. |
| 2026-10-12 | CeFi direct WebSocket | v1.0.10 | Added the opt-in HEARTBEAT channel: a HEARTBEAT message after 10 seconds with no other traffic on the connection. |
| 2026-10-12 | Trading REST | v1.38.0 | POST /orders takes an optional venue: smart (the default), cefi or defi. cefi and defi send the order to the asset's listing on that venue, whichever listing asset_id names, and answer 400 when the asset has none there. smart lets the conductor choose between the two listings of an asset that trades on both venues (a CeFi listing that settles to DeFi and the DeFi listing it settles on): a market order goes to the better price after fees, a limit order to CeFi, and when only one venue is open to the user the order goes there. For users not yet released to smart routing, smart sends the order to the listing it names. The response returns venue, where the order went, and route_reason when the conductor chose it. Sign whatever payloads come back, whichever venue was chosen. |
| 2026-10-08 | CeFi direct REST | v1.0.7 | Add client fees endpoint. |
| 2026-10-08 | Trading REST | v1.37.0 | Added the CeFi endpoints. POST /cefi/allocations allocates part of the caller's DeFi wallet balance to CeFi trading without moving tokens, and POST /cefi/releases releases it again; both answer 202, and GET /cefi/allocations/{id} and GET /cefi/releases/{id} report the outcome. Added POST /paper/deposits and POST /paper/withdrawals, served only in non-production paper-trading environments, which add test funds to the caller's paper wallet (allocating them to CeFi trading by default) and send test funds back out. |
| 2026-10-06 | Accounts REST | v1.20.0 | Added GET /me/trading, which reports the caller's wallets, the CeFi and DeFi venues they can trade on, and the custody rails their CeFi trades can settle on. It accepts TM-On-Behalf-Of. GET /kyc/status no longer returns cefi_trading_account; read trading.cefi.enabled from GET /me/trading instead. |
| 2026-10-06 | Market data REST | v0.18.0 | Every operation has a stable operationId (getPrices, getPriceHistory, listMarketCaps, …), so generated client method names change; getV1DefiMarketPricesIndicators and getV1CefiMarketPricesIndicators are now getPriceIndicators and getCefiPriceIndicators. |
| 2026-10-06 | Trading REST | v1.36.0 | CeFi spot listings in GET /assets and GET /assets/{chain}/{address} carry settlement (paxos or defi). A listing settles on defi only when both its base and its instrument's quote asset are DEFI-custodied. Orders on a defi listing require only a CeFi trading account; orders on a paxos listing still require Paxos KYC, and either missing answers 403 with code kyc_required. |
| 2026-10-05 | Accounts REST | v1.17.1 | Authentication describes the Gateway and Trading API credential paths separately: an organization token lasts one hour with no refresh token, and a Gateway client signs payloads with each user's signer key. organization_id says where the id comes from. |
| 2026-10-05 | Authentication REST | v1.3.2 | Authentication describes the Gateway and Trading API credential paths separately. An organization key's token lasts one hour with no refresh token, and organization_id says where the id comes from. |
| 2026-10-05 | Trading REST | v1.35.0 | CeFi spot listings in GET /assets and GET /assets/{chain}/{address} carry cefi_instrument, the TrueX instrument symbol the listing trades on (e.g. NVDAC-USDC). A CeFi order's quote_asset is its listing's instrument quote, and a buy short of a non-PYUSD quote answers 422 with code insufficient_balance instead of bridging. |
| 2026-10-05 | Trading REST | v1.33.1 | Authentication describes the Gateway and Trading API credential paths separately: an organization token lasts one hour with no refresh token, and a Gateway client signs payloads with each user's signer key. UnsignedPayload and the execute requests say which bytes to sign and what one signatures entry contains, and organization_id says where the id comes from. |
| 2026-09-29 | Trading REST | v1.32.0 | POST /quotes returns notional, the quote asset amount the order is expected to execute, and fee, the expected taker fee in quote asset units. qty is documented as the base asset quantity for every side and qty_unit, which is what it has always returned. |
| 2026-09-29 | Trading REST | v1.31.0 | Chain accepts robinhood (Robinhood Chain, an Arbitrum-based Ethereum L2) for DeFi orders, alongside solana, base, hypercore-spot, and hypercore-perp. |
| 2026-09-28 | Accounts REST | v1.17.0 | Grouped POST/GET /organizations/{organization_id}/users and GET /organizations/{organization_id}/users/{user_id} under a public Organizations tag. |
| 2026-09-28 | Trading REST | v1.31.1 | Declared TM-On-Behalf-Of as a header parameter on every user route, documented acting for a user under Authentication, and listed the 400, 401, 403 and 500 responses every user route can return. |
| 2026-09-15 | Market data REST | v0.15.0 | GET /v1/defi/market/prices accepts asset_class, matching prices/history and prices/candles; fixes a symbol listed on both spot and perp always returning the perp series. |
| 2026-09-02 | CeFi direct REST | v1.0.6 | Remove the deprecated /api/v1/ paths. |
| 2026-08-27 | Trading REST | v1.30.0 | Added GET /assets/{chain}/{address}, which returns one catalog listing in the same shape GET /assets returns, replacing the retired DeFi-service asset lookup. Chain and address match case-insensitively. |
| 2026-08-19 | Trading REST | v1.28.0 | Added GET /transactions, one paginated feed of the caller's orders, transfers, and ramps, so clients no longer merge the per-type endpoints themselves. Order responses carry qty_unit. |
| 2026-08-18 | Trading REST | v1.27.0 | GET /assets/availability accepts an optional bearer token and resolves availability for the authenticated caller when one is supplied. |
| 2026-08-17 | Trading REST | v1.26.0 | POST /ramps accepts direction=onramp, which buys crypto with fiat and returns the provider page in redirect_url. Adds the onramp-only payment methods APPLE_PAY and GOOGLE_PAY, which require the new channel field (web/ios/android). Provider preconditions the caller can clear now answer 422, and an expired phone verification answers 409. The signing relays remain offramp-only. |
| 2026-08-17 | Trading REST | v1.25.0 | Trading is restricted by the country the request comes from: POST /orders returns 403 when the asset is not available there. Added GET /assets/availability, which reports the product types and asset classes the caller's country may trade. |
| 2026-08-14 | Trading REST | v1.24.0 | Added the ramp endpoints: POST /ramps creates an offramp and tops any shortfall up from the user's CeFi balance, then POST /ramps/{id}/bridge/execute, POST /ramps/{id}/prepare, POST /ramps/{id}/execute, and GET /ramps/{id} carry it to settlement. GET /ramps lists the caller's ramps. The venue is chosen with payment_method; the provider is resolved downstream. |
| 2026-08-14 | Trading REST | v1.23.0 | GET /assets accepts product_type (renamed from type, which stays as a deprecated alias) and a new asset_class (crypto, stock) defaulting to crypto. Assets carry asset_class, orthogonal to type: a tokenized stock is an ordinary spot listing. |
| 2026-07-30 | CeFi direct WebSocket | v1.0.9 | Timestamp validation now allows a 1-second future grace window (accepted window: 15s past to 1s future of server time). Documented how to avoid timestamp-based subscription rejects. |
| 2026-07-29 | Market data REST | v0.11.0 | prices/indicators gained the momentum measures surging_1h, surging_4h, surging_24h and trending_ratio; the surging measures serve on CeFi too, trending_ratio needs a resolution of at least 1h. |
| 2026-07-29 | Market data REST | v0.10.0 | Added GET /v1/defi/market/prices/candles, returning OHLC buckets for tick-backed price sources. prices/indicators gained atr and now rejects a sub-1h resolution for windows over 1d. |
| 2026-07-28 | CeFi direct WebSocket | v1.0.8 | ERROR confirmations may now carry a message explaining the failure. DROPCOPY subscriptions made while the exchange catalog is still syncing receive a retry message instead of being silently dropped. |
| 2026-07-24 | Trading REST | v1.22.0 | Asset listings carry a status (active, preview, sell_only, transfer_only, disabled), enforced on order create. Transfer endpoints document their 400, 403, 404, and 500 responses. |
| 2026-07-23 | Trading REST | v1.21.0 | Order responses carry asset_type (spot or perp), separating perp orders from spot orders on the same symbol. |
| 2026-07-20 | Accounts REST | v1.11.2 | Account creation and funding endpoints made public and grouped under KYC, Account, Deposits, and Reference. |
| 2026-07-16 | Trading REST | v1.20.0 | Added take-profit / stop-loss triggers for Hyperliquid perps, and max_leverage on perp assets in GET /assets. |
| 2026-07-15 | Trading REST | v1.19.0 | Perp assets carry hourly market data — funding, open interest, and volume. |
| 2026-07-14 | CeFi direct WebSocket | v1.0.7 | Added AUCTION channel streaming the opening-auction indicative (SNAPSHOT/UPDATE + SNAPSHOT_COMPLETE). The payload carries a type discriminator (currently always OPENING). |
| 2026-07-10 | Accounts REST | v1.11.1 | Document org scope reads and writes are org-wide for any member, not org-admins only. |
| 2026-07-08 | CeFi direct WebSocket | v1.0.6 | Canonical endpoint moved to wss://api.truemarkets.co/v1/cefi/market; legacy wss://api.truex.co/api/v1 deprecated (still supported). Authenticated signatures accept the canonical or legacy path. Documented retail ES256 subscription auth. |
| 2026-07-08 | Market data REST | v0.8.0 | Price history, range, and point endpoints accept asset_class, serving historical prices for Hyperliquid perps. |
| 2026-07-08 | Trading REST | v1.18.0 | GET /assets accepts a type parameter gating perp assets. Failed CeFi orders carry failure_reason. |
| 2026-07-07 | Trading REST | v1.17.0 | POST /orders can return 422 when an asset cannot be resolved. |
| 2026-07-01 | Trading REST | v1.16.0 | Added GET /positions for read-only Hyperliquid perp positions, and POST /orders/all/cancel for CeFi mass cancels. |
| 2026-06-30 | Trading REST | v1.15.1 | Documented the insufficient-balance case: a DeFi order the account cannot fund returns the quote with an Insufficient balance entry in quote.issues, an empty order_id, and no payloads. |
| 2026-06-29 | Accounts REST | v1.9.3 | Deposit read endpoints grouped under the Deposits tag. |
| 2026-06-29 | Authentication REST | v1.3.1 | GET /health and GET /.well-known/jwks.json marked internal. POST /api-key/token and POST /token/refresh consolidated under one Authentication tag. |
| 2026-06-26 | Market data WebSocket | v0.0.2 | Topic-based subscriptions; stream messages carry the concrete topic. |
| 2026-06-26 | Trading REST | v1.15.0 | Added POST /orders/{id}/cancel and /cancel/execute for Hyperliquid limit orders. DELETE /orders/{id} is deprecated. |
| 2026-06-25 | Trading REST | v1.14.0 | Perp orders accept leverage (1–50, isolated margin) and reduce_only. |
| 2026-06-24 | Accounts REST | v1.9.2 | Documented production and UAT base URLs and the JWT auth flow. POST /deposits/addresses and POST /deposits/wire-instructions marked internal. |
| 2026-06-24 | Trading REST | v1.13.0 | Base path moved to /v1/gateway; /v1/conductor continues to work but is deprecated. Added PATCH /orders/{id} to modify a CeFi order. |
| 2026-06-23 | Accounts REST | v1.9.1 | Published to the public docs site with only the deposit endpoints exposed; KYC, referral, organization, and Paxos operations marked internal. |
| 2026-06-18 | Trading REST | v1.12.0 | Breaking: GET /balances unified with GET /balances/unified and now returns the unified shape. Hyperliquid limit orders can rest on-chain by supplying a DeFi chain. |
| 2026-06-17 | Trading REST | v1.11.1 | GET /orders defaults to all venues (cefi,defi) instead of cefi. |
| 2026-06-15 | Trading REST | v1.11.0 | quote_asset is no longer required; DeFi resolves the quote asset per chain. |
| 2026-06-12 | Trading REST | v1.10.0 | Chain accepts hypercore-spot and hypercore-perp alongside solana and base. |
| 2026-06-10 | Trading REST | v1.9.0 | GET /orders accepts a venue filter. |
| 2026-06-01 | Accounts REST | v1.9.0 | Per-recipient referral rewards gained payment_status, distinguishing a queued reward from a paid one. |
| 2026-05-20 | FIX | v1.0.2 | Document TrdMatchID (880) on execution reports and update many fields to match implementation. |
| 2026-05-18 | Trading REST | v1.8.0 | Added GET /orders/{id} and order fee reporting. |
| 2026-05-12 | Market data REST | v0.7.1 | Published production and UAT base URLs. |
| 2026-05-11 | Accounts REST | v1.6.0 | Referral status gained payment_status (pending, queued, paid, failed, voided). reward_queued retained for back-compat. |
| 2026-05-11 | Market data REST | v0.7.0 | Added GET /v1/cefi/market/prices/history and /prices/range. CeFi history and range now report bid/ask midpoints from the latest EBBO snapshot rather than last-trade prices. |
| 2026-05-09 | Accounts REST | v1.5.1 | Spec marked internal; not published to the public docs site. |
| 2026-05-07 | Market data REST | v0.6.0 | Breaking: the WebSocket endpoint was removed from this document; it is described by the Market Data WebSocket AsyncAPI spec. |
| 2026-05-07 | Market data WebSocket | v0.0.1 | Initial release. |
| 2026-05-05 | CeFi direct REST | v1.0.5 | Add /v1/cefi/ path prefix. Deprecate /api/v1/ paths. |
| 2026-05-05 | Market data REST | v0.5.1 | Operations grouped under Prices and Market Cap. The health endpoint was removed from the public reference. |
| 2026-05-04 | Accounts REST | v1.5.0 | Added GET and POST /deposits/wire-instructions. Deprecated GET/POST /paxos/fiat-deposit-instructions; the POST can return 409. |
| 2026-05-01 | Trading REST | v1.7.3 | Expanded the order lifecycle documentation. |
| 2026-04-27 | Accounts REST | v1.4.0 | Added GET and POST /deposits/addresses for crypto deposit addresses, with cursor pagination. |
| 2026-04-27 | Authentication REST | v1.2.2 | First-party browser flows (passkey, magic link, one-time code, Sign in with Apple, JumpCloud SSO, credential management) marked internal. The public reference now covers the API-key token flow. |
| 2026-04-27 | Trading REST | v1.7.2 | Aligned the authentication documentation with the API-key JWT flow. |
| 2026-04-24 | Authentication REST | v1.2.1 | Published production and UAT base URLs and documented the API-key JWT flow end to end. |
| 2026-04-24 | Trading REST | v1.7.1 | Published the UAT base URL and documented credentials and quick start. |
| 2026-04-23 | Trading REST | v1.7.0 | Assets carry network details for CeFi venues. |
| 2026-04-21 | Trading REST | v1.6.0 | Added transfers: POST /transfers, POST /transfers/{id}/execute, GET /transfers, and GET /transfers/{id}. |
| 2026-04-13 | Trading REST | v1.5.1 | Operations grouped under Quotes, Orders, Assets, and Balances. |
| 2026-04-09 | CeFi direct WebSocket | v1.0.5 | Added SNAPSHOT_COMPLETE update type with item field — sent per-item after snapshot delivery. |
| 2026-04-07 | CeFi direct WebSocket | v1.0.4 | Add text field to order reports. |
| 2026-04-01 | Trading REST | v1.5.0 | Added GET /assets, the unified asset catalog across venues. |
| 2026-03-27 | Trading REST | v1.4.0 | Added GET /balances/unified. |
| 2026-03-19 | Trading REST | v1.3.0 | Added DELETE /orders/{id} to cancel an order, and a status filter on GET /orders returning both in-flight and settled orders. |
| 2026-03-17 | Trading REST | v1.2.0 | Added limit orders — order type accepts limit and requires price with qty_unit: base. |
| 2026-03-16 | Authentication REST | v1.2.0 | Added credential management: POST /api-key/register, POST /api-key/token, GET /api-key/, PUT/DELETE /api-key/{id}, and the matching /passkey/ endpoints. |
| 2026-03-12 | CeFi direct REST | v1.0.4 | Compute quote now works for both base and qoute bases. |
| 2026-03-04 | Accounts REST | v1.2.0 | Prove prefill accepts a flow type, supporting the desktop KYC flow. |
| 2026-02-26 | Trading REST | v1.1.0 | Added settled order history with cursor pagination. |
| 2026-02-23 | CeFi direct WebSocket | v1.0.3 | Added UNSUBSCRIBE_NO_AUTH and clarified no-auth request requirements on authenticated sessions. |
| 2026-02-10 | Accounts REST | v1.1.1 | Breaking: reward_distributed renamed to reward_queued on the referral status response. |
| 2026-02-10 | CeFi direct WebSocket | v1.0.2 | Clarified authentication/signature rules and subscription field requirements. |
| 2026-02-05 | Trading REST | v1.0.1 | Paths are now relative to the service base URL rather than repeating the prefix. |
| 2026-02-03 | Accounts REST | v1.0.0 | Initial release. KYC inquiries and status, Prove prefill, CDD, Paxos account setup, referrals, and onboarding reference data. |
| 2026-02-02 | Trading REST | v1.0.0 | Initial release. Quotes, order create/execute/list/status, and balances. |
| 2026-01-28 | CeFi direct WebSocket | v1.0.1 | Added DROPCOPY channel for order drop copy. |
| 2026-01-27 | CeFi direct REST | v1.0.3 | Pluralize all endpoints. Deprecate singular versions. |
| 2026-01-24 | CeFi direct REST | v1.0.2 | Add API versioning support and versions endpoint. |
| 2025-12-11 | Authentication REST | v1.0.0 | Initial release. Passkey registration and authentication, email magic link and one-time code, Sign in with Apple, JumpCloud SSO, token refresh, and JWKS. |
| 2025-12-11 | Market data REST | v0.0.1 | Initial release. Health, current prices, and historical prices. |
| 2025-11-05 | FIX | v1.0.1. | Add drop copy documentation. |
| 2025-10-24 | CeFi direct REST | v1.0.1 | Add gateway health endpoint. |
| 2025-10-16 | CeFi direct REST | v1.0.0 | Initial Release. |
| 2025-10-16 | CeFi direct WebSocket | v1.0.0 | Initial Release. |
| 2025-10-16 | FIX | v1.0.0 | Initial Release. |