Get Last Trades

Retrieve the most recent trade execution history (fills) from Synthetix's orderbook across all users. Each trade represents a filled order or partial fill that has been executed. This endpoint provides public market data without requiring authentication.

Endpoint

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

Request

Request Format

{
  "params": {
    "action": "getLastTrades",
    "symbol": "BTC-USDT",
    "limit": 100
  }
}

Request Parameters

Parameter	Type	Required	Description
`params.action`	string	Yes	Must be `"getLastTrades"`
`params.symbol`	string	Yes	Trading pair symbol (e.g., `"BTC-USDT"`). Normalized to uppercase; maximum 20 characters.
`params.limit`	integer	No	Maximum number of trades to return (default: 50, min: 1, max: 100)

No Authentication Required

This is a public endpoint that does not require authentication.

Response

Success Response

{
  "status": "ok",
  "response": {
    "trades": [
      {
        "tradeId": "123456789",
        "symbol": "BTC-USDT",
        "side": "buy",
        "price": "50000.50",
        "quantity": "0.1",
        "timestamp": 1704067200500,
        "isMaker": false
      },
      {
        "tradeId": "123456788",
        "symbol": "BTC-USDT",
        "side": "sell",
        "price": "50000.25",
        "quantity": "0.05",
        "timestamp": 1704067199800,
        "isMaker": true
      }
    ]
  },
  "request_id": "5ccf215d37e3ae6d"
}

Trade Object (Public)

Field	Type	Description
`tradeId`	string	Unique identifier for the trade
`symbol`	string	Market symbol (e.g., `"BTC-USDT"`)
`side`	string	Order side: `"buy"` or `"sell"`
`price`	string	Execution price as string
`quantity`	string	Executed quantity as string
`timestamp`	integer	Execution time in milliseconds since epoch
`isMaker`	boolean	Whether this was a maker order (added liquidity)

Error Response

{
  "status": "error",
  "error": {
    "message": "Invalid symbol",
    "code": "VALIDATION_ERROR"
  },
  "request_id": "5ccf215d37e3ae6d"
}

Examples

Get Recent Trades with Default Limit

{
  "params": {
    "action": "getLastTrades",
    "symbol": "BTC-USDT"
  }
}

Filter by Symbol

{
  "params": {
    "action": "getLastTrades",
    "symbol": "ETH-USDT",
    "limit": 100
  }
}

Maximum Results

{
  "params": {
    "action": "getLastTrades",
    "symbol": "BTC-USDT",
    "limit": 100
  }
}

Response Fields

Response Structure

Field	Type	Description
`trades`	array	Array of public trade objects

Sorting

Trades are returned in descending order by timestamp (newest first).

Implementation Notes

Public Data: This endpoint provides public market data suitable for price discovery, trading interfaces, market data feeds, and public trade history displays
Symbol Required: A valid market symbol must be provided
Limit Usage: Default limit is 50 trades, minimum 1, maximum 100 trades per request
Caching: Trade data is immutable once created, suitable for short-term caching
Real-time Updates: Use Trade Updates WebSocket subscription for live data with sub-50ms latency. Use REST for initial load, WebSocket for ongoing updates

Use Cases

Market Analysis

Recent price discovery and trade flow analysis
Volume and liquidity assessment
Market depth analysis when combined with orderbook data

Trading Interfaces

Displaying recent market activity
Trade history components
Price movement indicators

Data Feeds

Building market data aggregators
Feeding external analytics systems
Creating public market displays

Differences from getTrades

Feature	getLastTrades (Public)	getTrades (Private)
Authentication	Not required	Required (EIP-712 signature)
Data Scope	All users	Specific subaccount only
Sensitive Data	Excluded	Included (fees, PnL, order IDs)
Symbol Parameter	Required	Optional
Pagination	Limit only	Limit + offset
Time Filtering	Not supported	Start/end time supported
Rate Limits	More permissive	Standard authenticated limits
Maximum Limit	100 trades	1000 trades

Error Handling

Common Errors

Error	Description	Solution
`symbol is required`	Symbol parameter is missing or empty	Provide a valid market symbol
`invalid symbol`	Market symbol format is not recognized	Use uppercase format, e.g. `"BTC-USDT"`
`symbol exceeds maximum length of 20 characters`	Symbol exceeds 20-character limit	Shorten or correct the symbol value
`Limit cannot exceed 100`	Limit exceeds maximum	Use limit ≤ 100
`Limit must be at least 1`	Limit is less than 1	Use limit ≥ 1
`Market not found`	Specified symbol doesn't exist	Verify symbol format and availability
`500 Internal Server Error`	Trade history contains an unrecognized `direction` value (e.g. `"unknown"`, `""`, or any unexpected string)	Indicates corrupted trade direction data on the backend that requires operator investigation. Previously these cases were silently defaulted to `side: "buy"` in the response.

Rate Limiting

:::info Rate Limits The Synthetix API enforces rate limits to ensure fair usage and system stability:

Order Placement: 100 orders per second per subaccount
WebSocket Connections: 100 connections per IP address
WebSocket Subscriptions: 1000 subscriptions per IP address

See Rate Limits for detailed information and best practices. :::

Public endpoints typically have higher rate limits
Each request counts as 1 against rate limits
No authentication overhead improves response times
See Rate Limits for details

Next Steps

Get Last Trades (WebSocket) - WebSocket version for lower latency
Get Markets - Available trading markets
Get Market Prices - Current market prices
Get Trades - Your account's trade history
Trade Updates - Real-time trade stream
WebSocket Info - Real-time public market data