GET /api/v1/questions/{id} — Question Detail

The question detail endpoint returns everything Predexy knows about a single canonical question. The response includes every platform market linked to that question, each market’s outcome prices and 24-hour volume, the algorithm that matched it, and the computed index — including the best buy and sell prices, spread in basis points, and per-platform price breakdown.

Endpoint

GET https://api.predexy.com/api/v1/questions/{id}

Authentication

A session JWT is required:

Authorization: Bearer <your_jwt>

Path parameters

string

required

Canonical question UUID. Obtain this from the id field returned by GET /api/v1/discover.

Example request

cURL

curl https://api.predexy.com/api/v1/questions/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer <your_jwt>"

Response

The response wraps a single QuestionDetail object in data.

QuestionDetail fields

string

required

Canonical question UUID.

title

string

required

Canonical question text.

slug

string

required

URL-safe identifier.

Sample response

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "title": "Will BTC reach $100k by 2026?",
    "slug": "will-btc-reach-100k-by-2026",
    "category": "crypto",
    "end_time": "2026-01-01T00:00:00Z",
    "markets": [
      {
        "id": "a1b2c3d4-0000-0000-0000-000000000001",
        "title": "Bitcoin to $100,000 before 2026?",
        "slug": "bitcoin-100k-2026",
        "status": "open",
        "platform_market_id": "0xabc123",
        "platform_id": "e1f2a3b4-0000-0000-0000-000000000010",
        "platform_slug": "polymarket",
        "platform_name": "Polymarket",
        "volume24h": 52000.00,
        "liquidity": 180000.00,
        "confidence": 0.97,
        "match_method": "semantic",
        "outcomes": [
          { "label": "Yes", "outcome_index": 0, "price": 0.62 },
          { "label": "No",  "outcome_index": 1, "price": 0.38 }
        ]
      },
      {
        "id": "a1b2c3d4-0000-0000-0000-000000000002",
        "title": "Will BTC reach $100k by 2026?",
        "slug": "btc-100k-2026",
        "status": "open",
        "platform_market_id": "limit-789",
        "platform_id": "e1f2a3b4-0000-0000-0000-000000000011",
        "platform_slug": "limitless",
        "platform_name": "Limitless",
        "volume24h": 8200.00,
        "liquidity": 21000.00,
        "confidence": 0.91,
        "match_method": "semantic",
        "outcomes": [
          { "label": "Yes", "outcome_index": 0, "price": 0.58 },
          { "label": "No",  "outcome_index": 1, "price": 0.42 }
        ]
      }
    ],
    "index": {
      "index_price": 0.61,
      "divergence": 0.034,
      "divergence_category": "medium",
      "platform_count": 2,
      "best_buy_price": 0.58,
      "best_buy_platform": "limitless",
      "best_sell_price": 0.62,
      "best_sell_platform": "polymarket",
      "spread_bps": 400,
      "platform_prices": {
        "polymarket": 0.62,
        "limitless": 0.58
      }
    }
  }
}

The platform_prices map in the index result is the fastest way to compare prices at a glance. If you need to act on an opportunity, pair the best_buy_platform and best_sell_platform values with the corresponding platform_market_id from the markets array to route your order to the right venue.

Overview

Markets & Discovery

Arbitrage

Account

Console

GET /api/v1/questions/{id} — Question Detail

Endpoint

Authentication

Path parameters

Example request

Response

QuestionDetail fields

Sample response

​Endpoint

​Authentication

​Path parameters

​Example request

​Response

​QuestionDetail fields

​Sample response

Endpoint

Authentication

Path parameters

Example request

Response

QuestionDetail fields

Sample response