Skip to main content
GET
/
api
/
{exchange}
/
fetchMarket
curl --request GET \
  --url https://api.pmxt.dev/api/{exchange}/fetchMarket \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "error": {
    "message": "<string>"
  },
  "data": {
    "marketId": "<string>",
    "title": "<string>",
    "description": "<string>",
    "outcomes": [
      {
        "outcomeId": "<string>",
        "label": "<string>",
        "price": 123,
        "marketId": "<string>",
        "priceChange24h": 123,
        "metadata": {}
      }
    ],
    "resolutionDate": "2023-11-07T05:31:56Z",
    "volume24h": 123,
    "liquidity": 123,
    "url": "<string>",
    "eventId": "<string>",
    "slug": "<string>",
    "volume": 123,
    "openInterest": 123,
    "image": "<string>",
    "category": "<string>",
    "tags": [
      "<string>"
    ],
    "tickSize": 123,
    "status": "<string>",
    "contractAddress": "<string>",
    "yes": {
      "outcomeId": "<string>",
      "label": "<string>",
      "price": 123,
      "marketId": "<string>",
      "priceChange24h": 123,
      "metadata": {}
    },
    "no": {
      "outcomeId": "<string>",
      "label": "<string>",
      "price": 123,
      "marketId": "<string>",
      "priceChange24h": 123,
      "metadata": {}
    },
    "up": {
      "outcomeId": "<string>",
      "label": "<string>",
      "price": 123,
      "marketId": "<string>",
      "priceChange24h": 123,
      "metadata": {}
    },
    "down": {
      "outcomeId": "<string>",
      "label": "<string>",
      "price": 123,
      "marketId": "<string>",
      "priceChange24h": 123,
      "metadata": {}
    }
  }
}

Authorizations

​
Authorization
string
header
required

Required when calling the hosted API directly (curl, requests, fetch). SDK users pass credentials via constructor params instead.

Path Parameters

​
exchange
enum<string>
required

The prediction market exchange to target.

Available options:
polymarket,
kalshi,
kalshi-demo,
limitless,
probable,
baozi,
myriad,
opinion,
metaculus,
smarkets,
polymarket_us

Query Parameters

​
limit
number

Maximum number of results to return

​
offset
number

Pagination offset — number of results to skip

​
sort
enum<string>

Sort order for results

Available options:
volume,
liquidity,
newest
​
status
enum<string>

Filter by market status (default: 'active', 'inactive' and 'closed' are interchangeable)

Available options:
active,
inactive,
closed,
all
​
searchIn
enum<string>

Where to search (default: 'title')

Available options:
title,
description,
both
​
query
string

For keyword search

​
slug
string

For slug/ticker lookup

​
marketId
string

Direct lookup by market ID

​
outcomeId
string

Reverse lookup -- find market containing this outcome

​
eventId
string

Find markets belonging to an event

​
page
number

For pagination (used by Limitless)

​
similarityThreshold
number

For semantic search (used by Limitless)

Response

200 - application/json

Fetch Market response

​
success
boolean
Example:

true

​
error
object
​
data
object