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

# List Market Trades

> List recent trades for a trading pair

## Overview

Get a list of recent trades executed on a specific market. This is public market data and does not require authentication. Unlike the [List Trades](/pro/api-reference/list-trades) endpoint, this returns anonymous market-wide trades rather than your personal trade history.

## Path Parameters

<ParamField path="symbol" type="string" required>
  Trading pair symbol

  **Example:** `USDT-NGN`

  **Allowed values:** `USDT-NGN`, `USDC-NGN`, `USD-NGN`
</ParamField>

## Query Parameters

<ParamField query="limit" type="integer">
  Maximum number of trades to return

  **Default:** `50`

  **Range:** `1` to `100`
</ParamField>

## Request Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.pro.daya.co/public/v1/market-trades/USDT-NGN?limit=20'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.pro.daya.co/public/v1/market-trades/USDT-NGN?limit=20'
  );
  const data = await response.json();
  console.log('Recent trades:', data.data);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.pro.daya.co/public/v1/market-trades/USDT-NGN',
      params={'limit': 20}
  )
  data = response.json()
  print(f"Recent trades: {data['data']}")
  ```

  ```go Go theme={null}
  package main

  import (
      "encoding/json"
      "fmt"
      "net/http"
  )

  func main() {
      resp, err := http.Get("https://api.pro.daya.co/public/v1/market-trades/USDT-NGN?limit=20")
      if err != nil {
          panic(err)
      }
      defer resp.Body.Close()

      var result map[string]interface{}
      json.NewDecoder(resp.Body).Decode(&result)
      fmt.Println("Recent trades:", result["data"])
  }
  ```
</CodeGroup>

## Response

<ResponseField name="success" type="boolean" required>
  Indicates if the request was successful
</ResponseField>

<ResponseField name="message" type="string" required>
  Human-readable response message
</ResponseField>

<ResponseField name="data" type="array" required>
  Array of market trade objects

  <Expandable title="trade properties">
    <ResponseField name="id" type="string">
      Unique trade identifier (UUID)
    </ResponseField>

    <ResponseField name="symbol" type="string">
      Trading pair symbol

      **Example:** `USD-NGN`
    </ResponseField>

    <ResponseField name="price" type="string">
      Execution price

      **Example:** `1545.50`
    </ResponseField>

    <ResponseField name="quantity" type="string">
      Trade quantity in base asset

      **Example:** `100.00`
    </ResponseField>

    <ResponseField name="side" type="string">
      Taker side of the trade

      **Values:** `buy`, `sell`
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 trade execution timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

### Success Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true,
    "message": "Market trades retrieved successfully",
    "data": [
      {
        "id": "660e8400-e29b-41d4-a716-446655440000",
        "symbol": "USD-NGN",
        "price": "1545.50",
        "quantity": "100.00",
        "side": "buy",
        "created_at": "2024-01-15T10:35:01Z"
      },
      {
        "id": "660e8400-e29b-41d4-a716-446655440001",
        "symbol": "USD-NGN",
        "price": "1545.00",
        "quantity": "50.00",
        "side": "sell",
        "created_at": "2024-01-15T10:34:55Z"
      }
    ]
  }
  ```
</ResponseExample>

## Error Responses

<ResponseExample>
  ```json 404 Not Found theme={null}
  {
    "success": false,
    "message": "Market not found",
    "error": {
      "code": "SYMBOL_NOT_FOUND",
      "message": "Market not found"
    }
  }
  ```
</ResponseExample>

## Notes

* Trades are returned in reverse chronological order (most recent first).
* The `side` field indicates the taker side of the trade (the order that triggered the match).
* This endpoint returns anonymous market data. For your personal trade history with fee details, use the authenticated [List Trades](/pro/api-reference/list-trades) endpoint.

## Rate Limits

* **100 requests per minute** per IP address
* No authentication required

## Next Steps

<CardGroup cols={2}>
  <Card title="Get Last Price" icon="tag" href="/pro/api-reference/get-last-price">
    Get the latest price for a market
  </Card>

  <Card title="Get Orderbook" icon="book" href="/pro/api-reference/get-orderbook">
    View market depth for a trading pair
  </Card>
</CardGroup>