Skip to main content
GET
https://api.unitedmarket.ai
/
markets
List markets
curl --request GET \
  --url https://api.unitedmarket.ai/markets
[
  {
    "id": "<string>",
    "conditionId": "<string>",
    "question": "<string>",
    "slug": "<string>",
    "status": "<string>",
    "feeRateBps": 15,
    "feeRateBpsOverride": null,
    "startTimestamp": "2023-11-07T05:31:56Z",
    "matchStartTime": "2023-11-07T05:31:56Z",
    "matchEndTime": "2023-11-07T05:31:56Z",
    "endTimestamp": "2023-11-07T05:31:56Z",
    "outcomes": [
      {}
    ]
  }
]

Query Parameters

​
limit
integer
default:20

Maximum number of items to return.

Required range: 1 <= x <= 500
​
offset
integer
default:0

Number of items to skip.

Required range: x >= 0
​
tagSlug
string

Filter markets by tag slug.

​
q
string

Search query.

Response

200 - application/json

Markets returned.

​
id
string
​
conditionId
string
​
question
string
​
slug
string
​
status
string
​
feeRateBps
integer

Effective trading fee rate in basis points. Sign this value into orders for this market.

Example:

15

​
feeRateBpsOverride
integer | null

Raw per-market fee override, or null when the market inherits the tag/global rate.

Example:

null

​
startTimestamp
string<date-time> | null

When trading opens (recorded/displayed, not enforced).

​
matchStartTime
string<date-time> | null

Event kickoff time for sports fixtures (display only).

​
matchEndTime
string<date-time> | null

Event/match end time for sports fixtures (display only; defaults to kickoff + 150 minutes).

​
endTimestamp
string<date-time>

When the market closes and moves to resolution.

​
outcomes
object[]