Skip to main content
GET
/
markets
/
public
/
list
List markets
curl --request GET \
  --url https://api.n2.market/api/v1/markets/public/list \
  --header 'X-API-Key: <api-key>'
{
  "markets": [
    {
      "id": "0336c14f-5a39-47c1-a88d-beee2e38163a",
      "questions": {
        "pt": "Quem ganhará a eleição?",
        "en": "Who will win the election?",
        "es": "¿Quién ganará la elección?"
      },
      "outcomes": [
        {
          "id": "yes",
          "text": {
            "pt": "Sim",
            "en": "Yes",
            "es": "Sí"
          },
          "odd": 1.67,
          "probability": 0.6
        },
        {
          "id": "no",
          "text": {
            "pt": "Não",
            "en": "No",
            "es": "No"
          },
          "odd": 2.5,
          "probability": 0.4
        }
      ],
      "descriptions": {
        "pt": "Mercado sobre a eleição presidencial",
        "en": "Market about the presidential election",
        "es": "Mercado sobre la elección presidencial"
      },
      "status": "ACTIVE",
      "logo": "https://cdn.n2.market/markets/election.png",
      "categories": [
        {
          "id": "cat-123",
          "name": "Politics",
          "slug": "politics"
        }
      ]
    }
  ],
  "total": 150,
  "limit": 20,
  "offset": 0
}

Authorizations

X-API-Key
string
header
required

API Key for authentication. Get your key from the dashboard.

Query Parameters

highlighted
boolean

Filter by highlighted status. true returns only highlighted markets, false returns only non-highlighted markets.

categoryIds
string

Comma-separated list of category UUIDs to filter by

limit
integer
default:20

Maximum number of markets to return

Required range: x >= 1
offset
integer
default:0

Number of markets to skip for pagination

Required range: x >= 0

Response

200 - application/json

List of markets retrieved successfully

markets
object[]
total
integer

Total number of markets matching the filters

limit
integer

Number of markets returned

offset
integer

Offset used for pagination