# Manifold API
> Live prediction-market and forecaster data from Manifold, the largest play-money prediction market and forecasting community, via its public API. On Manifold anyone can create a market and everyone trades with mana, the platform's play-money, so each market's price is a crowd-sourced probability and every trader has a track record. Search markets and get each one's question, current probability, mana volume, unique-bettor count, liquidity and creator. Read one market in full, with its description and close time. See the top holders of a market — who is forecasting which way and how much mana they have invested. Read a forecaster's profile: their mana balance, all-time profit and how many markets they have created. Live, no key, nothing stored. Distinct from real-money prediction-market and sports-odds APIs — this is Manifold's community markets, their crowd probabilities and their forecasters. Perfect for forecasting, trading-signal, research and community apps.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/manifold-api/..."
```

## Pricing
- **Free** (Free) — 10,000 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 162,000 calls/Mo, 6 req/s
- **Pro** ($25/Mo) — 915,000 calls/Mo, 15 req/s
- **Business** ($63/Mo) — 4,950,000 calls/Mo, 40 req/s

## Endpoints

### Markets

#### `GET /v1/market` — One market in full

**Parameters:**
- `id` (query, required, string) — Manifold market id Example: `L8EuhySAdp`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/manifold-api/v1/market?id=L8EuhySAdp"
```

**Response:**
```json
{
    "data": {
        "id": "L8EuhySAdp",
        "url": "https://manifold.markets/MikhailTal/catl-receives-license-renewal-for-y-UAuzRyILcp",
        "slug": "catl-receives-license-renewal-for-y-UAuzRyILcp",
        "source": "Manifold",
        "creator": "MikhailTal",
        "question": "CATL receives license renewal for Yichun Lithium mine by end of Feb 2027?",
        "close_time": "2027-02-28T23:59:00.000Z",
        "resolution": null,
        "description": "Resolution criteria\n\nThis market resolves to YES if, by 23:59 China Standard Time (UTC+8) on February 28, 2027, CATL (Contemporary Amperex Technology Co., Limited) or its controlled subsidiaries receive official government approval that renews or reissues the mining license authorizing production to resume at the Jianxiawo (枧下窝) lithium-bearing ceramic clay mine in Yichun, Jiangxi Province.\n\nOtherwise, this market resolves to NO.\n\nAcceptable Proof & Verification Sources:\n\nOfficial corporate regulatory filings or announcements from CATL (SZSE: 300750) on CNINFO or the Shenzhen Stock Exchange (S",
        "is_resolved": false,
        "volume_mana": 49297.97,
        "created_time": "2026-06-09T14:12:01.950Z",
        "creator_name": "Mikhail Tal",
        "outcome_type": "BINARY",
        "liquidity_mana": 105000,
        "unique_bettors": 38,
        "probability_pct": 57.48
    },
    "meta": {
        "timestamp": "2026-06-10T14:02:13.597Z",
        "request_id": "53a20950-5a97-4458-b7b4-6b6fa958
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/markets` — Search markets with probabilities

**Parameters:**
- `term` (query, optional, string) — Search term Example: `election`
- `sort` (query, optional, string) — score, newest, liquidity, 24-hour-vol Example: `score`
- `filter` (query, optional, string) — open, closed, resolved, all Example: `open`
- `limit` (query, optional, string) — Max 1-100 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/manifold-api/v1/markets?term=election&sort=score&filter=open&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "score",
        "term": "election",
        "count": 25,
        "filter": "open",
        "source": "Manifold",
        "markets": [
            {
                "id": "KmbNYfuOrUnI1w1GSHdb",
                "url": "https://manifold.markets/Conflux/who-will-win-the-2026-california-gu",
                "slug": "who-will-win-the-2026-california-gu",
                "creator": "Conflux",
                "question": "Who will win the 2026 California gubernatorial election?",
                "close_time": "2026-11-09T07:59:00.000Z",
                "resolution": null,
                "is_resolved": false,
                "volume_mana": 31489.56,
                "creator_name": "Conflux 🔗",
                "outcome_type": "MULTIPLE_CHOICE",
                "liquidity_mana": 655,
                "unique_bettors": 55,
                "probability_pct": null
            },
            {
                "id": "wpdomi6nif",
                "url": "https://manifold.markets/LarsDoucet/will-jd-vance-win-the-2028-us-presi",
                "slug": "will-jd-vance-win-the-2028-us-presi",
                "creator": "LarsDoucet",
                "question": "Will JD Vance win the 2028 US Presidential Election?",
                "close_time": "2028-11-08T05:59:00.000Z",
                "resolution": null,
                "is_resolved": false,
                "volume_mana": 588148.33,
                "creator_name": "Lars Doucet",
                "outcome_typ
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/positions` — Top holders of a market

**Parameters:**
- `id` (query, required, string) — Manifold market id Example: `L8EuhySAdp`
- `top` (query, optional, string) — Max 1-50 Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/manifold-api/v1/positions?id=L8EuhySAdp&top=10"
```

**Response:**
```json
{
    "data": {
        "count": 27,
        "source": "Manifold",
        "holders": [
            {
                "name": null,
                "username": null,
                "profit_mana": 2594.54,
                "total_shares": 48235.49,
                "invested_mana": 25050,
                "has_yes_shares": true
            },
            {
                "name": null,
                "username": null,
                "profit_mana": 31.52,
                "total_shares": 2532.69,
                "invested_mana": 1420,
                "has_yes_shares": true
            },
            {
                "name": null,
                "username": null,
                "profit_mana": 31.5,
                "total_shares": 1799.81,
                "invested_mana": 1000,
                "has_yes_shares": true
            },
            {
                "name": null,
                "username": null,
                "profit_mana": 27.13,
                "total_shares": 284.64,
                "invested_mana": 136,
                "has_yes_shares": true
            },
            {
                "name": null,
                "username": null,
                "profit_mana": 26.9,
                "total_shares": 284.23,
                "invested_mana": 136,
                "has_yes_shares": true
            },
            {
                "name": null,
                "username": null,
                "profit_mana": 25.88,
                "total_shares": 4745.73,
       
…(truncated, see openapi.json for full schema)
```

### Forecasters

#### `GET /v1/user` — A forecaster profile

**Parameters:**
- `username` (query, required, string) — Manifold username Example: `jack`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/manifold-api/v1/user?username=jack"
```

**Response:**
```json
{
    "data": {
        "bio": "Understanding and optimizing the world. Software engineer, EA, and forecasting enthusiast. If I win mana from you, thank you for matching my donations towards reducing AI x-risk.",
        "url": "https://manifold.markets/jack",
        "name": "Jack",
        "source": "Manifold",
        "username": "jack",
        "balance_mana": 1140612.6,
        "created_time": "2022-01-02T05:50:45.330Z",
        "markets_created": null,
        "total_deposits_mana": 1176081.53,
        "profit_all_time_mana": null
    },
    "meta": {
        "timestamp": "2026-06-10T14:02:14.686Z",
        "request_id": "0f9e37f8-e79b-4366-b430-308015e72892"
    },
    "status": "ok",
    "message": "User retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/manifold-api
OpenAPI spec: https://www.oanor.com/api/manifold-api/openapi.json
