Manifold Markets is a social prediction market platform where users trade probabilities on real-world questions. Its public REST API makes it easy to build bots, dashboards and automation workflows around the market data and user bets.
Manifold Markets API
The manifold markets API is the programmatic gateway to the world’s most active social prediction platform. It has become a vital resource for researchers and traders who want to bypass the tough web interfaces and interact with the market directly.
It is a RESTful, HTTPS-first API hosted at the dedicated domain api.manifold.markets. This ensures that all data transmissions are encrypted and secure.
The API returns responses in JSON format, the industry standard for web development. This allows you to easily fetch data regarding:
Markets: Current odds, descriptions, and resolution statuses.
Users: Portfolio balances (in Mana) and betting track records.
Groups: Market categories and community-led initiatives.
Bets: Real-time trade volume and individual position changes.
Official Manifold API Docs
The manifold markets API documentation is the primary resource for understanding the rules of the road.
The canonical manifold API documentation: https://docs.manifold.markets/api
The documentation hub is designed to be highly practical, offering more than just a list of names.
Full Endpoint Directory
Detailed guides for every available path, such as:
- GET/v0/markets: To pull a list of all active predictions.
- GET/v0/bets: To monitor the latest trading activity.
- GET/v0/market/[marketId]: To get deep-dive stats on a single specific market.
Request & Response Shapes
Clear examples of what the JSON data looks like when it leaves the server and arrives at your app.
Interactive Code Snippets
Ready to use curl commands that you can copy and paste into your terminal to test the connection immediately.
How To Get A Manifold Markets API Key
Permission is needed for your code before it can create a market or place a bet. This is handled via an API key, which acts as your digital signature on the platform.
Step-by-Step Guide
- Log In: Go to https://docs.manifold.markets/
- Navigate to Settings: Click on the user profile icon in the sidebar or top navigation, then select account settings (or your profile name).
- Locate the API Section: Scroll down until you find the API key section.
- Generate The Key: Click the “Refresh” or “Create API Key” button. This will generate a long string of characters (your long-lived key).
- Copy & Save: Copy the key immediately. For security reasons, the full key may only be displayed once before it is partially masked.
Note:
Treat your API like a password. Anyone with access to this key can spend your Mana and resolve your markets.
- Never hard-code your key directly into your source code.
- Always store it in environment variables (e.g., MANIFOLD_API_KEY) or a .env file that is excluded from your version control (like Git).
- Use a Secrets Manager if you are deploying your bot to the cloud.
Understanding The /bets Endpoints
The /bet endpoints provide the granular history of every trade. Allowing you to see exactly how and when a market moved.
/v0/bets Endpoints
As per the manifold market’s public API documentation the /v0/bets endpoints is a GET request. Depending on the parameters you use, it returns a list of bets placed on the platform.
Performance Analytics
Pulling your own trade history to calculate your calibration.
Trading Bots
Building a script that monitors a specific market and reacts instantly when a whale makes a move.
Sentiment Tracking
Aggregate data to see if the crowd is becoming more or less confident over time.
Example Request Snippet
To fetch your most recent trades, you would use a standard curl command. Note how you must include your manifold markets API key in the header for authenticated requests.
| Bash |
| curl “https://api.manifold.markets/v0/bets?userId=YOUR_USER_ID” \ -H “Authorization: Key {your_api_key}” |
Understanding The Response
When you query the manifold markets API documentation bets endpoints, the server returns a JSON object. If you are building a manifold markets API integration service, your code will need to parse these specific fields:
- marketID: The unique identifier for the prediction market.
- Amount: The total Mana (M) spent on the bet.
- Outcome: Usually Yes or No (or specific options in a multiple-choice market).
- probBefore & probAfter: The probability of the event before and after the bet was placed. This is crucial for calculating market impact.
- Timestamp: Exactly when the trade occurred.
Building A Simple Integration (Code-Light Example)
Setting up a Manifold markets API integration service is remarkably straightforward, whether you are a developer or a no-code enthusiast.
Developer Approach (Python + Requests)
Using the Manifold Markets public API documentation as a guide, you can write a script in under 10 lines to pull your data. This is perfect for those who want to feed market odds into an AI model or a private database.
| Python |
| import requests
import os # Securely load your Manifold markets API key API_KEY = os.getenv(“MANIFOLD_API_KEY”) BASE_URL = “https://api.manifold.markets/v0” HEADERS = {“Authorization”: f”Key {API_KEY}”} # 1. Fetch all active markets markets = requests.get(f”{BASE_URL}/markets”, headers=HEADERS).json() print(f”Found {len(markets)} active markets!”) # 2. Use the manifold markets api documentation bets endpoint # Fetch the most recent bets for your account bets = requests.get(f”{BASE_URL}/bets”, headers=HEADERS).json() |
The No Code Approach (Zapier, Make, or n8n)
If you aren’t a programmer, you can still build a powerful Manifold Markets API integration service using automation tools.
Flow: Set up a scheduled trigger in a tool like Make or Zapier.
Action: Direct the tool to call the GET/v0/markets or GET/v0/bets endpoint.
Destination: Send that data directly into a Google Sheets or Airtable.
This allows you to create a live dashboard that tracks your P&L, charts market volatility, or sends you a text message whenever a specific market moves more than 5% in an hour.
API As A Service
Demand for customer connector apps is growing rapidly in the manifold markets API documentation 2026 landscape. If you can build a clean bridge between Manifold’s data and a business tool like Slack or Microsoft Teams.
You’re essentially providing a high-value Manifold Markets API integration service that traders and researchers are willing to pay for.
Handling Rate Limit & Security
Manifold typically allows 500 requests per minute. To avoid being throttled:
Use Caching: Don’t request the same market data every second. Cache results for 15-30 seconds.
Exponential Backoff: If you receive a 429 Too Many Requests error, program your script to wait before trying again.
Key Rotation: If you are building a Manifold Markets API integration service for a client, remind them to refresh their Manifold Markets API key every 90 days for better security.
Conclusion
The manifold markets API is the ultimate gateway to real-time social forecasting. By leveraging the manifold markets public API documentation, you can quickly transition from manual to automated trading mastery. Whether you are deep diving into the manifold markets API documentation bets endpoint for data analysis or launching a custom manifold markets API integration service the tools are ready for you.
FAQ
Is there a cost to use the Manifold Markets public API documentation or tools?
Accessing the manifold markets public API documentation and reading data is completely free. However, while there are no per-request fees, Manifold has introduced tiered memberships. These tiers offer different monthly Mana (Ṁ) stipends and increase rate limits for heavy users of any Manifold Markets API integration service.
Can I withdraw my Mana earnings as cash through the API?
As outlined in the manifold market API documentation 2026 guidelines, Mana (Ṁ) is a play money currency and cannot be redeemed for real world cash or crypto currency. This social only model is what allow the API to remain open and accessible globally without the strict KYC requirements found on real exchange money platforms.
Does the manifold markets API documentation bets endpoint support limit orders?
The manifold markets API documentation bets endpoint allows you to programmatically place limit orders (bids). This means your manifold markets API key can be used to set a specific probability at which you’re willing to buy or sell, allowing your bot to provide liquidity and trade more efficiently than manual users.
How does the API handle multiple choice or numeric market resolutions?
While binary (Yes/No) markets are the standard, the manifold markets public API documentation includes specific schemas for multi outcome and numeric markets. When fetching your data, your integration must parse the outcomeType field.
