> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "Get market trades"
description: "Get recent trades for a market"
api: "GET /api/v1/markets/{id}/trades"
gridGap: 30
---

<Aside full>
  <RequestExample>
    ```bash title="cURL" lines=false
    curl -X GET "https://api.adjacent.markets/api/v1/markets/<id>/trades" \
      -H "Authorization: Bearer <token>"
    ```
  </RequestExample>
</Aside>

<OpenAPIEndpoint {...{"method":"get","path":"/api/v1/markets/{id}/trades","summary":"Get market trades","description":"Get recent trades for a market","parameters":[{"name":"id","in":"path","required":true,"description":"Market ID","schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number","schema":{"type":"integer","default":1,"minimum":1}},{"name":"per_page","in":"query","description":"Items per page","schema":{"type":"integer","default":100,"minimum":1,"maximum":500}},{"name":"from","in":"query","description":"Inclusive lower bound on trade created_time","schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","description":"Exclusive upper bound on trade created_time","schema":{"type":"string","format":"date-time"}}],"responses":[{"status":"200","description":"Paginated trades","schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"trade_id":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"price":{"type":"number"},"count":{"type":"integer"},"side":{"type":"string"},"volume":{"type":["number","null"]}}}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"total_pages":{"type":"integer"},"has_next":{"type":"boolean"},"has_prev":{"type":"boolean"}}}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Clerk JWT Bearer token"}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} />