GET /api/markets/:id

Get detailed information for a specific prediction market

Fetch detailed information for a specific prediction market, including optional price history and recent trades.

---

Endpoint

GET https://app.kash.bot/api/markets/{id}

Path Parameters

id · string · required

The unique market identifier

Query Parameters

history · boolean · default: "false"

Include price history snapshots (up to 100 data points)

trades · boolean · default: "false"

Include recent trades

trades_limit · number · default: "20"

Number of recent trades to return (max: 100). Only applies when trades=true

Response

market · object

Complete market details

Show Market Object

id · string

Unique market identifier

question · string

Market question

description · string

Market description

probability · number

Current YES probability (0-1)

yesPrice · number

Current YES share price

noPrice · number

Current NO share price

totalVolume · number

Total trading volume in cents

tradeCount · number

Number of trades

status · string

Market status: OPEN, FROZEN, RESOLVED, CANCELLED

endTime · number

Market end time (Unix timestamp in milliseconds)

category · string

Market category

createdAt · string

ISO 8601 timestamp of market creation

sourceTweetUrl · string

URL of the original market tweet

priceHistory · array

Price history data (only if history=true)

priceHistory · array

Price history snapshots (only included if history=true)

Show Price History Point

timestamp · string

ISO 8601 timestamp

price · number

Price at this timestamp (0-1)

probability · number

Probability at this timestamp (0-1)

volume · number

Cumulative volume at this timestamp

recentTrades · array

Recent trades (only included if trades=true)

Show Trade Object

id · string

Trade ID

side · string

Trade side: YES or NO

amount · number

Trade amount

price · number

Execution price

timestamp · string

Trade timestamp

Rate Limit

100 requests per minute per IP address

Example Request

cURL

curl "https://app.kash.bot/api/markets/abc123"

Example Response

200 - Success

{
  "market": {
    "id": "abc123",
    "question": "Will BTC hit $100k by end of 2025?",
    "description": "Resolves YES if Bitcoin reaches $100,000 USD on any major exchange before December 31, 2025",
    "probability": 0.72,
    "yesPrice": 0.72,
    "noPrice": 0.28,
    "totalVolume": 1250000,
    "tradeCount": 450,
    "status": "OPEN",
    "endTime": 1735689600000,
    "category": "crypto",
    "createdAt": "2024-01-01T00:00:00Z",
    "sourceTweetUrl": "https://x.com/kash_bot/status/123456789"
  },
  "_meta": {
    "requestedAt": "2025-01-15T12:00:00Z",
    "includes": {
      "history": false,
      "trades": false,
      "tradesCount": 0
    }
  }
}

200 - With History & Trades

{
  "market": {
    "id": "abc123",
    "question": "Will BTC hit $100k by end of 2025?",
    "probability": 0.72,
    "priceHistory": [
      { "timestamp": 1705320000000, "probability": 0.72 },
      { "timestamp": 1705233600000, "probability": 0.68 },
      { "timestamp": 1705147200000, "probability": 0.65 }
    ]
  },
  "priceHistory": [
    { "timestamp": "2025-01-15T12:00:00Z", "price": 0.72, "probability": 0.72, "volume": 1250000 },
    { "timestamp": "2025-01-14T12:00:00Z", "price": 0.68, "probability": 0.68, "volume": 1100000 }
  ],
  "recentTrades": [
    { "id": "trade-1", "side": "YES", "amount": 5000, "price": 0.72, "timestamp": "2025-01-15T11:30:00Z" },
    { "id": "trade-2", "side": "NO", "amount": 2500, "price": 0.28, "timestamp": "2025-01-15T11:15:00Z" }
  ],
  "_meta": {
    "requestedAt": "2025-01-15T12:00:00Z",
    "includes": {
      "history": true,
      "trades": true,
      "tradesCount": 2
    }
  }
}

404 - Market Not Found

{
  "error": "Market not found"
}

---

Use Cases

Display Market Details

async function displayMarket(marketId) {
  const res = await fetch(`https://app.kash.bot/api/markets/${marketId}`);
  const { market } = await res.json();
  
  return {
    title: market.question,
    probability: `${(market.probability * 100).toFixed(0)}% YES`,
    volume: `$${(market.totalVolume / 100).toLocaleString()}`,
    status: market.status
  };
}

Build a Price Chart

async function getChartData(marketId) {
  const res = await fetch(`https://app.kash.bot/api/markets/${marketId}?history=true`);
  const { priceHistory } = await res.json();
  
  return priceHistory.map(point => ({
    x: new Date(point.timestamp),
    y: point.probability * 100
  }));
}