Get Markets

Retrieve comprehensive market configuration information for all available trading pairs.

Endpoint

POST https://papi.synthetix.io/v1/info

Request

Request Format

{
  "params": {
    "action": "getMarkets"
  }
}

Request Parameters

Parameter	Type	Required	Description
`params.action`	string	Yes	Must be `"getMarkets"`

Response

Success Response

{
  "status": "ok",
  "response": [
    {
      "symbol": "SOL-USDT",
      "description": "Solana",
      "baseAsset": "SOL",
      "quoteAsset": "USDT",
      "isOpen": true,
      "isCloseOnly": false,
      "priceExponent": 2,
      "quantityExponent": 2,
      "priceIncrement": "0.01",
      "minOrderSize": "0.01",
      "orderSizeIncrement": "0.01",
      "largePositionPenalty": "0.001",
      "contractSize": 1,
      "maxMarketOrderSize": "1000000",
      "maxLimitOrderSize": "1000000",
      "minOrderPrice": "0.01",
      "limitOrderPriceCapRatio": "1.5",
      "limitOrderPriceFloorRatio": "0.5",
      "marketOrderPriceCapRatio": "1.1",
      "marketOrderPriceFloorRatio": "0.9",
      "liquidationClearanceFee": "0.002",
      "minNotionalValue": "10",
      "maintenanceMarginTiers": [
        {
          "minPositionSize": "0",
          "maxPositionSize": "500000",
          "maxLeverage": 100,
          "initialMarginRequirement": "0.01",
          "maintenanceMarginRequirement": "0.005"
        },
        {
          "minPositionSize": "500001",
          "maxPositionSize": "10000000",
          "maxLeverage": 50,
          "initialMarginRequirement": "0.02",
          "maintenanceMarginRequirement": "0.01"
        },
        {
          "minPositionSize": "10000001",
          "maxPositionSize": "50000000",
          "maxLeverage": 25,
          "initialMarginRequirement": "0.04",
          "maintenanceMarginRequirement": "0.02"
        },
        {
          "minPositionSize": "50000001",
          "maxPositionSize": "200000000",
          "maxLeverage": 10,
          "initialMarginRequirement": "0.1",
          "maintenanceMarginRequirement": "0.05"
        },
        {
          "minPositionSize": "200000001",
          "maxPositionSize": null,
          "maxLeverage": 2,
          "initialMarginRequirement": "0.5",
          "maintenanceMarginRequirement": "0.25"
        }
      ]
    }
  ],
  "request_id": "5ccf215d37e3ae6d"
}

Market Object

Field	Type	Description
`symbol`	string	Trading pair symbol (e.g., "SOL-USDT")
`description`	string	Market description (e.g., "Solana")
`baseAsset`	string	Base asset ticker (e.g., "SOL")
`quoteAsset`	string	Quote asset ticker (e.g., "USDT")
`isOpen`	boolean	Whether the market is open for trading
`isCloseOnly`	boolean	Whether the market is in close-only mode
`priceExponent`	integer	Number of decimal places for price
`quantityExponent`	integer	Number of decimal places for quantity
`priceIncrement`	string	Minimum price increment (tick size)
`minOrderSize`	string	Minimum order size
`orderSizeIncrement`	string	Order size increment
`largePositionPenalty`	string	Penalty for large positions
`contractSize`	integer	Contract size for the market
`maxMarketOrderSize`	string	Maximum market order size
`maxLimitOrderSize`	string	Maximum limit order size
`minOrderPrice`	string	Minimum order price
`limitOrderPriceCapRatio`	string	Price cap ratio for limit orders
`limitOrderPriceFloorRatio`	string	Price floor ratio for limit orders
`marketOrderPriceCapRatio`	string	Price cap ratio for market orders
`marketOrderPriceFloorRatio`	string	Price floor ratio for market orders
`liquidationClearanceFee`	string	Liquidation clearance fee
`minNotionalValue`	string	Minimum notional value for orders
`maintenanceMarginTiers`	array	Array of maintenance margin tiers

Margin Tiers Object

Margin tiers define the maximum leverage and margin requirements based on position size (notional value in USD). As position size increases, maximum leverage decreases and margin requirements increase to manage risk.

Field	Type	Description
`minPositionSize`	string	Minimum notional position size (USD) for this tier
`maxPositionSize`	string / null	Maximum notional position size (USD) for this tier (null = unlimited)
`maxLeverage`	number	Maximum leverage allowed for positions in this tier
`initialMarginRequirement`	string	Initial margin requirement as decimal (e.g., "0.01" = 1%)
`maintenanceMarginRequirement`	string	Maintenance margin requirement as decimal (e.g., "0.005" = 0.5%)

Margin Calculations:

Initial margin requirement = 1 / max_leverage
Maintenance margin requirement = 1 / (2 × max_leverage)

Example: For SOL-USDT with the tiers shown above:

Position size $0 - $500,000: Up to 100x leverage, 1% initial margin, 0.5% maintenance margin
Position size $500,001 - $10,000,000: Up to 50x leverage, 2% initial margin, 1% maintenance margin
Position size $10,000,001 - $50,000,000: Up to 25x leverage, 4% initial margin, 2% maintenance margin
Position size $50,000,001 - $200,000,000: Up to 10x leverage, 10% initial margin, 5% maintenance margin
Position size > $200,000,001: Up to 2x leverage, 50% initial margin, 25% maintenance margin

Error Response

{
  "status": "error",
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Could not pull market configuration",
    "details": {}
  },
  "request_id": "5ccf215d37e3ae6d",
  "timestamp": "2025-01-01T00:00:00Z"
}

Code Examples

Get All Markets

{
  "params": {
    "action": "getMarkets"
  }
}

Market Information

Comprehensive Data: Includes all market configuration, trading rules, and limits
Real-time Updates: Market status and configuration are updated in real-time
Trading Rules: All necessary information for placing compliant orders
Margin Requirements: Complete margin tier information for risk management
Price Precision: Exact decimal precision for prices and quantities

Use Cases

Trading Applications: Get market specifications for order validation
Risk Management: Access margin requirements and position limits
Market Analysis: Understand trading rules and market structure
Order Management: Validate order parameters before submission
System Integration: Configure trading systems with market rules

Validation Rules

No authentication required
No rate limiting beyond standard API limits
Returns data for all available markets

Error Handling

Common error scenarios:

Error	Description
Invalid signature	EIP-712 signature validation failed
Invalid market symbol	Market symbol not recognized
Nonce already used	Nonce must be greater than previous value
Rate limit exceeded	Too many requests in time window
Request expired	`expiresAfter` timestamp has passed

Error	Description
Market configuration unavailable	Failed to retrieve market data from configuration service
Internal error	Service temporarily unavailable

Related Endpoints

Get Market Prices - Current market prices
Get Orderbook - Order book depth