> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tide.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Recent Trades

> Get recent public trades for a symbol

Retrieve recent public trade executions for a specific trading pair. This endpoint provides historical trade data with exchange attribution.

## Features

* **Real-time trade data**: Recent trade executions across exchanges
* **Exchange filtering**: Filter trades by specific exchanges
* **Configurable limit**: Control the number of trades returned
* **Trade details**: Price, size, side, and timestamp for each trade

## Request

* **Method**: `GET`
* **Endpoint**: `/trades`
* **Query Parameters**: `symbol` (required), `limit`, `exchanges[]`

```bash theme={null}
curl -X GET "https://api.tide.ag/trades?symbol=BTC-USD&limit=50" \
  -H "Content-Type: application/json"
```

## Use Cases

* Display recent trade history in trading interfaces
* Analyze trading patterns and volume distribution
* Calculate volume-weighted average prices (VWAP)
* Monitor market activity and liquidity

<Note>
  For real-time trade updates, use the WebSocket `trades:{symbol}` topic for live trade streams.
</Note>


## OpenAPI

````yaml GET /trades
openapi: 3.1.0
info:
  title: Tide API
  description: >-
    Decentralized Perpetual Aggregator API for multi-exchange trading across
    Hyperliquid, Aster, Lighter, and Pacifica
  version: 1.0.0
  contact:
    name: Tide Support
    email: support@tide.ag
    url: https://tide.ag
  license:
    name: MIT
servers:
  - url: https://api.tide.ag
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Market Data
    description: Public market data endpoints
  - name: Trading
    description: Order placement and management
  - name: Positions
    description: Position management and history
  - name: Account
    description: Account and balance management
  - name: System
    description: System status and health
paths:
  /trades:
    get:
      tags:
        - Market Data
      summary: Get Recent Trades
      description: Get recent public trades for a symbol
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BTC-USD
          description: Trading pair symbol
        - name: exchanges[]
          in: query
          style: form
          explode: true
          schema:
            type: array
            items:
              $ref: '#/components/schemas/ExchangeName'
          description: Filter by exchanges
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            maximum: 500
            minimum: 1
          description: Number of trades to return
      responses:
        '200':
          description: Recent trades
          content:
            application/json:
              schema:
                type: object
                properties:
                  trades:
                    type: array
                    items:
                      $ref: '#/components/schemas/Trade'
      security: []
components:
  schemas:
    ExchangeName:
      type: string
      enum:
        - hyperliquid
        - aster
        - lighter
        - pacifica
    Trade:
      type: object
      properties:
        id:
          type: string
          description: Trade ID
        symbol:
          type: string
          example: BTC-USD
        exchange:
          $ref: '#/components/schemas/ExchangeName'
        price:
          type: string
          description: Trade price
        size:
          type: string
          description: Trade size
        side:
          $ref: '#/components/schemas/OrderSide'
        timestamp:
          type: integer
          description: Trade timestamp in milliseconds
    OrderSide:
      type: string
      enum:
        - BUY
        - SELL
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        API key for authentication. Also requires X-API-SECRET, X-API-TIMESTAMP,
        and X-API-SIGNATURE headers for private endpoints.

````