Market Data

Access comprehensive prediction market information including orderbooks, positions, curator staking, trading statistics, and real-time predictions.

List Markets

GET/markets

Returns a paginated list of prediction markets with optional filtering.

Query Parameters

Parameter	Type	Default	Description
status	string	all	OPEN, CLOSED, RESOLVING, FINALIZED, CANCELLED
category	string	all	Filter by category
page	number	1	Page number
pageSize	number	50	Results per page (max 100)

Request

cURL

curl -X GET "https://api.predikt.fun/api/v1/markets?status=OPEN&page=1&pageSize=10" \
  -H "Authorization: Bearer pk_live_your_api_key"

Response

Response (200)

{
  "requestId": "req_abc123",
  "markets": [
    {
      "id": "clx1234567890",
      "title": "Will SOL reach $200 by January 31, 2026?",
      "description": "Market resolves YES if...",
      "category": "Crypto",
      "status": "OPEN",
      "resolutionType": "PRICE_FEED",
      "outcomes": [
        { "index": 0, "label": "Yes" },
        { "index": 1, "label": "No" }
      ],
      "createdAt": "2026-01-01T00:00:00.000Z",
      "closesAt": "2026-01-31T00:00:00.000Z"
    }
  ],
  "total": 150,
  "page": 1,
  "pageSize": 10,
  "costUsd": "0.05",
  "remainingBalanceUsd": "45.95"
}

Get Market Details (Extended)

GET/markets/:id

Returns comprehensive market data including orderbooks, aggregate position stats, curator staking information, trading statistics, and current predictions. Data is cached for 1 minute for optimal performance.

Request

cURL

curl -X GET "https://api.predikt.fun/api/v1/markets/clx1234567890" \
  -H "Authorization: Bearer pk_live_your_api_key"

Response

Response (200)

{
  "requestId": "req_xyz789",
  "id": "clx1234567890",
  "slug": "will-sol-reach-200-by-january-31-2026",
  "title": "Will SOL reach $200 by January 31, 2026?",
  "description": "This market resolves YES if the price of SOL...",
  "category": "Crypto",
  "imageUrl": "https://example.com/sol.png",
  "status": "OPEN",
  "marketType": "BINARY",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "closesAt": "2026-01-31T00:00:00.000Z",
  "outcomes": [
    {
      "index": 0,
      "label": "Yes",
      "totalShares": "1500000000",
      "totalWagered": "750000000000",
      "totalWageredSol": 750.0,
      "totalWageredUsd": 97500.00,
      "lastPrice": 6500,
      "probability": 0.65
    },
    {
      "index": 1,
      "label": "No",
      "totalShares": "800000000",
      "totalWagered": "400000000000",
      "totalWageredSol": 400.0,
      "totalWageredUsd": 52000.00,
      "lastPrice": 3500,
      "probability": 0.35
    }
  ],
  "orderbooks": {
    "0": {
      "bids": [
        { "price": 6400, "amount": "50000000000", "valueSol": 32.0, "valueUsd": 4160.00, "orders": 3 },
        { "price": 6300, "amount": "75000000000", "valueSol": 47.25, "valueUsd": 6142.50, "orders": 5 }
      ],
      "asks": [
        { "price": 6600, "amount": "40000000000", "valueSol": 26.4, "valueUsd": 3432.00, "orders": 2 },
        { "price": 6700, "amount": "60000000000", "valueSol": 40.2, "valueUsd": 5226.00, "orders": 4 }
      ],
      "spread": 200,
      "bestBid": 6400,
      "bestAsk": 6600
    },
    "1": {
      "bids": [
        { "price": 3400, "amount": "30000000000", "valueSol": 10.2, "valueUsd": 1326.00, "orders": 2 }
      ],
      "asks": [
        { "price": 3600, "amount": "25000000000", "valueSol": 9.0, "valueUsd": 1170.00, "orders": 1 }
      ],
      "spread": 200,
      "bestBid": 3400,
      "bestAsk": 3600
    }
  },
  "positionStats": {
    "totalPositions": 45,
    "totalShares": "2300000000",
    "uniqueHolders": 28,
    "totalWagered": "1150000000000",
    "totalWageredSol": 1150.0,
    "totalWageredUsd": 149500.00,
    "outcomeBreakdown": [
      { "index": 0, "label": "Yes", "totalWagered": "750000000000", "totalWageredSol": 750.0, "totalWageredUsd": 97500.00 },
      { "index": 1, "label": "No", "totalWagered": "400000000000", "totalWageredSol": 400.0, "totalWageredUsd": 52000.00 }
    ]
  },
  "curatorStaking": {
    "totalStaked": "500000000000",
    "totalStakedUsd": 250.50,
    "stakerCount": 12,
    "estimatedApy": 15.5,
    "lockPeriodSeconds": 604800,
    "topCurators": [
      {
        "rank": 1,
        "wallet": "7xKX...abc",
        "username": "whale_curator",
        "stakedAmount": "100000000000",
        "stakedAmountUsd": 50.10
      },
      {
        "rank": 2,
        "wallet": "9yLM...def",
        "username": null,
        "stakedAmount": "75000000000",
        "stakedAmountUsd": 37.58
      }
    ]
  },
  "prediction": {
    "priceFeed": {
      "currentPrice": 185.50,
      "targetPrice": 200,
      "condition": "above",
      "symbol": "SOL",
      "tolerance": 0,
      "lastUpdated": "2026-01-21T10:30:00.000Z"
    },
    "aiPrediction": null
  },
  "tradingStats": {
    "totalVolume": "1150000000000",
    "totalVolumeSol": 1150.0,
    "totalVolumeUsd": 149500.00,
    "totalTrades": 156,
    "totalBettors": 28,
    "last24hVolume": "125000000000",
    "last24hVolumeSol": 125.0,
    "last24hVolumeUsd": 16250.00,
    "last24hTrades": 18
  },
  "resolution": {
    "type": "PRICE_FEED",
    "source": "SOL:above:200:0",
    "metadata": {
      "type": "PRICE_FEED",
      "symbol": "SOL",
      "condition": "above",
      "targetPrice": 200,
      "tolerance": 0
    },
    "resolvedAt": null,
    "winningOutcomeIndex": null,
    "details": null
  },
  "creator": {
    "wallet": "5xAB...xyz",
    "username": "market_maker",
    "credibilityScore": 850
  },
  "credibilityScore": 720,
  "feeBps": 100,
  "costUsd": "0.02",
  "remainingBalanceUsd": "49.98"
}

Response Fields

Field	Type	Description
outcomes	array	Extended outcomes with totalShares, totalWagered, lastPrice (basis points), and probability
orderbooks	object	Orderbook per outcome index with bids, asks, spread, bestBid, bestAsk
positionStats	object	Aggregate stats: totalPositions, totalShares, uniqueHolders
curatorStaking	object	Curator stats: totalStaked, stakerCount, estimatedApy, topCurators (top 5)
prediction	object	Current prediction: priceFeed (currentPrice, targetPrice) or aiPrediction (confidence, agreement)
tradingStats	object	Trading metrics: totalVolume, totalTrades, totalBettors, last24h stats
resolution	object	Resolution info: type, source, metadata, resolvedAt, winningOutcomeIndex
creator	object	Creator info: wallet, username, credibilityScore
credibilityScore	number	Market credibility score (0-1000) based on curator activity and creator reputation

Market Statuses

Status	Description
DRAFT	Market is being created
OPEN	Market is open for trading
CLOSED	Trading closed, awaiting resolution
RESOLVING	Resolution in progress
FINALIZED	Market resolved, payouts available
CANCELLED	Market cancelled, funds returned

Resolution Types

Type	Description
PRICE_FEED	Resolved automatically based on price data
AI	Resolved using AI multi-model consensus
ADMIN	Resolved manually by admin
MANUAL_VOTE	Resolved by community vote

Market Data

List Markets

Query Parameters

Request

Response

Get Market Details (Extended)

Request

Response

Response Fields

Market Statuses

Resolution Types

Related