Trade Endpoints
All trade methods go through the below endpoints:
- REST:
POST https://papi.synthetix.io/v1/trade
Authentication
All trade methods are signed using EIP-712. Each successful trade request will contain:
- A piece of structured data that includes the sender address
- A signature of the hash of that structured data, signed by the sender
Subaccounts
Subaccounts must also follow the signing process defined above. Subaccount delegate private keys are assigned signing authority from the master account.
Expires After
Some trade actions support an optional field expiresAfter which is a timestamp in milliseconds after which the action will be rejected.
Available Methods
Order Management
| Method | Type | Description | Purpose |
|---|---|---|---|
| Cancel Orders | order | Cancels one or more existing orders | Remove one or more orders from the orderbook |
| Modify Order | order | Modifies a single existing order's parameters | Update individual order price, size, or other parameters without canceling and replacing |
| Place Orders | order | Places one or more orders (market, limit, or conditional) on the orderbook | Execute single or multiple buy/sell orders for perpetual contracts and spot trading with efficient batch operations |
Account Management
| Method | Type | Description | Purpose |
|---|---|---|---|
| Create Subaccount | account | Creates a new trading subaccount | Organize trading strategies with isolated accounts and margin management |
| Update Leverage | account | Adjusts leverage for trading positions | Modify risk exposure by changing position leverage |
Delegation Management
| Method | Type | Description | Purpose |
|---|---|---|---|
| Add Delegated Signer | delegation | Adds a delegated signer to a subaccount | Grant trading permissions to bots, team members, or automated systems |
| Get Delegated Signers | delegation | Retrieves all delegated signers for a subaccount | View current access permissions and audit delegated authority |
| Remove Delegated Signer | delegation | Removes a delegated signer from a subaccount | Revoke access permissions immediately for security or team changes |
Account Queries
| Method | Type | Description | Purpose |
|---|---|---|---|
| Get Balance Updates | query | Retrieves deposit and withdrawal history | View historical balance changes from deposits and withdrawals |
| Get Funding Payments | query | Retrieves funding payment history and statistics | Monitor funding payments received/paid and analyze funding rate impact |
| Get Open Orders | query | Retrieves currently open orders for subaccount | Monitor active orders in the orderbook |
| Get Orders | query | Retrieves orders with flexible filtering (open, closed, cancelled) | Monitor all orders with comprehensive status filtering and pagination |
| Get Positions | query | Retrieves current and historical trading positions | Monitor active positions, profit/loss, risk metrics, and position history |
| Get Performance History | query | Retrieves historical account value, PnL, and volume for a period | Analyze performance trends for charting and reporting |
| Get Subaccount | query | Retrieves information and balances for a specific subaccount | View account structure, margin status, and available balances for a single subaccount |
| Get Trades | query | Retrieves trade execution history (fills) | View historical trade executions, analyze trading performance, and reconcile positions |