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

---
title: "List markets"
description: "Get a paginated list of prediction markets with filtering options"
api: "GET /api/v1/markets"
gridGap: 30
---

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

<OpenAPIEndpoint {...{"method":"get","path":"/api/v1/markets","summary":"List markets","description":"Get a paginated list of prediction markets with filtering options","parameters":[{"name":"platform","in":"query","description":"Filter by platform (kalshi, polymarket)","schema":{"type":"string"}},{"name":"category","in":"query","description":"Filter by category","schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by market status","schema":{"type":"string"}},{"name":"keyword","in":"query","description":"Search in questions and descriptions","schema":{"type":"string"}},{"name":"tag","in":"query","description":"Filter by tag","schema":{"type":"string"}},{"name":"start","in":"query","description":"Filter by creation date (after)","schema":{"type":"string","format":"date-time"}},{"name":"end","in":"query","description":"Filter by creation date (before)","schema":{"type":"string","format":"date-time"}},{"name":"end_date_after","in":"query","description":"Filter markets ending after this date","schema":{"type":"string","format":"date-time"}},{"name":"end_date_before","in":"query","description":"Filter markets ending before this date","schema":{"type":"string","format":"date-time"}},{"name":"probability_min","in":"query","description":"Minimum probability (0-100)","schema":{"type":"number"}},{"name":"probability_max","in":"query","description":"Maximum probability (0-100)","schema":{"type":"number"}},{"name":"volume_min","in":"query","description":"Minimum volume","schema":{"type":"number"}},{"name":"volume_max","in":"query","description":"Maximum volume","schema":{"type":"number"}},{"name":"include_closed","in":"query","description":"Include closed markets","schema":{"type":"boolean","default":false}},{"name":"include_resolved","in":"query","description":"Include resolved markets","schema":{"type":"boolean","default":false}},{"name":"sort_dir","in":"query","description":"Sort direction","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","description":"Legacy row cap; pagination uses per_page","schema":{"type":"integer","default":100,"minimum":1,"maximum":1000}},{"name":"page","in":"query","description":"Page number","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","description":"Items per page","schema":{"type":"integer","default":100,"maximum":500}}],"responses":[{"status":"200","description":"List of markets","schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"market_id":{"type":"string"},"ticker":{"type":"string"},"platform":{"type":"string"},"question":{"type":"string"},"probability":{"type":["number","null"]},"volume":{"type":["number","null"]},"volume_24h":{"type":["number","null"]},"open_interest":{"type":["number","null"]},"last_price":{"type":["number","null"]},"status":{"type":"string"},"category":{"type":["string","null"]},"end_date":{"type":["string","null"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"link":{"type":["string","null"]},"state_code":{"type":["string","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"}]}} />