Manifold

App · 21 actions

Trade on Manifold's play-money prediction markets: search markets and read their live probabilities, create, close and resolve markets, place and sell bets, comment, and send mana.

Actions

ActionWhat it does
Add answerAdd an answer to a multiple-choice market that allows it.
Add liquidityAdd mana to a market's liquidity pool, so each bet moves the probability less.
Add or remove topicTag a market with a topic, or take the tag off.
Cancel limit orderCancel what is still unfilled of a limit order.
Close marketStop trading on a market you created, now or at a time you set.
Create marketCreate a market.
Get marketRead one market in full: its question, probability (or each answer's), description, topics, volume and resolution.
Get market positionsList traders' positions in a market - their shares, what they invested and their profit - largest first.
Get market probabilityRead a market's probability right now, or each answer's on a multiple-choice market.
Get my accountRead the account the API key belongs to: its id, username and mana balance.
Get portfolioRead a user's live portfolio: mana balance, the value of their positions, loans and today's profit.
Get topicRead a topic by slug, id or link: its name, id and member count.
Get userRead a user's profile and mana balance by username, user id or profile link.
List betsList bets, newest first, on a market, by a user, or both - optionally only open limit orders or bets from a time window.
List commentsList a market's comments or a user's, as plain text, newest first.
Place betSpend mana on YES or NO shares, at the market price or as a limit order that waits for its price.
Post commentComment on a market, or reply to a comment, in Markdown.
Resolve marketResolve a market you created and pay out its traders: YES, NO, a probability, a number, the winning answer or answers, or N/A to cancel it and refund everyone.
Search marketsFind markets by words in the question, filtered by status, kind, topic and creator and sorted like Manifold's browse page.
Sell sharesSell YES or NO shares back to the market for mana - all of them, or a number you give.
Send manaSend mana to one or more users, the same amount to each, with an optional message.

Add answer

Add an answer to a multiple-choice market that allows it. Adding an answer costs mana.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.
AnswertexttextRequired
The answer, up to 240 characters.

Outputs

answer_idtext
market_idtext
texttext
Example output
{
  "answer_id": "Rdch85AdP5",
  "market_id": "5s6c88PRZA",
  "text": "No government formed"
}

Add liquidity

Add mana to a market's liquidity pool, so each bet moves the probability less. The mana is not returned.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.
AmountamountnumberRequired
The mana to add.
Answer IDanswer_idtext
Add it to this one answer's pool instead. Only some multiple-choice markets allow this.

Outputs

amountnumber
answer_idtext
created_timetext
idtext
market_idtext
Example output
{
  "amount": 100,
  "answer_id": null,
  "created_time": "2026-10-13T20:25:09.399Z",
  "id": "lp_1",
  "market_id": "5s6c88PRZA"
}

Add or remove topic

Tag a market with a topic, or take the tag off. You must have created the market to change a public topic's tags.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.
TopictopictextRequired
The topic's slug, id or link - the slug is the last part of its link, such as 'ai' in https://manifold.markets/topic/ai.
Removeremovetrue/false
Take the topic off instead of adding it.

Outputs

market_idtext
removedtrue/false
topic_idtext
topic_nametext
topic_slugtext
Example output
{
  "market_id": "5s6c88PRZA",
  "removed": false,
  "topic_id": "i5JOzjrK5ZMHPSkhgzoi",
  "topic_name": "Elections",
  "topic_slug": "elections"
}

Cancel limit order

Cancel what is still unfilled of a limit order. The filled part stays.

Inputs

Bet IDbet_idtextRequired
The limit order's id - the 'id' of a Place bet result.

Outputs

amountnumber
Mana spent so far
answer_idtext
created_timetext
expires_attext
idtext
is_cancelledtrue/false
is_filledtrue/false
limit_probabilitynumber
market_idtext
order_amountnumber
Mana ordered
outcometext
probability_afternumber
probability_beforenumber
sharesnumber
user_idtext
Example output
{
  "amount": 0,
  "answer_id": "Ep2RtUz2CN",
  "created_time": "2026-10-13T20:25:09.399Z",
  "expires_at": null,
  "id": "5lCIEchhc806",
  "is_cancelled": true,
  "is_filled": false,
  "limit_probability": 0.51,
  "market_id": "5s6c88PRZA",
  "order_amount": 15,
  "outcome": "YES",
  "probability_after": 0.5042,
  "probability_before": 0.5029,
  "shares": 29.79,
  "user_id": "6QbSCyAp99WD7OYN0Dsl8vpMHC82"
}

Close market

Stop trading on a market you created, now or at a time you set. A closed market still needs resolving.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.
Close timeclose_timedate and time
When to close it. Leave empty to close it now.

Outputs

close_timetext
market_idtext
Example output
{
  "close_time": "2026-10-13T12:00:00.000Z",
  "market_id": "5s6c88PRZA"
}

Create market

Create a market. It costs mana: a yes/no or numeric market costs its liquidity (M$100 at the smallest), a multiple-choice market that or M$25 an answer, whichever is more, a poll M$10 and a bounty question its bounty.

Inputs

QuestionquestiontextRequired
The headline question, up to 120 characters, such as 'Will it rain in London tomorrow?'
Market typemarket_typetext
Defaults to yes/no.One of: BINARY (Yes/no), MULTIPLE_CHOICE (Multiple choice), PSEUDO_NUMERIC (Numeric), POLL, BOUNTIED_QUESTION (Bounty question). Default: BINARY.
Descriptiondescriptiontext
How the market resolves, in Markdown. Say what counts as YES and where the answer will come from.
Close timeclose_timedate and time
When trading stops. Defaults to a week from now; must be in the future.
Liquidityliquidity_tiertext
The mana the market starts with, which is also what it costs. More liquidity moves less with each bet. Defaults to M$100.Only when Market type is Yes/no, Multiple choice or Numeric. One of: 100 (M$100), 1000 (M$1,000), 10000 (M$10,000), 100000 (M$100,000).
Visibilityvisibilitytext
Public markets appear in search and on the home page; unlisted ones only to people with the link. Defaults to public. Manifold creates unlisted markets only for accounts that have verified their identity, bought mana or subscribed; others get 'Please verify your identity to create unlisted markets'.One of: public, unlisted (Unlisted (only people with the link)).
Topicstopicslist
Up to 5 topics to tag the market with, by slug, id or link, such as 'ai'.
Initial probability (%)initial_probabilitynumber
Where the market starts, from 1 to 99. Defaults to 50.Only when Market type is Yes/no. From 1 to 99.
Answersanswerslist
The possible answers, up to 240 characters each. A poll needs at least two.Only when Market type is Multiple choice or Poll.
Only one answer can winanswers_sum_to_100true/false
On (the default): answers add up to 100% and one wins. Off: each answer resolves YES or NO on its own.Only when Market type is Multiple choice.
Who can add answersadd_answers_modetext
Who may add answers later. Defaults to no one.Only when Market type is Multiple choice. One of: DISABLED (No one), ONLY_CREATOR (Only me), ANYONE.
Minimummin_valuenumber
The lowest value the market can resolve to.Only when Market type is Numeric.
Maximummax_valuenumber
The highest value the market can resolve to.Only when Market type is Numeric.
Initial valueinitial_valuenumber
Where the market starts, between Minimum and Maximum.Only when Market type is Numeric.
Log scalelog_scaletrue/false
Spread the range exponentially, for values that span orders of magnitude.Only when Market type is Numeric.
Total bountytotal_bountynumber
The mana to pay out to the best answers, at least M$1,000.Only when Market type is Bounty question. At least 1000.

Outputs

answerslist
close_timetext
created_timetext
creator_idtext
creator_nametext
creator_usernametext
idtext
is_log_scaletrue/false
is_resolvedtrue/false
last_bet_timetext
last_comment_timetext
last_updated_timetext
maxnumber
mechanismtext
minnumber
outcome_typetext
probabilitynumber
From 0 to 1; empty for a multiple-choice market
questiontext
resolutiontext
resolution_probabilitynumber
resolution_timetext
slugtext
tokentext
total_liquiditynumber
unique_bettor_countnumber
urltext
valuenumber
A numeric market's current value
volumenumber
volume_24_hoursnumber
Example output
{
  "answers": [],
  "close_time": "2027-01-02T07:59:00.000Z",
  "created_time": "2024-01-18T00:11:41.985Z",
  "creator_id": "AHf5jynaHbNiNiwoYx1UfhRMq3Q2",
  "creator_name": "Matthew Barnett",
  "creator_username": "MatthewBarnett",
  "id": "X6Cn5ebU5ugo5DF9K4Ps",
  "is_log_scale": false,
  "is_resolved": false,
  "last_bet_time": "2026-10-13T07:05:06.153Z",
  "last_comment_time": "2026-10-13T06:05:33.983Z",
  "last_updated_time": "2026-10-13T07:05:06.153Z",
  "max": null,
  "mechanism": "cpmm-1",
  "min": null,
  "outcome_type": "BINARY",
  "probability": 0.9828795923833469,
  "question": "Will AIs beat human experts on the GPQA benchmark before 2027?",
  "resolution": null,
  "resolution_probability": null,
  "resolution_time": null,
  "slug": "will-ais-beat-human-experts-in-ques",
  "token": "MANA",
  "total_liquidity": 1000,
  "unique_bettor_count": 34,
  "url": "https://manifold.markets/MatthewBarnett/will-ais-beat-human-experts-in-ques",
  "value": null,
  "volume": 9765.46,
  "volume_24_hours": 5001
}

Get market

Read one market in full: its question, probability (or each answer's), description, topics, volume and resolution.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.

Outputs

add_answers_modetext
answerslist
bounty_leftnumber
close_timetext
cover_image_urltext
created_timetext
creator_idtext
creator_nametext
creator_usernametext
descriptiontext
idtext
is_log_scaletrue/false
is_resolvedtrue/false
last_bet_timetext
last_comment_timetext
last_updated_timetext
maxnumber
mechanismtext
minnumber
outcome_typetext
poll_optionslist
probabilitynumber
From 0 to 1; empty for a multiple-choice market
questiontext
resolutiontext
resolution_probabilitynumber
resolution_timetext
should_answers_sum_to_onetrue/false
slugtext
tokentext
topicslist
The slugs of the market's topics
total_bountynumber
total_liquiditynumber
unique_bettor_countnumber
urltext
valuenumber
A numeric market's current value
volumenumber
volume_24_hoursnumber
Example output
{
  "add_answers_mode": "ONLY_CREATOR",
  "answers": [
    {
      "id": "5t00sl6Egq",
      "index": 0,
      "is_other": false,
      "probability": 0.487878192328553,
      "resolution": null,
      "text": "National coalition"
    },
    {
      "id": "Ep2RtUz2CN",
      "index": 1,
      "is_other": false,
      "probability": 0.5041948490276267,
      "resolution": null,
      "text": "Labour coalition"
    }
  ],
  "bounty_left": null,
  "close_time": "2026-10-16T23:59:00.000Z",
  "cover_image_url": null,
  "created_time": "2026-01-02T02:49:42.760Z",
  "creator_id": "fSrex43BDjeneNZ4ZLfxllSb8b42",
  "creator_name": "N.C. Young",
  "creator_username": "NcyRocks",
  "description": "Resolves to the first government formed after the election.",
  "id": "5s6c88PRZA",
  "is_log_scale": false,
  "is_resolved": false,
  "last_bet_time": "2026-10-13T20:25:09.399Z",
  "last_comment_time": null,
  "last_updated_time": "2026-10-13T20:25:09.399Z",
  "max": null,
  "mechanism": "cpmm-multi-1",
  "min": null,
  "outcome_type": "MULTIPLE_CHOICE",
  "poll_options": [],
  "probability": null,
  "question": "What will be the outcome of the 2026 New Zealand General Election?",
  "resolution": null,
  "resolution_probability": null,
  "resolution_time": null,
  "should_answers_sum_to_one": true,
  "slug": "what-will-be-the-outcome-of-the-202-ZUpIRANOpQ",
  "token": "MANA",
  "topics": [
    "elections",
    "new-zealand"
  ],
  "total_bounty": null,
  "total_liquidity": 10000,
  "unique_bettor_count": 42,
  "url": "https://manifold.markets/NcyRocks/what-will-be-the-outcome-of-the-202-ZUpIRANOpQ",
  "value": null,
  "volume": 58064.24,
  "volume_24_hours": 3289.76
}

Get market positions

List traders' positions in a market - their shares, what they invested and their profit - largest first.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.
Order byordertext
Rank positions by profit (the default) or shares.One of: profit, shares.
Toptopnumber
Return this many of the highest-ranked positions.From 1 to 1000.
Bottombottomnumber
Return this many of the lowest-ranked positions.From 1 to 1000.
Userusertext
Only this user's position: a username, user id or profile link.
Answer IDanswer_idtext
For a multiple-choice market, the answer's id - the 'id' of one of Get market's answers.

Outputs

countnumber
market_idtext
positionslist
Example output
{
  "count": 1,
  "market_id": "5s6c88PRZA",
  "positions": [
    {
      "answer_id": null,
      "invested": 9481.86,
      "last_bet_time": "2026-01-02T02:58:50.472Z",
      "loan": 1290.1,
      "market_id": "5s6c88PRZA",
      "no_shares": 10060.29,
      "outcome": "NO",
      "payout": 11455.67,
      "profit": 1973.8,
      "profit_percent": 20.82,
      "user_id": "fSrex43BDjeneNZ4ZLfxllSb8b42",
      "user_name": "N.C. Young",
      "user_username": "NcyRocks",
      "yes_shares": 3222.36
    }
  ]
}

Get market probability

Read a market's probability right now, or each answer's on a multiple-choice market. Fresher than Get market, and lighter.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.

Outputs

answer_probabilitiesobject
Each answer's id and its probability, from 0 to 1
market_idtext
probabilitynumber
From 0 to 1; empty for a multiple-choice market
Example output
{
  "answer_probabilities": {
    "5t00sl6Egq": 0.4879,
    "Ep2RtUz2CN": 0.5042
  },
  "market_id": "5s6c88PRZA",
  "probability": null
}

Get my account

Read the account the API key belongs to: its id, username and mana balance.

Inputs

None.

Outputs

avatar_urltext
balancenumber
Mana balance
biotext
created_timetext
current_betting_streaknumber
discord_handletext
idtext
is_admintrue/false
is_banned_from_postingtrue/false
is_bottrue/false
is_deletedtrue/false
is_moderatortrue/false
last_bet_timetext
nametext
total_depositsnumber
twitter_handletext
urltext
usernametext
websitetext
Example output
{
  "avatar_url": "https://example.com/avatar.png",
  "balance": 9122.6,
  "bio": "I build Manifold!",
  "created_time": "2021-12-09T01:02:47.273Z",
  "current_betting_streak": 3,
  "discord_handle": "akrolsmir",
  "id": "igi2zGXsfxYPgB0DJTXVJVmwCOr2",
  "is_admin": false,
  "is_banned_from_posting": false,
  "is_bot": false,
  "is_deleted": false,
  "is_moderator": false,
  "last_bet_time": "2026-09-30T00:35:19.647Z",
  "name": "Austin",
  "total_deposits": 10339.0,
  "twitter_handle": "akrolsmir",
  "url": "https://manifold.markets/Austin",
  "username": "Austin",
  "website": "https://blog.austn.io"
}

Get portfolio

Read a user's live portfolio: mana balance, the value of their positions, loans and today's profit. Leave User empty for your own.

Inputs

Userusertext
A username, user id or profile link. Leave empty for the connected account.

Outputs

as_oftext
balancenumber
daily_profitnumber
investment_valuenumber
loan_totalnumber
profitnumber
total_depositsnumber
user_idtext
Example output
{
  "as_of": "2026-10-13T21:37:17.737Z",
  "balance": 167200.48,
  "daily_profit": 42.02,
  "investment_value": 48440.66,
  "loan_total": 17185.34,
  "profit": null,
  "total_deposits": 176064.79,
  "user_id": "igi2zGXsfxYPgB0DJTXVJVmwCOr2"
}

Get topic

Read a topic by slug, id or link: its name, id and member count.

Inputs

TopictopictextRequired
The topic's slug, id or link - the slug is the last part of its link, such as 'ai' in https://manifold.markets/topic/ai.

Outputs

abouttext
created_timetext
creator_idtext
idtext
nametext
privacy_statustext
slugtext
total_membersnumber
urltext
Example output
{
  "about": null,
  "created_time": "2023-03-30T21:31:00.382Z",
  "creator_id": "ZqQWFwIip5ga2Revf9WnaWU5Kmi2",
  "id": "i5JOzjrK5ZMHPSkhgzoi",
  "name": "Elections",
  "privacy_status": "public",
  "slug": "elections",
  "total_members": 1995,
  "url": "https://manifold.markets/topic/elections"
}

Get user

Read a user's profile and mana balance by username, user id or profile link.

Inputs

UserusertextRequired
A username (as in manifold.markets/Austin), a user id, or a profile link.

Outputs

avatar_urltext
balancenumber
Mana balance
biotext
created_timetext
current_betting_streaknumber
discord_handletext
idtext
is_admintrue/false
is_banned_from_postingtrue/false
is_bottrue/false
is_deletedtrue/false
is_moderatortrue/false
last_bet_timetext
nametext
total_depositsnumber
twitter_handletext
urltext
usernametext
websitetext
Example output
{
  "avatar_url": "https://example.com/avatar.png",
  "balance": 9122.6,
  "bio": "I build Manifold!",
  "created_time": "2021-12-09T01:02:47.273Z",
  "current_betting_streak": 3,
  "discord_handle": "akrolsmir",
  "id": "igi2zGXsfxYPgB0DJTXVJVmwCOr2",
  "is_admin": false,
  "is_banned_from_posting": false,
  "is_bot": false,
  "is_deleted": false,
  "is_moderator": false,
  "last_bet_time": "2026-09-30T00:35:19.647Z",
  "name": "Austin",
  "total_deposits": 10339.0,
  "twitter_handle": "akrolsmir",
  "url": "https://manifold.markets/Austin",
  "username": "Austin",
  "website": "https://blog.austn.io"
}

List bets

List bets, newest first, on a market, by a user, or both - optionally only open limit orders or bets from a time window.

Inputs

Marketmarkettext
Only this market: its id, slug or link.
Userusertext
Only this user: a username, user id or profile link.
Answer IDanswer_idtext
For a multiple-choice market, the answer's id - the 'id' of one of Get market's answers.
Open limit orders onlyopen_limit_orders_onlytrue/false
Only limit orders that are still waiting to fill.
Afterafter_timedate and time
Only bets placed after this time.
Beforebefore_timedate and time
Only bets placed before this time.
Orderordertext
Defaults to newest first.One of: desc (Newest first), asc (Oldest first).
Limitlimitnumber
How many to return, up to 1,000.From 1 to 1000.
Before bet IDbeforetext
For the next page: the 'id' of the last bet of the previous one.

Outputs

betslist
The matching bets
countnumber
Example output
{
  "bets": [
    {
      "amount": 15,
      "answer_id": "Ep2RtUz2CN",
      "created_time": "2026-10-13T20:25:09.399Z",
      "expires_at": null,
      "id": "5lCIEchhc806",
      "is_cancelled": false,
      "is_filled": true,
      "limit_probability": 0.51,
      "market_id": "5s6c88PRZA",
      "order_amount": 15,
      "outcome": "YES",
      "probability_after": 0.5042,
      "probability_before": 0.5029,
      "shares": 29.79,
      "user_id": "6QbSCyAp99WD7OYN0Dsl8vpMHC82"
    }
  ],
  "count": 1
}

List comments

List a market's comments or a user's, as plain text, newest first.

Inputs

Marketmarkettext
The market whose comments to list: its id, slug or link. Give this, a User, or both.
Userusertext
Only this user's comments: a username, user id or profile link.
Orderordertext
Defaults to newest first.One of: newest (Newest first), oldest (Oldest first), likes (Most liked).
Limitlimitnumber
How many to return, up to 1,000.From 1 to 1000.
Pagepagenumber
Which page of Limit comments, starting at 0.At least 0.

Outputs

commentslist
The comments, as plain text
countnumber
Example output
{
  "comments": [
    {
      "created_time": "2026-10-12T21:47:01.503Z",
      "id": "j333hxsz3p",
      "likes": 2,
      "market_id": "5s6c88PRZA",
      "market_question": "What will be the outcome of the 2026 New Zealand General Election?",
      "market_slug": "what-will-be-the-outcome-of-the-202-ZUpIRANOpQ",
      "reply_to_comment_id": null,
      "text": "Polls have tightened.",
      "user_id": "j3qXHWAZS4b37tlcY3u22l1D1qF3",
      "user_name": "Jack",
      "user_username": "Jack1"
    }
  ],
  "count": 1
}

Place bet

Spend mana on YES or NO shares, at the market price or as a limit order that waits for its price. Use Dry run to preview the shares and new probability without betting.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.
AmountamountnumberRequired
The mana to spend, at least M$1.At least 1.
Outcomeoutcometext
Buy YES or NO shares. On a multiple-choice market, of the answer.One of: YES, NO. Default: YES.
Answer IDanswer_idtext
Required on a multiple-choice market: the answer to bet on, from Get market's answers.
Limit probability (%)limit_probabilitynumber
Make it a limit order at this whole percent, from 1 to 99: it fills only at this price or better, and the rest waits for later bets.From 1 to 99.
Expires atexpires_atdate and time
For a limit order: when to cancel what is still unfilled.
Dry rundry_runtrue/false
Simulate the bet without placing it.

Outputs

amountnumber
Mana spent so far
answer_idtext
created_timetext
expires_attext
idtext
is_cancelledtrue/false
is_filledtrue/false
limit_probabilitynumber
market_idtext
order_amountnumber
Mana ordered
outcometext
probability_afternumber
probability_beforenumber
sharesnumber
user_idtext
Example output
{
  "amount": 15,
  "answer_id": "Ep2RtUz2CN",
  "created_time": "2026-10-13T20:25:09.399Z",
  "expires_at": null,
  "id": "5lCIEchhc806",
  "is_cancelled": false,
  "is_filled": true,
  "limit_probability": 0.51,
  "market_id": "5s6c88PRZA",
  "order_amount": 15,
  "outcome": "YES",
  "probability_after": 0.5042,
  "probability_before": 0.5029,
  "shares": 29.79,
  "user_id": "6QbSCyAp99WD7OYN0Dsl8vpMHC82"
}

Post comment

Comment on a market, or reply to a comment, in Markdown. Manifold charges M$1 for each comment posted through its API.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.
CommenttexttextRequired
The comment, in Markdown, up to 10,000 characters.
Reply to comment IDreply_to_comment_idtext
Reply to this comment on the same market.

Outputs

created_timetext
idtext
likesnumber
market_idtext
market_questiontext
market_slugtext
reply_to_comment_idtext
texttext
user_idtext
user_nametext
user_usernametext
Example output
{
  "created_time": "2026-10-12T21:47:01.503Z",
  "id": "j333hxsz3p",
  "likes": 2,
  "market_id": "5s6c88PRZA",
  "market_question": "What will be the outcome of the 2026 New Zealand General Election?",
  "market_slug": "what-will-be-the-outcome-of-the-202-ZUpIRANOpQ",
  "reply_to_comment_id": null,
  "text": "Polls have tightened.",
  "user_id": "j3qXHWAZS4b37tlcY3u22l1D1qF3",
  "user_name": "Jack",
  "user_username": "Jack1"
}

Resolve market

Resolve a market you created and pay out its traders: YES, NO, a probability, a number, the winning answer or answers, or N/A to cancel it and refund everyone.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.
OutcomeoutcometextRequired
Yes/no markets resolve Yes, No or to a probability; numeric markets to a number; multiple-choice markets to one answer or a split. Any market can resolve N/A.One of: YES, NO, PROB (A probability), NUMBER (A number (numeric market)), CHOOSE_ONE (One answer wins (multiple choice)), CHOOSE_MULTIPLE (Split between answers (multiple choice)), CANCEL (N/A (cancel and refund every trade)).
Answer IDanswer_idtext
With 'One answer wins', the winning answer. With Yes, No or a probability on a market whose answers resolve separately, the answer to resolve.Only when Outcome is Yes, No, A probability or One answer wins (multiple choice).
Probability (%)probabilitynumber
The probability to pay out at, from 0 to 100.Only when Outcome is A probability. From 0 to 100.
Valuevaluenumber
The number the market resolves to, within its range.Only when Outcome is A number (numeric market).
Answer percentagesanswer_percentagesobject
Each winning answer's id and its share of the payout in percent. The shares must add up to 100.Only when Outcome is Split between answers (multiple choice).

Outputs

answer_idtext
market_idtext
messagetext
outcometext
Example output
{
  "answer_id": "5t00sl6Egq",
  "market_id": "5s6c88PRZA",
  "message": "success",
  "outcome": "CHOOSE_ONE"
}

Search markets

Find markets by words in the question, filtered by status, kind, topic and creator and sorted like Manifold's browse page. Multiple-choice markets include each answer's probability.

Inputs

Searchtermtext
Words to find. Leave empty to browse.
Sortsorttext
Defaults to best match.One of: score (Best match), most-popular (Most popular), newest, 24-hour-vol (Most traded in 24 hours), liquidity (Most liquidity), last-updated (Recently updated), close-date (Close date), resolve-date (Resolve date), prob-descending (Highest probability), prob-ascending (Lowest probability).
Statusstatustext
Open, closed, resolved or closing soon. Defaults to any.One of: all (Any), open, closed, resolved, closing-day (Closing within a day), closing-week (Closing within a week), closing-month (Closing within a month), closing-90-days (Closing within 90 days).
Market typemarket_typetext
Defaults to any.One of: ALL (Any), BINARY (Yes/no), MULTIPLE_CHOICE (Multiple choice), DEPENDENT_MULTIPLE_CHOICE (Multiple choice, one answer wins), INDEPENDENT_MULTIPLE_CHOICE (Multiple choice, answers resolve separately), PSEUDO_NUMERIC (Numeric), POLL, BOUNTIED_QUESTION (Bounty question).
Topictopictext
Only markets in this topic: its slug, id or link.
Creatorcreatortext
Only markets this user created: a username, user id or profile link.
Limitlimitnumber
How many to return, up to 1,000. Defaults to 100.From 1 to 1000.
Offsetoffsetnumber
How many results to skip, for the next page.From 0 to 1000.

Outputs

countnumber
marketslist
The matching markets
Example output
{
  "count": 2,
  "markets": [
    {
      "answers": [],
      "close_time": "2027-01-02T07:59:00.000Z",
      "created_time": "2024-01-18T00:11:41.985Z",
      "creator_id": "AHf5jynaHbNiNiwoYx1UfhRMq3Q2",
      "creator_name": "Matthew Barnett",
      "creator_username": "MatthewBarnett",
      "id": "X6Cn5ebU5ugo5DF9K4Ps",
      "is_log_scale": false,
      "is_resolved": false,
      "last_bet_time": "2026-10-13T07:05:06.153Z",
      "last_comment_time": "2026-10-13T06:05:33.983Z",
      "last_updated_time": "2026-10-13T07:05:06.153Z",
      "max": null,
      "mechanism": "cpmm-1",
      "min": null,
      "outcome_type": "BINARY",
      "probability": 0.9828795923833469,
      "question": "Will AIs beat human experts on the GPQA benchmark before 2027?",
      "resolution": null,
      "resolution_probability": null,
      "resolution_time": null,
      "slug": "will-ais-beat-human-experts-in-ques",
      "token": "MANA",
      "total_liquidity": 1000,
      "unique_bettor_count": 34,
      "url": "https://manifold.markets/MatthewBarnett/will-ais-beat-human-experts-in-ques",
      "value": null,
      "volume": 9765.46,
      "volume_24_hours": 5001
    },
    {
      "answers": [
        {
          "id": "5t00sl6Egq",
          "index": 0,
          "is_other": false,
          "probability": 0.487878192328553,
          "resolution": null,
          "text": "National coalition"
        },
        {
          "id": "Ep2RtUz2CN",
          "index": 1,
          "is_other": false,
          "probability": 0.5041948490276267,
          "resolution": null,
          "text": "Labour coalition"
        }
      ],
      "close_time": "2026-10-16T23:59:00.000Z",
      "created_time": "2026-01-02T02:49:42.760Z",
      "creator_id": "fSrex43BDjeneNZ4ZLfxllSb8b42",
      "creator_name": "N.C. Young",
      "creator_username": "NcyRocks",
      "id": "5s6c88PRZA",
      "is_log_scale": false,
      "is_resolved": false,
      "last_bet_time": "2026-10-13T20:25:09.399Z",
      "last_comment_time": null,
      "last_updated_time": "2026-10-13T20:25:09.399Z",
      "max": null,
      "mechanism": "cpmm-multi-1",
      "min": null,
      "outcome_type": "MULTIPLE_CHOICE",
      "probability": null,
      "question": "What will be the outcome of the 2026 New Zealand General Election?",
      "resolution": null,
      "resolution_probability": null,
      "resolution_time": null,
      "slug": "what-will-be-the-outcome-of-the-202-ZUpIRANOpQ",
      "token": "MANA",
      "total_liquidity": 10000,
      "unique_bettor_count": 42,
      "url": "https://manifold.markets/NcyRocks/what-will-be-the-outcome-of-the-202-ZUpIRANOpQ",
      "value": null,
      "volume": 58064.24,
      "volume_24_hours": 3289.76
    }
  ]
}

Sell shares

Sell YES or NO shares back to the market for mana - all of them, or a number you give.

Inputs

MarketmarkettextRequired
The market's id, slug or link, such as https://manifold.markets/Austin/will-it-rain. Search markets returns ids.
OutcomeoutcometextRequired
Which shares to sell, YES or NO.One of: YES, NO.
Sharessharesnumber
How many shares to sell. Leave empty to sell them all.
Answer IDanswer_idtext
Required on a multiple-choice market: the answer whose shares to sell.

Outputs

amountnumber
Mana spent so far
answer_idtext
created_timetext
expires_attext
idtext
is_cancelledtrue/false
is_filledtrue/false
limit_probabilitynumber
market_idtext
order_amountnumber
Mana ordered
outcometext
probability_afternumber
probability_beforenumber
sharesnumber
user_idtext
Example output
{
  "amount": -14.2,
  "answer_id": "Ep2RtUz2CN",
  "created_time": "2026-10-13T20:25:09.399Z",
  "expires_at": null,
  "id": "5lCIEchhc806",
  "is_cancelled": false,
  "is_filled": true,
  "limit_probability": null,
  "market_id": "5s6c88PRZA",
  "order_amount": 15,
  "outcome": "YES",
  "probability_after": 0.5042,
  "probability_before": 0.5029,
  "shares": -29.79,
  "user_id": "6QbSCyAp99WD7OYN0Dsl8vpMHC82"
}

Send mana

Send mana to one or more users, the same amount to each, with an optional message. At least M$10 each; you cannot send to yourself.

Inputs

RecipientsrecipientslistRequired
Usernames, user ids or profile links.
AmountamountnumberRequired
The mana each recipient gets, at least M$10.At least 10.
Messagemessagetext
A note the recipients see with the mana.

Outputs

amountnumber
Mana sent to each recipient
messagetext
recipient_idslist
totalnumber
Example output
{
  "amount": 25,
  "message": "Thanks for the forecast!",
  "recipient_ids": [
    "igi2zGXsfxYPgB0DJTXVJVmwCOr2"
  ],
  "total": 25
}

On this page