# Prediction market API

Market odds for your agent, paid per call.

Let your agent search Polymarket for live odds, or check the same question on Polymarket, Kalshi and Limitless.

The Polymarket search and the three-venue search were each tested once with the same question. The Kalshi markets tool is priced here but was not run in our test.

Provider in the worked example: Otto.

Price shown for this route: 0.1¢ per search.



## What it can do

### Polymarket search

Open markets matching a question. Our test returned ten markets with odds, bid and ask, spread, volume and liquidity.

Price: $0.001 / search.

### Three-venue search

One search across Polymarket, Kalshi and Limitless. Our test returned 11 markets, each tagged with its venue.

Price: $0.012 / search.

### Kalshi markets

Browse Kalshi markets by status, event or ticker.

Price: $0.0025 / request.


## A real example

Tested on 2026-10-30 through Otto.

We searched Polymarket for the Fed rate cut question. Otto returned ten open markets with live odds, spread and volume.

Your agent asked: Find the odds of a Fed rate cut on Polymarket

Returned in this test:

- Markets returned: 10 open markets
- Top match: Will no Fed rate cuts happen in 2026?
- Yes odds on the top match: 96.4%
- Per market: Odds, bid and ask, spread, volume, liquidity, end date, link
- Open the event: polymarket.com/event/how-many-fed-rate-cuts-in-2026

Charged in this test: $0.001.

One search of open Polymarket markets. Odds change by the minute.


## Try the API request

Use your TaskFuel API key as TASKFUEL_API_KEY in your terminal or server. Keep it out of browser code.

### 1. Check the price

This request checks the price without paying. This is the exact market search from the test. Odds move constantly, so a new search returns different numbers.

```sh
curl --fail-with-body https://app.taskfuel.ai/v1/call \
  -H "Authorization: Bearer $TASKFUEL_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'TASKFUEL_REQUEST'
{
  "url": "https://x402.ottoai.services/pm-search?query=fed%20rate%20cut",
  "method": "GET",
  "dryRun": true
}
TASKFUEL_REQUEST
```

### 2. Run the request

Review amount_usd in the quote. To pay and run, change dryRun to false and add maxAmountUsd with that approved amount inside the same JSON object. Keep the inputs unchanged; this limit applies to one call.

### 3. Read the result

Read data.markets[]: question, outcomes[].probability, bestBid, bestAsk, spread, volumeTotalUsd, endDate and url. The odds are current market prices, not a forecast of what will happen.



[Setup and API reference](https://taskfuel.ai/docs/) · [Job polling and timeout recovery](https://app.taskfuel.ai/using.md)


## Connect your agent

Read the [setup guide](https://taskfuel.ai/docs/setup/) and choose the connection your agent supports.

Use one TaskFuel account and prepaid balance. Inspect the provider and request quote before a paid call, then review the returned response and recorded charge.



## When to use it

### Read the odds behind a headline.

Search a question such as a Fed rate cut and read the probability, spread and volume.

### Find the same question on three venues.

A three-venue search tags each hit with its venue. Kalshi’s yes and no prices can add up to more than 1.

### Link to the market itself.

Each result carries a link to its venue page, so an agent can give the reader the original market.




## Questions

### Do I need a Polymarket or Kalshi account?

No. Your agent pays from your TaskFuel balance, so there is nothing else to sign up for.

### What does a prediction market API cost here?

Our Polymarket search cost $0.001 and a three-venue search cost $0.012 on 30 October 2026. Your agent shows the price for your own request before it pays.

### Which markets does it cover?

The Polymarket search covers open Polymarket markets. The three-venue search covers Polymarket, Kalshi and Limitless Exchange.

### Are the odds live?

They are a snapshot from the moment of the call.

### Can this place trades?

No. These tools read market data. Trading and wallet actions are not included.

## Related tool guides

- [Compare Polymarket MCP options](https://taskfuel.ai/tools/polymarket-mcp/)
- [Read crypto market data next to the odds](https://taskfuel.ai/tools/crypto-market-data/)
- [Compare Finnhub alternatives for stock data](https://taskfuel.ai/tools/finnhub-alternative/)
- [Read the posts around a market](https://taskfuel.ai/tools/twitter-scraper-api/)


## Reference

- [Read this guide on the website](https://taskfuel.ai/tools/prediction-market-api/).
- [Browse providers and capabilities](https://taskfuel.ai/catalog/).
- [Pricing](https://taskfuel.ai/pricing/).
- [Agent instructions](https://taskfuel.ai/llms.txt).
