Synthetix Trade API

Authenticated REST API for trading operations and account management on the Synthetix perpetuals exchange. Supports order placement, cancellation, position management, collateral operations, subaccount management, delegation, referrals, and performance analytics. Requires EIP-712 cryptographic signatures for authentication.

API entry from apis.yml

apis.yml Raw ↑
name: Synthetix Trade API
description: 'Authenticated REST API for trading operations and account management on the Synthetix perpetuals
  exchange. Supports order placement, cancellation, position management, collateral operations, subaccount
  management, delegation, referrals, and performance analytics. Requires EIP-712 cryptographic signatures
  for authentication.

  '
humanURL: https://developers.synthetix.io/rest-api/trade
baseURL: https://papi.synthetix.io/v1/trade
tags:
- Trading
- Authenticated
- Orders
- Positions
- Accounts
- Collateral
properties:
- type: Documentation
  url: https://developers.synthetix.io/rest-api/trade
- type: X-authentication
  url: https://developers.synthetix.io/developer-resources/api/authentication
- type: X-rate-limits
  url: https://developers.synthetix.io/developer-resources/api/rate-limits
contact:
- FN: Synthetix Developer Docs
  url: https://developers.synthetix.io/
operations:
- label: Place Orders
  method: POST
  path: /v1/trade
  action: placeOrders
  tags:
  - Orders
- label: Modify Order
  method: POST
  path: /v1/trade
  action: modifyOrder
  tags:
  - Orders
- label: Cancel Orders
  method: POST
  path: /v1/trade
  action: cancelOrders
  tags:
  - Orders
- label: Cancel All Orders
  method: POST
  path: /v1/trade
  action: cancelAllOrders
  tags:
  - Orders
- label: Schedule Cancel
  method: POST
  path: /v1/trade
  action: scheduleCancel
  tags:
  - Orders
- label: Get Positions
  method: POST
  path: /v1/trade
  action: getPositions
  tags:
  - Positions
- label: Get Open Orders
  method: POST
  path: /v1/trade
  action: getOpenOrders
  tags:
  - Orders
- label: Get Order History
  method: POST
  path: /v1/trade
  action: getOrderHistory
  tags:
  - Orders
  - Historical
- label: Get Trades
  method: POST
  path: /v1/trade
  action: getTrades
  tags:
  - Trades
  - Historical
- label: Get Position History
  method: POST
  path: /v1/trade
  action: getPositionHistory
  tags:
  - Positions
  - Historical
- label: Get Funding Payments
  method: POST
  path: /v1/trade
  action: getFundingPayments
  tags:
  - Funding
- label: Withdraw Collateral
  method: POST
  path: /v1/trade
  action: withdraw
  tags:
  - Collateral
- label: Transfer Collateral
  method: POST
  path: /v1/trade
  action: transfer
  tags:
  - Collateral
- label: Get Balance Updates
  method: POST
  path: /v1/trade
  action: getBalanceUpdates
  tags:
  - Collateral
  - Balance
- label: Get Transfers
  method: POST
  path: /v1/trade
  action: getTransfers
  tags:
  - Collateral
- label: Get Withdrawable Amounts
  method: POST
  path: /v1/trade
  action: getWithdrawableAmounts
  tags:
  - Collateral
- label: Create Subaccount
  method: POST
  path: /v1/trade
  action: createSubaccount
  tags:
  - Accounts
- label: Get SubAccount
  method: POST
  path: /v1/trade
  action: getSubAccount
  tags:
  - Accounts
- label: Get SubAccounts
  method: POST
  path: /v1/trade
  action: getSubAccounts
  tags:
  - Accounts
- label: Get SubAccount IDs
  method: POST
  path: /v1/trade
  action: getSubAccountIds
  tags:
  - Accounts
- label: Get Delegated Signers
  method: POST
  path: /v1/trade
  action: getDelegatedSigners
  tags:
  - Delegation
- label: Add Delegated Signer
  method: POST
  path: /v1/trade
  action: addDelegatedSigner
  tags:
  - Delegation
- label: Remove Delegated Signer
  method: POST
  path: /v1/trade
  action: removeDelegatedSigner
  tags:
  - Delegation
- label: Remove All Delegated Signers
  method: POST
  path: /v1/trade
  action: removeAllDelegatedSigners
  tags:
  - Delegation
- label: Get Rate Limits
  method: POST
  path: /v1/trade
  action: getRateLimits
  tags:
  - Rate Limits
- label: Get Performance History
  method: POST
  path: /v1/trade
  action: getPerformanceHistory
  tags:
  - Analytics
  - PnL
- label: Get Snaxpot Epoch Tickets
  method: POST
  path: /v1/trade
  action: getSnaxpotEpochTickets
  tags:
  - Lottery
  - Snaxpot