Skills
skills/outsharp/shipp-skills/manifold

manifold

SKILL.md

Manifold API

Manifold is a prediction market platform where users create and trade on questions about real-world events. It uses a combination of play-money (mana) and prize-cash, with automated market makers (CPMM) and a rich API for programmatic access.

Check this skill and the official documentation FREQUENTLY for updates. The API is still in alpha and may change without notice.

Community: Join the Manifold Discord for questions, bug reports, and to share what you build.

Source code: Manifold is open source. Type definitions live at common/src/api/schema.ts.

Key Concepts (Glossary)

Term Definition
Market (Contract) A single tradeable question. Called "contract" in the codebase, "market" in the API. Has an outcome type (BINARY, MULTIPLE_CHOICE, PSEUDO_NUMERIC, BOUNTIED_QUESTION, POLL).
Mana (M$) Play-money currency used for most markets. Cannot be withdrawn for real money.
Prize Cash (CASH) Real-money currency available on select markets. Can be withdrawn. Identified by token: "CASH" on a market.
Sibling Contract The mana or prize-cash counterpart of a market. Toggle between them via siblingContractId.
Topic (Group) A tag applied to markets for categorization. Called "group" in the codebase and API.
CPMM Constant Product Market Maker. The automated market maker used for binary (cpmm-1) and multi-answer (cpmm-multi-1) markets.
DPM Dynamic Parimutuel Market — a legacy mechanism (dpm-2) used for older free-response markets.
Probability A number between 0 and 1 representing the market's current implied probability of YES.
Pool The liquidity pool of shares backing the market maker. For CPMM markets, shows YES and NO share counts.
Liquidity Mana deposited into the AMM pool. More liquidity means less price impact per trade.
Bet A trade on a market. Can be a market order or a limit order (when limitProb is specified).
Limit Order A bet that only executes at a specified probability price or better. Remains open until filled, cancelled, or expired.
Shares Units of a position. Winning YES shares pay out M$1 each; losing shares pay M$0.
Resolution The final outcome of a market: YES, NO, MKT (probability), or CANCEL.
Answer A possible outcome in a MULTIPLE_CHOICE or FREE_RESPONSE market. Each answer has its own probability.
Bounty A BOUNTIED_QUESTION market where the creator distributes mana rewards to the best comments/answers.
Poll A non-trading market type where users simply vote on options.

Base URLs

Environment REST API WebSocket
Production https://api.manifold.markets wss://api.manifold.markets/ws
Dev https://api.dev.manifold.markets wss://api.dev.manifold.markets/ws

Important: The API was recently moved from https://manifold.markets/api to https://api.manifold.markets. The old domain will be removed in the future. Always use the new domain.

All REST endpoints are prefixed with /v0/.

Documentation & References

Resource URL
API Documentation https://docs.manifold.markets/api
Platform https://manifold.markets
Source Code (GitHub) https://github.com/manifoldmarkets/manifold
API Type Definitions https://github.com/manifoldmarkets/manifold/tree/main/common/src/api/schema.ts
Discord Community https://discord.com/invite/eHQBNBqXuh
Terms of Service https://docs.manifold.markets/terms
Data Downloads & Licensing https://docs.manifold.markets/data

Authentication

Some endpoints are public (no auth required). Write endpoints and user-specific reads require authentication via an API key.

Generating an API Key

  1. Log in to Manifold.
  2. Go to your user profile and click "edit".
  3. Scroll to the API key field at the bottom.
  4. Click the "refresh" button to generate a new key.
  5. Copy and store the key securely. Clicking refresh again will invalidate the old key and generate a new one.

Using the API Key

Include the key in the Authorization header:

Authorization: Key {your_api_key}

Alternatively, the API accepts Firebase JWTs via Authorization: Bearer {jwt}, but this is intended for the web client and not recommended for third-party use.

Example Authenticated Request

curl "https://api.manifold.markets/v0/me" \
  -H "Authorization: Key YOUR_API_KEY"

Rate Limits

There is a rate limit of 500 requests per minute per IP address. Do not use multiple IP addresses to circumvent this limit.

Implement exponential backoff on HTTP 429 responses.

Fees

  • Comments placed through the API incur a M$1 transaction fee.
  • Market creation costs mana (see the market creation endpoint for current costs per type).

Licensing

  • Permitted: Bots, automated trading, algorithmic tools, integrations.
  • Prohibited: Scraping through means other than the API; circumventing rate limits.
  • AI training data: Not permitted for commercial use without a data license. Academic and personal/non-commercial use is allowed. Contact api@manifold.markets for commercial licensing.

REST API Endpoints Overview

All endpoints are relative to https://api.manifold.markets/v0.

Users

Endpoint Method Auth Description
/user/[username] GET No Get a user by username. Returns User.
/user/[username]/lite GET No Get basic display info by username. Returns DisplayUser.
/user/by-id/[id] GET No Get a user by unique ID. Returns User.
/user/by-id/[id]/lite GET No Get display info by ID. Returns DisplayUser.
/me GET Yes Get the authenticated user. Returns User.
/users GET No List all users, ordered by creation date desc. Params: limit (max 1000, default 500), before (user ID for pagination).

User Type

User {
  id: string
  createdTime: number
  name: string              // display name
  username: string           // used in URLs
  url: string
  avatarUrl?: string
  bio?: string
  bannerUrl?: string
  website?: string
  twitterHandle?: string
  discordHandle?: string
  isBot?: boolean
  isAdmin?: boolean
  isTrustworthy?: boolean    // moderator
  isBannedFromPosting?: boolean
  userDeleted?: boolean
  balance: number
  totalDeposits: number
  lastBetTime?: number
  currentBettingStreak?: number
}

DisplayUser Type

DisplayUser {
  id: string
  name: string
  username: string
  avatarUrl?: string
}

Portfolio

Endpoint Method Auth Description
/get-user-portfolio GET No Get a user's live portfolio metrics. Param: userId.
/get-user-portfolio-history GET No Get portfolio history over a period. Params: userId, period (daily, weekly, monthly, allTime).
/get-user-contract-metrics-with-contracts GET No* Get a user's positions and their contracts. Params: userId (required), limit (required), offset, order (lastBetTime or profit), perAnswer. *When authenticated, may include private market metrics visible to you.

PortfolioMetrics Type

PortfolioMetrics {
  investmentValue: number
  cashInvestmentValue: number
  balance: number
  cashBalance: number
  spiceBalance: number
  totalDeposits: number
  totalCashDeposits: number
  loanTotal: number
  timestamp: number
  profit?: number
  userId: string
}

LivePortfolioMetrics = PortfolioMetrics & {
  dailyProfit: number
}

Markets — Discovery & Listing

Endpoint Method Auth Description
/markets GET No List markets by creation date desc. Params: limit (max 1000, default 500), sort (created-time, updated-time, last-bet-time, last-comment-time), order (asc/desc), before (market ID for cursor pagination), userId, groupId. Returns LiteMarket[].
/market/[marketId] GET No Get a single market by ID. Returns FullMarket (includes answers, but not bets/comments).
/slug/[marketSlug] GET No Get a market by slug (URL path after username). Returns FullMarket.
/search-markets GET No Search/filter markets (similar to browse page). Returns LiteMarket[]. See parameters below.

Search Markets Parameters

Parameter Description
term Search query string. Can be empty.
sort most-popular (default), newest, score, daily-score, freshness-score, 24-hour-vol, liquidity, subsidy, last-updated, close-date, start-time, resolve-date, random, bounty-amount, prob-descending, prob-ascending.
filter all (default), open, closed, resolved, news, closing-90-days, closing-week, closing-month, closing-day.
contractType ALL (default), BINARY, MULTIPLE_CHOICE, DEPENDENT_MULTIPLE_CHOICE, INDEPENDENT_MULTIPLE_CHOICE, BOUNTY, POLL.
topicSlug Only markets tagged with this topic slug.
creatorId Only markets by this creator.
limit 0–1000 (default 100).
offset Number to skip (max 1000 when sort=newest).
beforeTime Millisecond timestamp cursor for efficient pagination with sort=newest. Pass createdTime of last result.
liquidity Minimum liquidity per contract/answer.

Markets — Probabilities

Endpoint Method Auth Description
/market/[marketId]/prob GET No Get current probability (max 1s cache). Returns { prob } for binary or { answerProbs: { answerId: prob } } for multi.
/market-probs GET No Batch probabilities for multiple markets (max 1s cache). Param: ids (array, up to 100). Returns `{ marketId: { prob }

Markets — Positions

Endpoint Method Auth Description
/market/[marketId]/positions GET No Get position data for a market. Params: order (shares/profit, default profit), top, bottom, userId, answerId. Returns ContractMetric[].

ContractMetric Type

ContractMetric {
  contractId: string
  from: {
    [period: string]: {     // day, week, month
      profit: number
      profitPercent: number
      invested: number
      prevValue: number
      value: number
    }
  } | undefined
  hasNoShares: boolean
  hasShares: boolean
  hasYesShares: boolean
  invested: number
  loan: number
  maxSharesOutcome: string | null
  payout: number
  profit: number
  profitPercent: number
  totalShares: { [outcome: string]: number }
  userId: string
  userUsername: string
  userName: string
  userAvatarUrl: string
  lastBetTime: number
}

Markets — Creation & Management

Endpoint Method Auth Description
/market POST Yes Create a new market. Returns LiteMarket. See parameters below.
/market/[marketId]/answer POST Yes Add an answer to a MULTIPLE_CHOICE market. Param: text.
/market/[marketId]/add-liquidity POST Yes Add mana to liquidity pool (does not boost). Param: amount.
/market/[marketId]/add-bounty POST Yes Add mana to a bounty question's reward. Param: amount.
/market/[marketId]/award-bounty POST Yes Distribute bounty reward. Params: amount, commentId.
/market/[marketId]/close POST Yes Set close time. Param: closeTime (ms since epoch; omit to close immediately).
/market/[marketId]/group POST Yes Add/remove a topic tag. Params: groupId, remove (optional, true to untag).
/market/[marketId]/resolve POST Yes Resolve a market. See resolution format below.

Market Creation Parameters

Common parameters (all market types):

Parameter Required Description
outcomeType Yes BINARY, MULTIPLE_CHOICE, PSEUDO_NUMERIC, POLL, BOUNTIED_QUESTION.
question Yes The headline question.
description No Plain text description. Or use descriptionHtml, descriptionMarkdown, or descriptionJson (stringified TipTap JSON).
closeTime No When the market closes (ms since epoch). Defaults to 7 days from now.
visibility No public (default) or unlisted.
groupIds No Array of topic IDs to tag.
extraLiquidity No Additional liquidity to add.

Additional parameters by type:

Type Extra Parameters
BINARY initialProb (1–99, required)
PSEUDO_NUMERIC min, max, isLogScale, initialValue (all required)
MULTIPLE_CHOICE answers (string[], required), addAnswersMode (DISABLED/ONLY_CREATOR/ANYONE, default DISABLED), shouldAnswersSumToOne (boolean)
BOUNTIED_QUESTION totalBounty (required)
POLL answers (string[], required)

Creation costs:

Type Cost
BINARY M$50
PSEUDO_NUMERIC M$250
MULTIPLE_CHOICE M$25/answer or M$25 for no preset answers

Resolution Formats

Binary markets:

  • outcome: YES, NO, MKT, or CANCEL.
  • probabilityInt: Optional, used when resolving to MKT.

Multiple Choice (shouldAnswersSumToOne = true):

{
  "outcome": "MKT",
  "resolutions": [
    { "answer": <index>, "pct": <weight> }
  ]
}

Weights must sum to 100. Or use outcome as a number for a single answer index, or CANCEL.

Multiple Choice (shouldAnswersSumToOne = false): Resolve each answer independently with separate requests:

{
  "outcome": "YES",    // or "NO"
  "answerId": "<answer_id>"
}

Numeric markets:

  • outcome: CANCEL or a numeric bucket ID.
  • value: The resolution value.
  • probabilityInt: Required if value is provided.

Trading

Endpoint Method Auth Description
/bet POST Yes Place a bet or limit order. Returns Bet.
/multi-bet POST Yes Place multiple YES bets on a sums-to-one multi-choice market, targeting equal shares per answer. Returns Bet[].
/bet/cancel/[id] POST Yes Cancel an open limit order.
/market/[marketId]/sell POST Yes Sell shares. Params: outcome (YES/NO, defaults to kind held), shares (optional, defaults to all), answerId (required for multi-choice).

Bet Parameters

Parameter Required Description
amount Yes Amount in mana to bet, before fees.
contractId Yes The market ID.
outcome No YES (default) or NO.
limitProb No Makes this a limit order. A number from 0.01 to 0.99 (whole percentage points only, e.g., 0.01 = 1%).
expiresAt No Timestamp (ms) when the limit order auto-cancels.
expiresMillisAfter No Milliseconds after creation for auto-cancel.
dryRun No If true, simulates without placing.

Multi-Bet Parameters

Parameter Required Description
contractId Yes Market ID. Must be cpmm-multi-1 with shouldAnswersSumToOne=true.
answerIds Yes Array of answer IDs (min 2).
amount Yes Total mana to spend across selected answers.
limitProb No Per-leg limit price (0.01–0.99, two decimal places).
expiresAt No Timestamp (ms) for auto-cancel of unfilled portions.

Comments

Endpoint Method Auth Description
/comment POST Yes Create a top-level comment on a market. Params: contractId, plus one of content (TipTap JSON), html, or markdown. Fee: M$1.
/comments GET No List comments for a market or user. Params: contractId, contractSlug, limit (max 1000), page, userId, order (likes/newest/oldest).

Bets

Endpoint Method Auth Description
/bets GET No List bets. Params: userId, username, contractId (can be multiple), contractSlug, limit (max 1000), before/after (bet ID cursors), beforeTime/afterTime (timestamps), kinds (open-limit), order (asc/desc).

Bet Type

Bet {
  id: string
  contractId: string
  userId: string
  amount: number            // mana spent (filled portion for limits)
  orderAmount: number       // original order amount
  shares: number
  outcome: "YES" | "NO"
  probBefore: number
  probAfter: number
  createdTime: number
  fees: {
    creatorFee: number
    platformFee: number
    liquidityFee: number
  }
  isFilled: boolean
  isCancelled: boolean
  loanAmount: number
  limitProb?: number        // present for limit orders
  fills: Fill[]
  answerId?: string         // for multi-choice markets
}

Fill {
  matchedBetId: string | null
  amount: number
  shares: number
  timestamp: number
  fees: { creatorFee: number; platformFee: number; liquidityFee: number }
}

Topics (Groups)

Endpoint Method Auth Description
/groups GET No List public topics, 500 at a time, newest first. Params: beforeTime, availableToUserId.
/group/[slug] GET No Get a topic by slug.
/group/by-id/[id] GET No Get a topic by ID.

Mana Transfers

Endpoint Method Auth Description
/managram POST Yes Send mana to other users. Params: toIds (array of user IDs), amount (>= 10, sent to each), message (optional).

Transactions

Endpoint Method Auth Description
/txns GET No List transactions, newest first. Params: token (CASH/MANA), offset, limit (max 100), before/after (timestamps), toId, fromId, category.

Leagues

Endpoint Method Auth Description
/leagues GET No Get league standings. Params: userId, season (number), cohort (string).

Market Types

outcomeType mechanism Description
BINARY cpmm-1 Yes/No market with a single probability (0–1). Most common type.
MULTIPLE_CHOICE cpmm-multi-1 Multiple answers, each with its own probability. Can be dependent (sum to 100%) or independent.
FREE_RESPONSE dpm-2 Legacy. Anyone can add answers. Uses DPM mechanism.
PSEUDO_NUMERIC cpmm-1 Maps probability to a numeric range [min, max]. Can be linear or log scale.
BOUNTIED_QUESTION — No trading. Creator distributes bounty to best comments.
POLL — No trading. Users vote on options.

LiteMarket Type

LiteMarket {
  id: string
  creatorId: string
  creatorUsername: string
  creatorName: string
  creatorAvatarUrl?: string
  createdTime: number
  closeTime?: number
  question: string
  url: string                      // always points to manifold.markets
  outcomeType: string
  mechanism: string
  probability: number
  pool: { [outcome: string]: number }
  p?: number                       // CPMM probability constant
  totalLiquidity?: number          // CPMM only
  value?: number                   // PSEUDO_NUMERIC only
  min?: number                     // PSEUDO_NUMERIC only
  max?: number                     // PSEUDO_NUMERIC only
  isLogScale?: boolean             // PSEUDO_NUMERIC only
  volume: number
  volume24Hours: number
  isResolved: boolean
  resolutionTime?: number
  resolution?: string
  resolutionProbability?: number   // for MKT resolution
  uniqueBettorCount: number
  lastUpdatedTime?: number
  lastBetTime?: number
  token?: "MANA" | "CASH"
  siblingContractId?: string       // toggle between mana/cash version
}

FullMarket Type

FullMarket = LiteMarket & {
  answers?: Answer[]                          // multi markets only
  shouldAnswersSumToOne?: boolean             // multi markets only
  addAnswersMode?: "ANYONE" | "ONLY_CREATOR" | "DISABLED"
  options?: { text: string; votes: number }[] // poll only
  totalBounty?: number                        // bounty only
  bountyLeft?: number                         // bounty only
  description: JSONContent                    // TipTap rich text
  textDescription: string                     // plain text
  coverImageUrl?: string
  groupSlugs?: string[]                       // topic tags
}

WebSocket API

Manifold provides a real-time WebSocket server for subscribing to live updates.

Connection

wss://api.manifold.markets/ws         (production)
wss://api.dev.manifold.markets/ws     (dev)

No authentication is required to connect. Authentication is optional (for user-specific topics).

Message Format

All messages are JSON. Client messages must include:

  • type: identify, subscribe, unsubscribe, or ping.
  • txid: A unique number identifying the message.

The server acknowledges each message:

{ "type": "ack", "txid": 123, "success": true }

Subscribing to Topics

Send a subscribe message:

{
  "type": "subscribe",
  "txid": 1,
  "topics": ["global/new-bet", "contract/[marketId]"]
}

Available Topics

Global Topics

Topic Description
global/new-bet All new bets across all markets.
global/new-contract All new markets being created.
global/new-comment All new comments across all markets.
global/new-subsidy All new liquidity subsidies.
global/updated-contract Updates to any public market.

Per-Market Topics (replace [marketId] with actual ID)

Topic Description
contract/[marketId] General market updates.
contract/[marketId]/new-bet New bets on this market.
contract/[marketId]/new-comment New comments on this market.
contract/[marketId]/new-subsidy New liquidity subsidies.
contract/[marketId]/new-answer New answers added (multi-choice).
contract/[marketId]/updated-answers Updates to existing answers.
contract/[marketId]/orders Limit order updates.
contract/[marketId]/chart-annotation Chart annotations.
contract/[marketId]/user-metrics/[userId] User position updates in this market.

Other Topics

Topic Description
user/[userId] Updates to a user's public info.
answer/[answerId]/update Updates to a specific answer.
tv_schedule Updates to the TV schedule.

Keep-Alive

Send periodic pings (every 30–60 seconds) to keep the connection alive. If no ping is received for 60 seconds, the server terminates the connection.

{ "type": "ping", "txid": 42 }

Broadcast Messages

The server sends updates as broadcast messages:

{
  "type": "broadcast",
  "topic": "global/new-bet",
  "data": { ... }
}

Common Patterns

List Recent Markets

curl -s "https://api.manifold.markets/v0/markets?limit=5" | jq '.[].question'

Get a Single Market by ID

curl -s "https://api.manifold.markets/v0/market/3zspH9sSzMlbFQLn9GKR" | jq '{question, probability, volume, isResolved}'

Get a Market by Slug

curl -s "https://api.manifold.markets/v0/slug/will-carrick-flynn-win-the-general" | jq '{question, probability}'

Search for Open Binary Markets

curl -s "https://api.manifold.markets/v0/search-markets?term=AI&sort=liquidity&filter=open&contractType=BINARY&limit=10" | jq '.[].question'

Get Current Probability

curl -s "https://api.manifold.markets/v0/market/9t61v9e7x4/prob" | jq '.'

Get Batch Probabilities

curl -s "https://api.manifold.markets/v0/market-probs?ids=9t61v9e7x4&ids=ZNlNdzz690" | jq '.'

Place a YES Bet

curl -X POST "https://api.manifold.markets/v0/bet" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 10, "contractId": "MARKET_ID", "outcome": "YES"}'

Place a Limit Order

curl -X POST "https://api.manifold.markets/v0/bet" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100,
    "contractId": "MARKET_ID",
    "outcome": "YES",
    "limitProb": 0.40,
    "expiresMillisAfter": 86400000
  }'

Sell All Shares in a Market

curl -X POST "https://api.manifold.markets/v0/market/MARKET_ID/sell" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"outcome": "YES"}'

Cancel a Limit Order

curl -X POST "https://api.manifold.markets/v0/bet/cancel/BET_ID" \
  -H "Authorization: Key YOUR_API_KEY"

Create a Binary Market

curl -X POST "https://api.manifold.markets/v0/market" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "outcomeType": "BINARY",
    "question": "Will it rain in SF tomorrow?",
    "descriptionMarkdown": "Resolves YES if measurable rainfall is recorded at SFO weather station.",
    "initialProb": 30,
    "closeTime": 1735689600000
  }'

Create a Multiple Choice Market

curl -X POST "https://api.manifold.markets/v0/market" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "outcomeType": "MULTIPLE_CHOICE",
    "question": "Who will win the award?",
    "answers": ["Alice", "Bob", "Charlie"],
    "shouldAnswersSumToOne": true,
    "addAnswersMode": "ONLY_CREATOR"
  }'

Resolve a Binary Market

curl -X POST "https://api.manifold.markets/v0/market/MARKET_ID/resolve" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"outcome": "YES"}'

Get Your Portfolio

curl -s "https://api.manifold.markets/v0/get-user-portfolio?userId=YOUR_USER_ID" | jq '.'

Get Top Positions on a Market

curl -s "https://api.manifold.markets/v0/market/MARKET_ID/positions?top=5&order=profit" | jq '.[].userName'

Paginate Through All Markets (by newest)

# Page 1
curl -s "https://api.manifold.markets/v0/search-markets?sort=newest&limit=100" > page1.json

# Page 2: use createdTime of last result
BEFORE_TIME=$(jq '.[-1].createdTime' page1.json)
curl -s "https://api.manifold.markets/v0/search-markets?sort=newest&limit=100&beforeTime=$BEFORE_TIME" > page2.json

Paginate Through Bets

# First page
curl -s "https://api.manifold.markets/v0/bets?contractId=MARKET_ID&limit=100" > bets1.json

# Next page: use ID of last bet
BEFORE=$(jq -r '.[-1].id' bets1.json)
curl -s "https://api.manifold.markets/v0/bets?contractId=MARKET_ID&limit=100&before=$BEFORE" > bets2.json

Send Mana to Users

curl -X POST "https://api.manifold.markets/v0/managram" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"toIds": ["USER_ID_1", "USER_ID_2"], "amount": 100, "message": "Thanks!"}'

Post a Comment

curl -X POST "https://api.manifold.markets/v0/comment" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contractId": "MARKET_ID", "markdown": "Great question! I think YES is undervalued."}'

WebSocket Subscription (Node.js)

const ws = new WebSocket("wss://api.manifold.markets/ws");
let txid = 0;

ws.onopen = () => {
  ws.send(JSON.stringify({
    type: "subscribe",
    txid: txid++,
    topics: ["global/new-bet"]
  }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (msg.type === "broadcast") {
    console.log("New bet:", msg.data);
  }
};

// Keep-alive ping every 30 seconds
setInterval(() => {
  ws.send(JSON.stringify({ type: "ping", txid: txid++ }));
}, 30000);

Usage Tips

  • All timestamps are UNIX milliseconds (JavaScript Date.now() style), not seconds.
  • Never hardcode API keys — use environment variables or secure key storage.
  • Market URLs always point to https://manifold.markets regardless of which API instance you're using. The username in the URL path doesn't need to be correct (e.g., manifold.markets/anyone/market-slug works).
  • GET parameters go in the query string. POST/PUT parameters go in the JSON body.
  • Limit orders with limitProb crossing the current market price will partially fill immediately. Any unfilled remainder stays as a resting limit order.
  • limitProb precision: Only whole percentage points (two decimal places, e.g., 0.01, 0.50, 0.99).
  • Multi-choice markets come in two flavors: dependent (shouldAnswersSumToOne=true, probabilities sum to 100%) and independent (each answer is effectively a separate binary market).
  • Combine REST + WebSocket for best results: use REST for initial state, WebSocket for real-time deltas.
  • Paginate responsibly: For /search-markets with sort=newest, use beforeTime for efficient deep pagination. For /bets and /markets, use cursor-based pagination with before/after.
  • Market token type matters: check the token field (MANA or CASH) to know if a market uses play-money or prize-cash.
  • Dry run bets by passing dryRun: true to simulate without placing.
  • Description formats: You can provide market descriptions as plain text (description), HTML (descriptionHtml), Markdown (descriptionMarkdown), or TipTap JSON (descriptionJson). Only provide one.

Error Handling

API responses are JSON. Successful requests return HTTP 200 with a JSON result. Error responses (4xx/5xx) return a JSON object with an error message.

Status Meaning
200 Success
400 Bad request (invalid parameters)
401 Unauthorized (missing or invalid API key)
403 Forbidden (insufficient permissions)
404 Not found
429 Rate limited (500 req/min exceeded)
5xx Server error

Implement retry with exponential backoff for 429 and 5xx responses.

Internal API

Manifold has some internal endpoints not part of the official API. These are undocumented and subject to change without notice.

Endpoint Method Auth Description
/unresolve POST Yes Unresolve a market. Param: contractId.

Note: Internal endpoints are not prefixed with /v0.

Versioning

The current API version is v0 under /v0/. The API is still in alpha. Monitor the official documentation and the Discord for breaking changes.

Weekly Installs
34
Repository
outsharp/shipp-skills
GitHub Stars
2
First Seen
Feb 18, 2026
Security Audits
Gen Agent Trust HubPass
SocketPass
SnykWarn
Installed on
codex33
opencode33
github-copilot31
kimi-cli31
gemini-cli31
amp31