Synthetix

Synthetix is a derivatives liquidity protocol built on Ethereum and EVM-compatible L2 networks (Optimism, Base). It provides perpetual futures trading with deep onchain liquidity, supporting a wide range of synthetic assets. The platform exposes REST and WebSocket APIs for querying collateral, managing positions, accessing funding rates, monitoring liquidations, tracking staking rewards, and interacting with V3 markets across Optimism and Base.

4 APIs 0 Features

DeFiDerivativesPerpetualsSynthetic AssetsLiquidity ProtocolBlockchainEthereumOptimismBaseTrading

APIs

Synthetix Info API

Public REST API for accessing Synthetix market data including markets, prices, candles, funding rates, collateral configurations, contract specs, orderbook depth, exchange statu...

Synthetix Trade API

Authenticated REST API for trading operations and account management on the Synthetix perpetuals exchange. Supports order placement, cancellation, position management, collatera...

Synthetix WebSocket Info API

Public WebSocket API for real-time Synthetix market data subscriptions including live market prices, candles, and orderbook depth updates. No authentication required. Supports h...

Synthetix WebSocket Trade API

Authenticated WebSocket API for real-time trading operations and account event streaming on Synthetix. Supports live order management, position updates, account activity subscri...

Resources

PortalDocumentation

X-deposit-contract

X-deposit-contract

🔑

X-authentication-docs

X-authentication-docs

🔗

X-error-handling

X-error-handling

Sources

name: Synthetix
description: >
  Synthetix is a derivatives liquidity protocol built on Ethereum and EVM-compatible
  L2 networks (Optimism, Base). It provides perpetual futures trading with deep
  onchain liquidity, supporting a wide range of synthetic assets. The platform
  exposes REST and WebSocket APIs for querying collateral, managing positions,
  accessing funding rates, monitoring liquidations, tracking staking rewards, and
  interacting with V3 markets across Optimism and Base.
image: https://synthetix.io/favicon.ico
tags:
  - DeFi
  - Derivatives
  - Perpetuals
  - Synthetic Assets
  - Liquidity Protocol
  - Blockchain
  - Ethereum
  - Optimism
  - Base
  - Trading
url: https://synthetix.io/
baseURL: https://papi.synthetix.io
humanURL: https://synthetix.io/
contact:
  - FN: Synthetix Developer Support
    url: https://discord.gg/synthetix
    X-twitter: synthetix_io
specificationVersion: "0.19"
modified: "2026-06-14"
apis:
  - name: Synthetix Info API
    description: >
      Public REST API for accessing Synthetix market data including markets,
      prices, candles, funding rates, collateral configurations, contract specs,
      orderbook depth, exchange status, and fee tier information. No authentication
      required.
    humanURL: https://developers.synthetix.io/rest-api/info/market-data
    baseURL: https://papi.synthetix.io/v1/info
    tags:
      - Market Data
      - Public
      - Prices
      - Funding Rates
      - Collateral
      - Orderbook
    properties:
      - type: X-openapi
        url: https://api.synthetix.io/docs/
      - type: Documentation
        url: https://developers.synthetix.io/rest-api/info/market-data
      - type: X-environments
        url: https://developers.synthetix.io/environments
    contact:
      - FN: Synthetix Developer Docs
        url: https://developers.synthetix.io/
    operations:
      - label: Get Markets
        method: POST
        path: /v1/info
        action: getMarkets
        tags:
          - Markets
      - label: Get Market Prices
        method: POST
        path: /v1/info
        action: getMarketPrices
        tags:
          - Prices
      - label: Get Candles
        method: POST
        path: /v1/info
        action: getCandles
        tags:
          - OHLCV
          - Historical
      - label: Get Funding Rate History
        method: POST
        path: /v1/info
        action: getFundingRateHistory
        tags:
          - Funding Rates
          - Historical
      - label: Get Assets
        method: POST
        path: /v1/info
        action: getAssets
        tags:
          - Assets
      - label: Get Collaterals
        method: POST
        path: /v1/info
        action: getCollaterals
        tags:
          - Collateral
      - label: Get Tiers
        method: POST
        path: /v1/info
        action: getTiers
        tags:
          - Fees
          - Tiers
      - label: Get Contracts
        method: POST
        path: /v1/info
        action: getContracts
        tags:
          - Contracts
          - Perpetuals
      - label: Get Contract Specs
        method: POST
        path: /v1/info
        action: getContractSpecs
        tags:
          - Contracts
      - label: Get Orderbook
        method: POST
        path: /v1/info
        action: getOrderbook
        tags:
          - Orderbook
          - Depth
      - label: Get Exchange Status
        method: POST
        path: /v1/info
        action: getExchangeStatus
        tags:
          - Status
      - label: Get Snaxpot Epoch
        method: POST
        path: /v1/info
        action: getSnaxpotEpoch
        tags:
          - Lottery
          - Snaxpot

  - 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

  - name: Synthetix WebSocket Info API
    description: >
      Public WebSocket API for real-time Synthetix market data subscriptions
      including live market prices, candles, and orderbook depth updates. No
      authentication required. Supports heartbeat management for connection stability.
    humanURL: https://developers.synthetix.io/websocket-api/info
    baseURL: wss://papi.synthetix.io/v1/ws/info
    tags:
      - WebSocket
      - Real-time
      - Market Data
      - Public
      - Streaming
    properties:
      - type: Documentation
        url: https://developers.synthetix.io/websocket-api/info
    contact:
      - FN: Synthetix Developer Docs
        url: https://developers.synthetix.io/

  - name: Synthetix WebSocket Trade API
    description: >
      Authenticated WebSocket API for real-time trading operations and account
      event streaming on Synthetix. Supports live order management, position
      updates, account activity subscriptions, and delegation management.
      Requires EIP-712 authentication.
    humanURL: https://developers.synthetix.io/websocket-api/trade
    baseURL: wss://papi.synthetix.io/v1/ws/trade
    tags:
      - WebSocket
      - Real-time
      - Trading
      - Authenticated
      - Streaming
    properties:
      - type: Documentation
        url: https://developers.synthetix.io/websocket-api/trade
      - type: X-authentication
        url: https://developers.synthetix.io/developer-resources/api/authentication
    contact:
      - FN: Synthetix Developer Docs
        url: https://developers.synthetix.io/

common:
  - type: Documentation
    url: https://developers.synthetix.io/
  - type: PortalDocumentation
    url: https://docs.synthetix.io/
  - type: GithubOrg
    url: https://github.com/Synthetixio
  - type: X-python-sdk
    url: https://synthetixio.github.io/python-sdk/
  - type: Plans
    url: https://synthetix.io/plans.html
  - type: FinOps
    url: https://synthetix.io/finops.html
  - type: RateLimits
    url: https://developers.synthetix.io/developer-resources/api/rate-limits
  - type: X-discord
    url: https://discord.gg/synthetix
  - type: X-twitter
    url: https://twitter.com/synthetix_io
  - type: X-github
    url: https://github.com/Synthetixio/synthetix-v3
  - type: X-deposit-contract
    url: https://etherscan.io/address/0xD62595c3c23B690BAEE0935e107A209Cb1Dbd37B
  - type: X-authentication-docs
    url: https://developers.synthetix.io/developer-resources/api/authentication
  - type: X-error-handling
    url: https://developers.synthetix.io/developer-resources/api/error-handling