{
 "openapi": "3.0.3",
 "info": {
  "title": "Polymarket View odds API",
  "version": "1.0.0",
  "description": "Static, key-less JSON with Polymarket odds for 1675 top markets. CC BY 4.0: credit PolymarketTrader with a link.",
  "license": {
   "name": "CC BY 4.0",
   "url": "https://creativecommons.org/licenses/by/4.0/"
  }
 },
 "servers": [
  {
   "url": "https://polymarkettrader.com"
  }
 ],
 "paths": {
  "/api/v1/odds/index.json": {
   "get": {
    "summary": "All tracked markets",
    "responses": {
     "200": {
      "description": "Market list"
     }
    }
   }
  },
  "/api/v1/odds/{slug}.json": {
   "get": {
    "summary": "One market with outcomes and 30-day history",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Market detail"
     }
    }
   }
  },
  "/api/v1/topics/index.json": {
   "get": {
    "summary": "All topics with market counts",
    "responses": {
     "200": {
      "description": "Topic list"
     }
    }
   }
  },
  "/api/v1/topics/{topic}.json": {
   "get": {
    "summary": "Every live market on one topic",
    "parameters": [
     {
      "name": "topic",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Topic markets"
     }
    }
   }
  },
  "/api/v1/movers.json": {
   "get": {
    "summary": "24-hour biggest movers",
    "responses": {
     "200": {
      "description": "Movers list"
     }
    }
   }
  },
  "/api/v1/fees.json": {
   "get": {
    "summary": "Live Polymarket fee schedules by category",
    "responses": {
     "200": {
      "description": "Fee schedules"
     }
    }
   }
  },
  "/api/v1/new-markets.json": {
   "get": {
    "summary": "Markets opened in the last 7 days",
    "responses": {
     "200": {
      "description": "New markets"
     }
    }
   }
  },
  "/api/v1/compare/polymarket-kalshi.json": {
   "get": {
    "summary": "Same events priced on Polymarket and Kalshi",
    "responses": {
     "200": {
      "description": "Comparison"
     }
    }
   }
  },
  "/api/v1/stats.json": {
   "get": {
    "summary": "Polymarket statistics with daily history",
    "responses": {
     "200": {
      "description": "Statistics"
     }
    }
   }
  },
  "/api/v1/calendar/{month}.json": {
   "get": {
    "summary": "Markets ending in one month (e.g. october-2026) with date, odds or result",
    "parameters": [
     {
      "name": "month",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Monthly calendar"
     }
    }
   }
  },
  "/api/v1/accuracy.json": {
   "get": {
    "summary": "Accuracy study: resolved markets, price a week before close, outcome, calibration",
    "responses": {
     "200": {
      "description": "Accuracy sample and summary"
     }
    }
   }
  },
  "/api/v1/people/index.json": {
   "get": {
    "summary": "People with live markets",
    "responses": {
     "200": {
      "description": "People list"
     }
    }
   }
  },
  "/api/v1/people/{slug}.json": {
   "get": {
    "summary": "Every live market on one person",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Person markets"
     }
    }
   }
  },
  "/api/v1/futures/index.json": {
   "get": {
    "summary": "Teams and players with live futures markets",
    "responses": {
     "200": {
      "description": "Futures list"
     }
    }
   }
  },
  "/api/v1/futures/{slug}.json": {
   "get": {
    "summary": "Every live futures market on one team or player",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Futures markets"
     }
    }
   }
  },
  "/api/v1/games.json": {
   "get": {
    "summary": "Upcoming games by league with winner prices",
    "responses": {
     "200": {
      "description": "Games by league"
     }
    }
   }
  },
  "/api/v1/crypto-prices.json": {
   "get": {
    "summary": "Market-implied crypto prices for the next days (median, 50%/80% ranges, ladders)",
    "responses": {
     "200": {
      "description": "Crypto price predictions"
     }
    }
   }
  },
  "/api/v1/midterms-2026.json": {
   "get": {
    "summary": "2026 Senate, House and governor races with candidate prices and ratings",
    "responses": {
     "200": {
      "description": "Midterm races"
     }
    }
   }
  },
  "/api/v1/fed-rates.json": {
   "get": {
    "summary": "Fed decision odds by FOMC meeting with implied change",
    "responses": {
     "200": {
      "description": "Fed rate odds"
     }
    }
   }
  },
  "/api/v1/polymarket-kalshi-gaps.json": {
   "get": {
    "summary": "Every outcome priced on both Polymarket and Kalshi, with the gap",
    "responses": {
     "200": {
      "description": "Price gaps"
     }
    }
   }
  },
  "/api/v1/leaderboard.json": {
   "get": {
    "summary": "Top traders by profit and volume",
    "responses": {
     "200": {
      "description": "Leaderboards"
     }
    }
   }
  },
  "/api/v1/whales.json": {
   "get": {
    "summary": "Trades of $10,000 or more in the last 24 hours",
    "responses": {
     "200": {
      "description": "Trades"
     }
    }
   }
  },
  "/api/v1/resolved.json": {
   "get": {
    "summary": "Markets resolved in the last 7 days",
    "responses": {
     "200": {
      "description": "Results"
     }
    }
   }
  },
  "/api/v1/upsets.json": {
   "get": {
    "summary": "Long shots (20% or less a week before close) that resolved Yes",
    "responses": {
     "200": {
      "description": "Upsets list"
     }
    }
   }
  },
  "/api/v1/accuracy.csv": {
   "get": {
    "summary": "Accuracy study sample as CSV",
    "responses": {
     "200": {
      "description": "CSV",
      "content": {
       "text/csv": {}
      }
     }
    }
   }
  }
 }
}