Synthetix website screenshot

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.

Synthetix publishes 7 APIs on the APIs.io network, including escrowed-balance API, health-check API, staking API, and 4 more. Tagged areas include DeFi, Derivatives, Perpetuals, Synthetic Assets, and Liquidity Protocol.

The Synthetix catalog on APIs.io includes 1 Spectral governance ruleset.

Synthetix’s developer surface includes documentation and 14 more developer resources.

🌐 Visit website 📡 Source on GitHub
38.4/100 thin ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessOpen
11 APIs
DeFiDerivativesPerpetualsSynthetic AssetsLiquidity ProtocolBlockchainEthereumOptimismBaseTrading

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 38.4/100 · thin
Contract Quality 12.6 / 25
Developer Ergonomics 1.7 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 7.0 / 12
Discoverability 7.6 / 10
Agent readiness — 28/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/synthetix: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 11

Individual APIs this provider publishes, each with its own machine-readable definition.

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...

Synthetix escrowed-balance API

The escrowed-balance API from Synthetix — 4 operation(s) for escrowed-balance.

Synthetix health-check API

The health-check API from Synthetix — 2 operation(s) for health-check.

Synthetix staking API

The staking API from Synthetix — 2 operation(s) for staking.

Synthetix stats API

The stats API from Synthetix — 1 operation(s) for stats.

Synthetix supply API

The supply API from Synthetix — 2 operation(s) for supply.

Synthetix v3 API

The v3 API from Synthetix — 19 operation(s) for v3.

Synthetix vested-balance API

The vested-balance API from Synthetix — 1 operation(s) for vested-balance.

Scroll for all 11

GraphQL 1

GraphQL schemas published by this provider.

Synthetix GraphQL API

Synthetix exposes GraphQL APIs via The Graph protocol, providing indexed blockchain data for the Synthetix V3 derivatives liquidity protocol. Subgraphs are available for the cor...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Plans

9 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Rate Limits

11 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Finops

FINOPS

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Synthetix API Rules

5 rules · 3 warnings 2 info

SPECTRAL

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

Synthetix API Schemas

0 properties

JSON SCHEMA

Examples 1

Example request and response payloads for these APIs.

Examples

29 fields

EXAMPLE

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Synthetix Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Synthetix Agentic Access

31 operations

31 operations · 0 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

PortalDocumentation
PortalDocumentation

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 X-authentication-docs
X-authentication-docs

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

X-error-handling
X-error-handling

Build 3

SDKs, sample code, and the tooling you integrate with

GitHubOrg
GitHubOrg
 X-python-sdk
X-python-sdk
 X-github
X-github

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity

Operate 2

Status, limits, changes, and where to get help

RateLimits
RateLimits
 X-discord
X-discord

Commercial 2

Pricing, plans, and the legal terms of use

Plans
Plans
 FinOps
FinOps

Company 1

The organization behind the API

X-twitter
X-twitter

Other 1

Properties that don't map to a standard resource type

X-deposit-contract
X-deposit-contract

Source (apis.yml)

apis.yml Raw ↑ 
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.

  '
accessModel:
  pricing: unknown
  onboarding: open
  trial: false
  try_now: false
  public: true
  label: Open access
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
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
  - url: graphql/synthetix-graphql.md
    type: GraphQL
  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/
- aid: synthetix:synthetix-escrowed-balance-api
  name: Synthetix escrowed-balance API
  description: The escrowed-balance API from Synthetix — 4 operation(s) for escrowed-balance.
  humanURL: https://developers.synthetix.io/rest-api/info/market-data
  baseURL: https://papi.synthetix.io/v1/info
  tags:
  - escrowed-balance
  properties:
  - type: OpenAPI
    url: openapi/synthetix-escrowed-balance-api-openapi.yml
- aid: synthetix:synthetix-health-check-api
  name: Synthetix health-check API
  description: The health-check API from Synthetix — 2 operation(s) for health-check.
  humanURL: https://developers.synthetix.io/rest-api/info/market-data
  baseURL: https://papi.synthetix.io/v1/info
  tags:
  - health-check
  properties:
  - type: OpenAPI
    url: openapi/synthetix-health-check-api-openapi.yml
- aid: synthetix:synthetix-staking-api
  name: Synthetix staking API
  description: The staking API from Synthetix — 2 operation(s) for staking.
  humanURL: https://developers.synthetix.io/rest-api/info/market-data
  baseURL: https://papi.synthetix.io/v1/info
  tags:
  - staking
  properties:
  - type: OpenAPI
    url: openapi/synthetix-staking-api-openapi.yml
- aid: synthetix:synthetix-stats-api
  name: Synthetix stats API
  description: The stats API from Synthetix — 1 operation(s) for stats.
  humanURL: https://developers.synthetix.io/rest-api/info/market-data
  baseURL: https://papi.synthetix.io/v1/info
  tags:
  - stats
  properties:
  - type: OpenAPI
    url: openapi/synthetix-stats-api-openapi.yml
- aid: synthetix:synthetix-supply-api
  name: Synthetix supply API
  description: The supply API from Synthetix — 2 operation(s) for supply.
  humanURL: https://developers.synthetix.io/rest-api/info/market-data
  baseURL: https://papi.synthetix.io/v1/info
  tags:
  - supply
  properties:
  - type: OpenAPI
    url: openapi/synthetix-supply-api-openapi.yml
- aid: synthetix:synthetix-v3-api
  name: Synthetix v3 API
  description: The v3 API from Synthetix — 19 operation(s) for v3.
  humanURL: https://developers.synthetix.io/rest-api/info/market-data
  baseURL: https://papi.synthetix.io/v1/info
  tags:
  - v3
  properties:
  - type: OpenAPI
    url: openapi/synthetix-v3-api-openapi.yml
- aid: synthetix:synthetix-vested-balance-api
  name: Synthetix vested-balance API
  description: The vested-balance API from Synthetix — 1 operation(s) for vested-balance.
  humanURL: https://developers.synthetix.io/rest-api/info/market-data
  baseURL: https://papi.synthetix.io/v1/info
  tags:
  - vested-balance
  properties:
  - type: OpenAPI
    url: openapi/synthetix-vested-balance-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/synthetix-agentic-access.yml
- type: DomainSecurity
  url: security/synthetix-domain-security.yml
- 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