Changelog
Back to All
Added

Position endpoints now available in sandbox and production

November 2nd, 2026 by ReadMe API

Availability: Sandbox since October 26, 2026 · Production: not yet released

You can now list a user's open positions and close them through the /private/v1 API, in both sandbox and production. All four endpoints require the market-order permission.

  • GET /private/v1/positions lists the caller's net positions, with open exposure netted down to one entry per market.
  • POST /private/v1/positions/quote returns a preview of what closing (selling) some or all of an open position would do.
  • POST /private/v1/positions/close closes (sells) some or all of an open position at the current price.
  • GET /private/v1/positions/close/{refId} returns the current status of a close request.

See Market Orders for how these fit with the rest of the order flow.