ToolVet
80trust / 100

Prediction Scan

by api.seerium.xyz in Markets & finance

x402 APIPassing, checked 51 min ago

Polymarket API and prediction market API for agents. Returns prediction market signals, market snapshots, order books, and ranked opportunities.

GET https://api.seerium.xyz/v1/prediction/scan

Last 30 days

All checks passedSome failedAll failedNot checked

Status and outage history · Atom feed

Uptime
100%
Response time
192 ms typical, 368 ms slowest 5%
Last check
51 min ago
Next check
any minute now

How to call it

GET https://api.seerium.xyz/v1/prediction/scan

Each call costs $0.1 in USDC on Base, paid with the request over x402.

Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.

Example request

From the listing.

GET https://api.seerium.xyz/v1/prediction/scan?limitOpportunities=10&limitSnapshots=10

Parameters

ParameterTypeRequiredDescription
limitOpportunitiesnumberNoOptional maximum prediction-market opportunities to return.
limitSnapshotsnumberNoOptional maximum Polymarket prediction-market snapshots to return.

Example response

The provider's example. We can't check it without paying.

Example response, 217 lines
{
  "data": {
    "allowShort": false,
    "markets": 745,
    "opportunities": 1,
    "opportunityList": [
      {
        "description": "Polymarket opportunity from cached market snapshots and order book spread.",
        "edge": 0.035,
        "legs": [
          {
            "marketSlug": "us-x-iran-permanent-peace-deal-by-may-31-2026",
            "outcome": "Yes",
            "price": 0.49,
            "reason": "spread and liquidity screen passed",
            "side": "BUY",
            "size": 500,
            "tokenId": "poly_yes_token"
          }
        ],
        "requiresShort": false,
        "strategy": "prediction_mispricing"
      }
    ],
    "scope": "prediction",
    "snapshots": [
      {
        "books": {
          "poly_no_token": {
            "asks": [
              {
                "price": 0.53,
                "size": 9100
              },
              {
                "price": 0.54,
                "size": 7200
              }
            ],
            "bids": [
              {
                "price": 0.51,
                "size": 12400
              },
              {
                "price": 0.5,
                "size": 8300
              }
            ],
            "timestampMs": 1760000000000,
            "tokenId": "poly_no_token"
          },
          "poly_yes_token": {
            "asks": [
              {
                "price": 0.49,
                "size": 9100
              },
              {
                "price": 0.5,
                "size": 7200
              }
            ],
            "bids": [
              {
                "price": 0.47,
                "size": 12400
              },
              {
                "price": 0.45999999999999996,
                "size": 8300
              }
            ],
            "timestampMs": 1760000000000,
            "tokenId": "poly_yes_token"
          }
        },
        "lastTrades": {
          "poly_no_token": 0.52,
          "poly_yes_token": 0.48
        },
        "market": {
          "acceptingOrders": true,
          "active": true,
          "archived": false,
          "closed": false,
          "conditionId": "1919425",
          "endDateIso": "2026-05-31T00:00:00.000Z",
          "eventSlug": "us-x-iran-permanent-peace-deal-by",
          "eventTitle": "US x Iran permanent peace deal by...?",
          "liquidity": 1201662.28,
          "marketSlug": "us-x-iran-permanent-peace-deal-by-may-31-2026",
          "question": "US x Iran permanent peace deal by May 31, 2026?",
          "source": "polymarket",
          "tokens": [
            {
              "outcome": "Yes",
              "price": 0.48,
              "tokenId": "poly_yes_token"
            },
            {
              "outcome": "No",
              "price": 0.52,
              "tokenId": "poly_no_token"
            }
          ],
          "volume": 70112309.42,
          "volume24h": 5768589.43
        },
        "noBook": {
          "asks": [
            {
              "price": 0.53,
              "size": 9100
            },
            {
              "price": 0.54,
              "size": 7200
            }
          ],
          "bids": [
            {
              "price": 0.51,
              "size": 12400
            },
            {
              "price": 0.5,
              "size": 8300
            }
          ],
          "timestampMs": 1760000000000,
          "tokenId": "poly_no_token"
        },
        "noToken": {
          "outcome": "No",
          "price": 0.52,
          "tokenId": "poly_no_token"
        },
        "tokens": [
          {
            "outcome": "Yes",
            "price": 0.48,
            "tokenId": "poly_yes_token"
          },
          {
            "outcome": "No",
            "price": 0.52,
            "tokenId": "poly_no_token"
          }
        ],
        "yesBook": {
          "asks": [
            {
              "price": 0.49,
              "size": 9100
            },
            {
              "price": 0.5,
              "size": 7200
            }
          ],
          "bids": [
            {
              "price": 0.47,
              "size": 12400
            },
            {
              "price": 0.45999999999999996,
              "size": 8300
            }
          ],
          "timestampMs": 1760000000000,
          "tokenId": "poly_yes_token"
        },
        "yesToken": {
          "outcome": "Yes",
          "price": 0.48,
          "tokenId": "poly_yes_token"
        }
      }
    ],
    "timestamp": 1760000000000,
    "warnings": []
  },
  "meta": {
    "freshnessMs": 30000,
    "generatedAt": "2026-03-25T12:00:00.000Z",
    "requestId": "req_example_123",
    "updatedAt": "2026-03-25T11:59:30.000Z"
  },
  "product": {
    "accepts": [
      {
        "network": "eip155:8453",
        "payTo": "0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5",
        "price": "$0.1000",
        "scheme": "exact"
      },
      {
        "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
        "payTo": "2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ",
        "price": "$0.1000",
        "scheme": "exact"
      }
    ],
    "id": "prediction-scan",
    "method": "GET",
    "name": "Polymarket Prediction Market API",
    "networks": [
      "eip155:8453",
      "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
    ],
    "path": "/v1/prediction/scan",
    "price": "$0.1000"
  },
  "service": "seerium-x402-api"
}

Call it from code

The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.1.

curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://api.seerium.xyz/v1/prediction/scan?limitOpportunities=10&limitSnapshots=10'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://api.seerium.xyz/v1/prediction/scan?limitOpportunities=10&limitSnapshots=10' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode
JavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.1 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.1" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.1 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.seerium.xyz%2Fv1%2Fprediction%2Fscan
const res = await pay("https://api.seerium.xyz/v1/prediction/scan?limitOpportunities=10&limitSnapshots=10");
console.log(res.status, await res.text());
Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.1 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.1"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://api.seerium.xyz/v1/prediction/scan?limitOpportunities=10&limitSnapshots=10")
    print(res.status_code, res.text)

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
51 min agoPassed402382 ms$0.1
5 h agoPassed402343 ms$0.1
9 h agoPassed402183 ms$0.1
13 h agoPassed402290 ms$0.1
17 h agoPassed402139 ms$0.1
20 h agoPassed402287 ms$0.1
24 h agoPassed402187 ms$0.1
28 h agoPassed402231 ms$0.1
32 h agoPassed402167 ms$0.1
35 h agoPassed402239 ms$0.1
39 h agoPassed402185 ms$0.1
42 h agoPassed402221 ms$0.1
46 h agoPassed402237 ms$0.1
2 days agoPassed402150 ms$0.1
2 days agoPassed402286 ms$0.1