# Seerium Skill

Seerium provides machine-facing market intelligence APIs for prediction markets, Dex market briefs, funding heat, order book pressure, global pulse feeds, meme radar, wallet flow, and Pro screening.

## Use Seerium

1. Read the machine-readable catalog at `https://api.seerium.xyz/v1/catalog`.
2. Discover available routes, methods, prices, query parameters, path parameters, and request bodies from the catalog.
3. Call endpoint paths exactly as listed by the catalog.
4. Expect x402 payment enforcement on paid routes.

## API Base

- Base URL: `https://api.seerium.xyz`
- Catalog: `https://api.seerium.xyz/v1/catalog`
- Health: `https://api.seerium.xyz/health`

## x402 Notes

- Paid routes return standard x402 payment requirements when payment is missing.
- Supported payment networks and exact prices are exposed in `/v1/catalog`.
- Default prices below are for orientation only. Use `/v1/catalog` as the source of truth.

## Products And Endpoints

### Market Intelligence

- Dex Trading Agent Output: `GET /v1/dex/agent-output?symbol=BTC`
- Dex Market Brief: `GET /v1/dex/market-brief?symbol=BTC`
- Dex Funding Heat: `GET /v1/dex/funding-heat?symbol=BTC`
- Dex Order Book Pressure: `GET /v1/dex/orderbook-pressure?symbol=BTC`
- Ranked Opportunities: `POST /v1/opportunities/ranked`

### Prediction Markets

- Prediction Scan: `GET /v1/prediction/scan`
- Ending Soon Prediction Markets: `GET /v1/prediction/ending-soon`
- Cross-Venue Prediction Market Disagreement: `GET /v1/prediction/cross-venue-disagreement`
- Prediction Arb Full Cover: `GET /v1/prediction/arb/full-cover`
- Prediction Arb Same Outcome Spread: `GET /v1/prediction/arb/same-outcome-spread`
- Polymarket Builder Stats: `GET /v1/prediction/builders`
- Polymarket Builder Detail: `GET /v1/prediction/builders/detail?builder=<name>`

### Prediction Rewards

- Sponsor Rewards: `GET /v1/prediction/rewards`
- Sponsor Rewards Lab: `POST /v1/prediction/rewards/lab`
- Sponsor Rewards Optimize: `POST /v1/prediction/rewards/optimize`
- Polymarket Rewards Top Plans: `POST /v1/prediction/rewards/top-plans`

### Whale Radar

- Whale Radar Top 10 Recent Moves: `GET /v1/prediction/whale-radar/top-10-recent-moves`
- Whale Radar Randomized: `GET /v1/prediction/whale-radar/randomized`
- Whale Radar By Wallet: `GET /v1/prediction/whale-radar/by-wallet/:wallet`

### Dex

- Dex Market Scan: `GET /v1/dex/scan`
- Dex Market Brief: `GET /v1/dex/market-brief?symbol=BTC`
- Dex Funding Heat: `GET /v1/dex/funding-heat?symbol=BTC`
- Dex Order Book Pressure: `GET /v1/dex/orderbook-pressure?symbol=BTC`

### Global Pulse

- Pulse Latest: `GET /v1/pulse/latest`
- Pulse Macro Clock: `GET /v1/pulse/macro-clock`
- Relevant Weather Markets: `GET /v1/pulse/weather-markets`
- Relevant News Markets: `GET /v1/pulse/news-market-links`
- Catalyst Market Links: `GET /v1/pulse/catalysts`

### Meme Radar

- Meme Radar Fresh Launches: `GET /v1/meme-radar/fresh-launches`
- Meme Radar Smart Flow: `GET /v1/meme-radar/smart-flow`
- Meme Radar Quality Volume: `GET /v1/meme-radar/quality-volume`

### Pro

- Pro Screener: `GET /v1/pro/screener`

## Useful Agent Tasks

- Find ranked cross-source opportunities: `POST https://api.seerium.xyz/v1/opportunities/ranked`
- Find markets ending soon: `GET https://api.seerium.xyz/v1/prediction/ending-soon?source=all`
- Find cross-venue prediction market disagreements: `GET https://api.seerium.xyz/v1/prediction/cross-venue-disagreement?limit=25`
- Find cross-venue full-cover prediction arbs: `GET https://api.seerium.xyz/v1/prediction/arb/full-cover`
- Find cross-venue same-outcome spreads: `GET https://api.seerium.xyz/v1/prediction/arb/same-outcome-spread`
- Brief one crypto Dex market: `GET https://api.seerium.xyz/v1/dex/market-brief?symbol=BTC`
- Read current Dex funding pressure: `GET https://api.seerium.xyz/v1/dex/funding-heat?symbol=BTC`
- Read crypto Dex order book pressure: `GET https://api.seerium.xyz/v1/dex/orderbook-pressure?symbol=BTC`
- Link catalysts to markets: `GET https://api.seerium.xyz/v1/pulse/catalysts`
- Discover rewards plans: `POST https://api.seerium.xyz/v1/prediction/rewards/top-plans`
- Optimize one rewards market: `POST https://api.seerium.xyz/v1/prediction/rewards/optimize`
- Screen prediction-market setups: `GET https://api.seerium.xyz/v1/pro/screener`
- Inspect whale flow: `GET https://api.seerium.xyz/v1/prediction/whale-radar/top-10-recent-moves`

## Prediction Arb Query Parameters

Both arb endpoints return at most 20 rows.

- `limit`: Optional max rows, hard-capped at 20.
- `minEdge`: Optional minimum net edge. Accepts decimal or percentage-style values.
- `sources`: Optional comma-separated venue filter: `polymarket,kalshi,gemini`.
- `includeIndicative`: Optional boolean. Defaults to `true`.
- `outcome`: Optional `yes` or `no`; only for `/v1/prediction/arb/same-outcome-spread`.

## Cross-Venue Disagreement Query Parameters

- `sources`: Optional comma-separated venue filter: `polymarket,kalshi,gemini`.
- `limit`: Optional max rows, hard-capped at 100. Defaults to 25.
- `minGap`: Optional minimum price gap. Use `0.01` for one percentage point. Defaults to `0.01`.
- `minMatchConfidence`: Optional minimum market match confidence. Defaults to `0.7`.
- `includeIndicative`: Optional boolean. Defaults to `true`.

## Dex Order Book Pressure Query Parameters

- `symbol`: Optional crypto Dex symbol filter, such as `BTC`, `BTCUSDT`, or `BTC-PERP`.
- `limit`: Optional max rows, hard-capped at 100. Defaults to 20.
- `levels`: Optional order book levels per side, hard-capped at 20. Defaults to 10.
- `minTotalDepthNotional`: Optional minimum combined bid plus ask notional depth.
- `maxSpreadBps`: Optional maximum top-of-book spread in basis points.

## Dex Market Brief Query Parameters

- `symbol`: Required crypto Dex asset or pair, such as `BTC`, `BTCUSDT`, or `BTC-PERP`.
- `levels`: Optional order book levels per side used for pressure, hard-capped at 20. Defaults to 10.

## Dex Funding Heat Query Parameters

- `symbol`: Optional crypto Dex or perpetual symbol filter, such as `BTC`, `BTCUSDT`, or `BTC-PERP`.
- `limit`: Optional max rows, hard-capped at 100. Defaults to 20.
- `minAbsFundingBps`: Optional minimum absolute perp funding rate in basis points.

## Default Pricing

- Dex Trading Agent Output: `$0.0010`
- Dex Market Brief: `$0.0020`
- Prediction Scan: `$0.0010`
- Ending Soon Prediction Markets: `$0.0010`
- Cross-Venue Prediction Market Disagreement: `$0.0020`
- Prediction Arb Full Cover: `$0.0030`
- Prediction Arb Same Outcome Spread: `$0.0030`
- Dex Market Scan: `$0.0010`
- Dex Funding Heat: `$0.0010`
- Dex Order Book Pressure: `$0.0010`
- Pulse Latest: `$0.0010`
- Pulse Macro Clock: `$0.0010`
- Relevant Weather Markets: `$0.0060`
- Relevant News Markets: `$0.0060`
- Catalyst Market Links: `$0.0060`
- Ranked Opportunities: `$0.0040`
- Polymarket Builder Stats: `$0.0010`
- Polymarket Builder Detail: `$0.0010`
- Sponsor Rewards: `$0.0010`
- Sponsor Rewards Lab: `$0.0050`
- Sponsor Rewards Optimize: `$0.0060`
- Polymarket Rewards Top Plans: `$0.0100`
- Whale Radar endpoints: `$0.0030`
- Meme Radar endpoints: `$0.0010`
- Pro Screener: `$0.0050`

## Notes

- The API is designed for machine consumers.
- Use `/v1/catalog` as the source of truth for routes, prices, payment networks, schemas, and examples.
- Some routes are cache-backed and may return an unavailable response until their worker has warmed up.
- Seerium is informational only and does not place trades.