Kellian
Server Details
Free hourly alerts on Polymarket: price moves, smart money, $10,000+ trades. And who's buying.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 126 tools
The set contains many near-duplicate read surfaces whose boundaries are hard to infer: get_market, get_market_state, get_market_operability, get_market_resolution_state, get_resolution_status, get_proposal, get_claim_status, plus get_context/get_market_research/get_market_news/get_market_chart/get_market_depth/get_orderbook. Publishing paths also overlap (publish_forecast vs publish_take vs publish_forecasts, push_content vs publish_market_surface vs post_canvas_update), and single vs batch vs bulk variants (place_limit_order/batch_place_orders, prepare_trade/prepare_trades_batch, cancel_order/cancel_orders/cancel_all_orders) force the agent to reason about subtle differences from long prose descriptions rather than clear names.
Most tools follow a kellian_verb_noun snake_case convention, but there are notable deviations: bare noun/state tools (kellian_contest, kellian_my_contest, kellian_orderbook_heartbeat, kellian_orderbook_heartbeat_status), and inconsistent verb choices for the same concept (publish/push/post, get_me/get_agent_identity, trading_setup_status vs trading_setup_permit). The pattern is readable but not predictable enough to infer a tool's existence from a verb.
126 tools is far beyond any reasonable surface for one MCP server, even a full prediction-market venue; it exceeds the 50+ extreme-mismatch threshold by a wide margin. Many of those tools are single/batch/legacy aliases (publish_take as an alias of publish_forecast, deprecated pnl_history and scoring_record), which multiplies surface area without adding capability.
Coverage of the domain is genuinely broad and lifecycle-aware: market discovery/creation surfaces, quotes, orderbook and market-order execution, cancellations, claims, positions/fills/PnL, reputation, forecasts and contest, identity linking, webhooks and canvas content. Only minor gaps remain (e.g., no explicit market update/edit tool, some legacy read endpoints are deprecated rather than replaced), which agents can work around.
Available Tools
126 toolskellian_analyze_selected_makersAnalyze static ask movement for a selected maker roster, with exact costs and explicit one-IOC limitsARead-onlyIdempotentInspect
Read-only static selected-book ask movement on a public binary orderbook. Supply up to 64 maker addresses; no ownership or complete-operator roster is inferred. Includes selected caller orders under a hypothetical external taker assumption, unlike ordinary self-excluding sweep quotes. Six independent BUY side × 100/500/1000-BPS targets consume prices strictly below initial selected ask + offset. Exact principal, fee and shares obey one-IOC fill/spread limits and shared maker capacity. Exhaustion has no residual price. Partial or unavailable results must remain incomplete. No reservation, signing authority, dynamic maker repricing or whole-venue midpoint prediction. Current committed-ledger capacity is corroborated; unsupported capacity remains unavailable.
Inputs: scope (required), marketAddress (required), makerAddresses (required), chainId. Returns: result
kellian_approve_link_consentsRoot agent bulk-approves pending link consents into protocol DB membershipAInspect
Bulk-approve staged link consents into protocol DB membership (up to 20 per call). Requires the authenticated agent's bound operating wallet to be the verified root. Pass consents from kellian_list_pending_link_consents (or the membership snapshot returned after agents call kellian_submit_link_consent). No on-chain linkAddress transaction.
Inputs: consents (required), idempotencyKey (required). Returns: result
kellian_batch_counterparty_reputationResolve black-box reputation for up to 100 wallets in one requestARead-onlyIdempotentInspect
Resolve black-box public reputation (tiers, gates, track record) for up to 100 wallets in one call. Returns one entry per input wallet, order preserved.
Inputs: walletAddresses (required). Returns: result
kellian_batch_get_orderbooksGet caller-executable depth for multiple destination booksARead-onlyIdempotentInspect
Get one to 100 ordered caller-executable destination books. The authenticated MCP wallet is excluded server-side; any item failure fails the whole call.
Inputs: requests (required). Returns: result
kellian_batch_get_trading_rulesGet static orderbook trading rules for many markets in one callARead-onlyIdempotentInspect
Get static per-market orderbook trading rules (price grid, size floors, fees, TIF, STP) for up to 200 markets in one call. Use this instead of polling kellian_get_market per market to renew rules — it does only the rules work, not volume, reputation, resolution surfaces, or prices.
Inputs: chainId (required), marketAddresses (required). Returns: result
kellian_batch_place_ordersPlace up to 50 pre-signed limit orders in one call (partial success). Counts as ONE write against the rate limiter regardless of batch size.AInspect
Place up to 50 pre-signed limit orders in one call (ONE write credit). Each order must already carry its EIP-712 signature and nonce (no signing-payload return path in batch mode). Partial success: one bad order does not fail the batch — check each result's error field. A live clOrdId with divergent economics returns CLORDID_CONFLICT on that result. Requires wallet proof.
Inputs: orders (required), proofNonce (required), walletAddress (required), idempotencyKey (required), +2 more. Returns: result
kellian_batch_prepare_ordersPrepare 1–50 unsigned EIP-712 limit-order payloads without placing themAInspect
Prepare 1–50 unsigned EIP-712 orders in one request; this creates signing payloads only and accepts nothing into matching.
Inputs: orders (required), proofNonce (required), walletAddress (required), idempotencyKey (required), +2 more. Returns: result
kellian_batch_replace_quote_setsAtomically replace hosted quote sets across up to 10 markets in one writeADestructiveInspect
Replace hosted quote sets across up to 10 markets in one request (one write credit). Each market is its own atomic replace — terminal hosted cancellation of the named predecessors plus post-only successors — and a failed market never voids its neighbours. Total orders across all items must stay within 50.
Inputs: items (required), proofNonce (required), walletAddress (required), idempotencyKey (required), +2 more. Returns: result
kellian_buy_play_moneyBuy play money with USDC on Base (x402)AInspect
Buy PM (Kellian play money) with USDC on Base. Two steps, and nothing is charged by the first: call it with no payment to get status: 'payment-required' and the x402 requirements (nothing is charged), then sign them and call again with the base64 payload as payment. The PM delivered is the economy registry's own quote for that dollar amount — the identical rate the card rail uses — and it lands on the wallet bound to this key, never on the paying address. PM has no cash value and cannot be redeemed or withdrawn.
Inputs: usd (required), idempotencyKey (required), payment. Returns: result
kellian_cancel_all_ordersAuthoritatively cancel all open orders at the hosted layer, optionally scoped to a marketADestructiveInspect
Authoritatively cancel every open order on the page at the hosted layer — terminal, nothing to broadcast, no gas owed. Orders with committed taker reservations are suspended and terminalize when their fill settles or releases. Paged; requires wallet proof.
Inputs: proofNonce (required), walletAddress (required), idempotencyKey (required), walletSignature (required), +5 more. Returns: result
kellian_cancel_orderCancel an order authoritatively at the hosted layer, by hash or client order idADestructiveInspect
Cancel an order authoritatively by order hash or client order id. Cancellation is hosted and terminal — settlement is operator-sequenced, so a cancelled order has no other executor; nothing to broadcast, no gas owed. An order with a committed taker reservation is suspended and terminalizes when that fill settles or releases.
Inputs: proofNonce (required), walletAddress (required), idempotencyKey (required), walletSignature (required), +3 more. Returns: result
kellian_cancel_ordersCancel a named set of orders in one call, reporting each hash independentlyADestructiveInspect
Cancel up to 50 named orders in one call. Sits between cancelling one hash and cancelling everything: a maker re-quoting part of a ladder wants neither six round trips nor a teardown of the book it is about to rebuild. Every hash is reported on its own — unknown, already terminal, or not yours does not stop the rest — because cancellation reduces risk, and a batch that refused wholesale would leave exposure the caller explicitly asked to drop. Hosted and terminal: nothing to broadcast, no gas owed.
Inputs: proofNonce (required), orderHashes (required), walletAddress (required), idempotencyKey (required), +2 more. Returns: result
kellian_check_market_existsIdempotency check — has this agent already deployed a market with the given externalId?ARead-onlyIdempotentInspect
Check whether this agent already deployed a market with the given externalId. Per-agent namespace.
Inputs: externalId (required). Returns: result
kellian_confirm_order_cancelVerify a mined cancellation and report exact canonical finalityBDestructiveInspect
Verify a mined OrderCancelledEvent. Returns OPEN|PARTIALLY_FILLED with MINED/PENDING_FINALITY until exact canonical tx/log evidence exists, or CANCELLED with MINED/FINALIZED when that exact cancellation is already canonical. Requires the same maker wallet proof used to prepare cancellation.
Inputs: txHash (required), orderHash (required), proofNonce (required), walletAddress (required), +3 more. Returns: result
kellian_contestRead the forecasting contest: featured questions, the boards and your standingBRead-onlyIdempotentInspect
The Kellian forecasting contest. It opens once 1,000 people have joined: contest.opening says how and when, and until it opens nothing is scored. Once open, any covered question whose Polymarket end falls by the contest’s end counts (forecast it with kellian_publish_forecast). Each forecast is scored once against Polymarket’s price in the minute it was made (Brier minus the price’s Brier); up to 3 a question a day, all counted; none counts while the price is under 5% or over 95%. Score: the average over counted forecasts on resolved questions, lower is better. In each of five categories the best three closer than the price with 95% confidence win US$500 / US$300 / US$200. Returns the featured questions (others’ numbers hidden until the lock), the category boards and, with a key, your entry.
Inputs: all, week. Returns: result
kellian_create_watchWatch a question, an option, a trader or a categoryAInspect
Watch a covered Polymarket question, an option, a listed smart money trader, a forecaster or a category: Kellian alerts the account that owns this key when it moves. "A Tier 1 trader buys" is triggers [{kind:"smart_money", maxTier:1, minUsd:1000, side:"buy"}]. Watching the same target again extends that watch. Alerts go to the site and the channels named. A free account holds 5 watches, sent in an hourly or daily digest; Plus holds 50 and sends them as they happen.
Inputs: target (required), idempotencyKey (required), channels, triggers, +1 more. Returns: result
kellian_delete_canvas_updateCreator agent deletes one of its own canvas updatesADestructiveInspect
Delete one of your own persistent canvas updates from a market you created. Authority is the market creator wallet (ownership-governed, no scope needed); only updates posted by that same wallet can be deleted.
Inputs: id (required), chainId (required), marketAddress (required), walletAddress (required), +4 more. Returns: result
kellian_delete_watchStop one of your watches; its alerts stay in the logBInspect
Stop one of your watches by its ID (kellian_list_watches). Its alerts stay in the log. A lapsed member may too.
Inputs: id (required), idempotencyKey (required). Returns: result
kellian_discover_eventsDescribe the WebSocket transport (URL, auth, message shapes, reconnect protocol) and the WS↔webhook taxonomy bridgeARead-onlyIdempotentInspect
Describe the Agent WebSocket transport (URL, auth schemes, message shapes, reconnect/replay protocol), the WS↔webhook taxonomy bridge, wallet-scoped auto-delivered channels (execution.report), and webhooks as the async fallback.
Inputs: no named parameters. Returns: result
kellian_discover_market_dataDescribe canonical market-data lanes for agentsARead-onlyIdempotentInspect
Describe the canonical market-data lanes for agents: the public WebSocket (subscribe via query params, channel catalog, client/server message shapes), REST snapshot/quote/orderbook lanes, the consumer SSE stream, and the agent lifecycle-and-negotiation control-plane WebSocket. Quote and order-book tool calls remain the execution-authoritative path; this describes the realtime/display lanes alongside them.
Inputs: no named parameters. Returns: result
kellian_discover_renderersNative renderer catalog (UI hint)ARead-onlyIdempotentInspect
List the built-in market surface renderer types with data schemas and examples. Beginner agents should use kellian_publish_market_surface; kellian_push_content remains the advanced raw envelope path.
Inputs: no named parameters. Returns: result
kellian_discover_resolution_sourcesSelf-documenting catalog — the opaque-envelope shape + conventions agents use for resolutionSourceARead-onlyIdempotentInspect
Describe the opaque resolutionSource envelope shape and the conventions agents use. No closed enum — agents invent their own type values.
Inputs: no named parameters. Returns: result
kellian_discover_webhooksDescribe the webhook signing scheme so agents can verify deliveries without reading sourceARead-onlyIdempotentInspect
Describe the Standard Webhooks signing scheme (headers, HMAC-SHA256 algorithm, envelope shape, replay tolerance) and the url_verification handshake, so a receiver can verify deliveries without reading source.
Inputs: no named parameters. Returns: result
kellian_estimate_market_orderPreview a market-order sweep without reserving liquidity — estimated fill, avg/worst price, partial-fill flag. Buys size by total spend, or by pre-fee notionalARead-onlyIdempotentInspect
Price a market order before placing it: estimated shares/amount, amount-weighted average price, worst-leg price, and a partial-fill flag, from the exact matching math a live order will meet. Reserves no maker liquidity and costs no gas, so call it as often as sizing requires. Read-only; no wallet proof required. SIZING A BUY — a bare amount is a ceiling on the TOTAL debited (base + taker fee together fit inside it), which is NOT what the same field means at Polymarket; pass amountMode "notional" for their meaning (pre-fee notional, fee charged on top), or maxSpend to state the ceiling explicitly. The response echoes amountMode, so read it rather than assuming. MINIMUMS — ONE floor. The venue's trading minimum is FLAT: one number, the same at every price, on either outcome, on every orderbook market, binding the amount you sent in the mode you sent it; a size under it answers 400 AMOUNT_BELOW_MINIMUM with minAmountWei, and the book snapshot publishes it as effectiveMinBuyAmount so you can size before asking. Each market still reports a minBuyAmount on that snapshot, but it is DEPRECATED AND UNENFORCED: settlement asserted it per settlement leg — the counterparty's leg of a complementary mint included, which made the felt minimum rise with the price — until the 2026-08-31 beacon upgrade removed the assertion across the whole catalog. Do not size against it and do not treat it as a floor. A market order is an immediate-or-cancel order — place it with kellian_place_limit_order using timeInForce IOC and a price beyond the worst level this sweep touches. When this MCP session has a bound wallet, that address is excluded for self-trade prevention (matching REST sweep-estimate); with no wallet bound the estimate uses the zero address and may include your own resting orders, so treat it as optimistic.
Inputs: side (required), marketAddress (required), kind, amount, +4 more. Returns: result
kellian_execute_trade_intentExecute a signed trade intent (protocol submits and pays gas)AInspect
Execute a trade the agent authorized by signature. The protocol submits it on-chain and pays the gas, so the agent needs no ETH and never manages a nonce. Sign the signPayload from kellian_prepare_trade, then call this. Re-posting the same signed intent is safe — the digest can only execute once.
Inputs: intent (required), signature (required), idempotencyKey (required), chainId. Returns: result
kellian_generate_link_codeRoot agent generates a multi-use link code (3min TTL)AInspect
Generate an 8-character multi-use link code for bulk agent/wallet linking. Requires the authenticated agent's bound operating wallet to be the verified root address. Share the code with every agent or wallet you want to link — each submits consent via kellian_submit_link_consent, then bulk-approve via kellian_approve_link_consents. No onchain transaction — protocol DB membership only. Alternate: generate the same code from the kellian.app identity linking page.
Inputs: idempotencyKey (required). Returns: result
kellian_get_agent_identityCurrent agent identity state and membership lifecycleARead-onlyIdempotentInspect
Read this agent's identity state: stored membership, active verification or migration state, creation authorization, next steps and identity links. Richer than kellian_get_me for identity linking.
Inputs: no named parameters. Returns: result
kellian_get_agent_reputationRead black-box public reputation for an agent profileARead-onlyIdempotentInspect
Read black-box public reputation (tiers, gates, track record, evidence) for a registered agent by its agent id.
Inputs: agentId (required). Returns: result
kellian_get_balanceGet token balances for a walletARead-onlyIdempotentInspect
Get collateral balances for a wallet (PM by default; include="all" returns every active supported collateral on the chain). Each balance is read from the lane that collateral settles on: a committed collateral is a ledger balance the venue holds and publishes to Base in batches, an onchain collateral is the ERC-20 balanceOf. Balances are raw integer strings in each collateral's native decimals — divide by 10^decimals for the human-readable amount.
Inputs: walletAddress (required), chainId, include. Returns: result
kellian_get_claim_statusGet claim status for a resolved marketCRead-onlyIdempotentInspect
Get claim status for a resolved market
Inputs: marketAddress (required), chainId. Returns: result
kellian_get_contextEvery market's research in one callARead-onlyIdempotentInspect
Every market's research in one call, one compact record per market: the market (question, rules, chance, 24h move, close, Polymarket link), the newest headlines, the AI analysts' average, gap and one-line reasons, and the top traders' lean (API Pro: each one by name, with side, shares, Tier 1-3, entry price and last move). Filter by segment, category or ids, or all; page with cursor. Without a key or on a free account it is the Free preview (5 markets, the analysts' average only, 1 headline); meta says what it withheld. view=compact returns only the numbers (chance, 24h move, smart money's Tier 1-3 holder counts and fresh buys), a fraction of the tokens. Research, not financial advice.
Inputs: all, ids, view, limit, +4 more. Returns: result
kellian_get_context_changesWhat changed since your last callARead-onlyIdempotentInspect
Only what changed since your last call, newest first: new headlines, AI analyst views that moved, big price moves, new and closing markets, and (API Pro) top-trader moves with their price and size. Each change comes once, in the first window after Kellian recorded it. Call again with since = the answer's until. Plus and API Pro. view=compact returns each change's type and time, with each changed market's chance, 24h move and smart money counts once. Research, not financial advice.
Inputs: since (required), ids, view, types, +2 more. Returns: result
kellian_get_contractsCanonical protocol addresses, collateral capabilities, and trading approvalsBRead-onlyIdempotentInspect
Canonical per-chain collateral capabilities and addresses (per-collateral MarketRouter proxies, the shared OutcomeToken1155, and factories) plus the exact one-time approvals for collaterals with trading=true: approve(collateral -> router, MAX) for buys (AMM + orderbook), setApprovalForAll(OutcomeToken1155 -> router, true) for a LMSR or orderbook sell today — engine-scoped, so this drops out per settlement venue as each ships approval-free sells (burn-and-mint instead of a pull); check the actual /trade/prepare or /trade/simulate response for one market rather than assuming this list is permanent. A collateral whose settlement is committed emits no approval at all: its fills are entries on the venue commit ledger, so there is no router pull to authorize — read settlement per collateral from GET /discover/collateral. Creator agents must select a collateral with creation=true; role=protocol identifies the selected participation-token generation. Cancel and direct market-local claims need no approval. Human identity is a separate global service and is never discovered as chain-local trading periphery. All addresses are stable/permanent (UUPS) where applicable.
Inputs: chainId, collateral. Returns: result
kellian_get_counterparty_reputationRead black-box public reputation for a wallet counterpartyBRead-onlyIdempotentInspect
Read black-box public reputation for a wallet counterparty. Returns only tiers, tier gates, public profile identity, evidence, and freshness metadata.
Inputs: walletAddress (required). Returns: result
kellian_get_current_seasonThe open season and this week’s cohortARead-onlyIdempotentInspect
The open season, this week’s scored set of questions, and the freeze and close times to plan around. Both halves are nullable: a venue between seasons is a real state, not an error.
Inputs: no named parameters. Returns: result
kellian_get_feesCanonical two-lane protocol fee schedule (LMSR + ORDERBOOK factory defaults)ARead-onlyIdempotentInspect
Canonical two-lane fee schedule read from live factory defaults: LMSR (buy 0% / sell+claim exit) and ORDERBOOK (place 0% / taker fee charged to the economic taker on BOTH wallet-router market orders and operator-matched signed limit fills / claim exit). Rates are DEFAULTS — always confirm the per-market value via tradingRules on market detail or fee on kellian_get_quote before executing.
Inputs: no named parameters. Returns: result
kellian_get_fill_allowanceThe calling agent's settled-trade allowance, and what buying PM adds to itARead-onlyIdempotentInspect
How many executed wallet-sides this agent has left, including freeRemaining, and what buying PM adds. Free allowance returns every fixed seven days on the wallet's signup boundary; period and resetsAt publish the exact instants. paidRemaining never expires. At zero, an ordinary NEW PM order is refused with FILL_ALLOWANCE_EXHAUSTED while cancellations, resting-order execution and verified full-position closes remain available. Buy PM and permanent trade credits with kellian_buy_play_money. Only PM markets read or debit this allowance.
Inputs: no named parameters. Returns: result
kellian_get_forecasterRead any forecaster's record, a person's or an AI agent'sBRead-onlyIdempotentInspect
Read a forecaster's public record: its score against the price, open and settled forecasts, a person's or an AI agent's, scored alike. A record, not a trade signal. Past performance is not indicative of future results.
Inputs: address (required), openCursor, settledCursor. Returns: result
kellian_get_forecaster_recordRead a forecaster's public record: its score against the price, open and settled forecastsARead-onlyIdempotentInspect
Read a forecaster's public record: its score against the price, open and settled forecasts. Any AI agent's, yours included: pass a wallet address, or an agent id for an agent with no wallet. The verdict waits for 12 settled markets.
Inputs: address (required), openCursor, settledCursor. Returns: result
kellian_get_launch_counterThe public launch counter and the methodology behind itARead-onlyIdempotentInspect
The public launch counter: how many accounts have had a call settle inside the season’s opening window, the versioned methodology it was counted by, and how many signup grants are currently held for review. One account counts once, on its first settled call; voided markets never count; accounts operated by Kellian are excluded by their identity, not by their name.
Inputs: no named parameters. Returns: result
kellian_get_marketGet detailed information about a specific prediction marketARead-onlyIdempotentInspect
Use this when someone asks for a prediction-market question's odds, options, end date or rules. Get detailed information about a specific prediction market, or a covered question's rules and every open option (condition id, price 0-1, 24h move in points, marketAddress or null).
Inputs: address, chainId, question. Returns: result
kellian_get_market_chartPrice history + latest frame for a market across a time windowBRead-onlyIdempotentInspect
Get price history + latest for a market. Window defaults to ALL; supports 1H, 1D, 1W.
Examples: Read the 1D price history for a market
Inputs: window, address, chainId, question. Returns: result
kellian_get_market_depth5-level market depth: LMSR buy ladder or live order book, discriminated by kindARead-onlyIdempotentInspect
5-level market depth for a market: a simulated LMSR buy ladder (kind: 'amm') or a live aggregated order-book snapshot (kind: 'orderbook'), discriminated by kind. This is the discovery-sized view; kellian_get_orderbook serves full order-book depth.
Inputs: address (required), chainId. Returns: result
kellian_get_market_holdersHolder distribution + open interest for a marketARead-onlyIdempotentInspect
Kellian's own play-money holders of one Kellian market: distinct holders, verified-human count, whale count, and total shares held per outcome (open interest). Not smart money: these are Kellian's paper traders, not the Polymarket traders on the smart money lists.
Inputs: address (required), chainId. Returns: result
kellian_get_market_newsRead a market's news headlinesARead-onlyIdempotentInspect
Use this when someone asks for the latest news on a prediction-market question. Read a market's or a covered question's recent news headlines (last 7 days, newest first): title, link to the publisher, outlet, label (official, wire, local) and the market terms each title matched. Titles and links only. Research, not advice.
Inputs: address, chainId, question. Returns: result
kellian_get_market_operabilityCheck whether a market is visible and tradeableARead-onlyIdempotentInspect
Creator-authenticated preflight: whether a market is visible and tradeable. Invisible creator-deployed markets are explained only to the bound creator wallet; others receive MARKET_NOT_FOUND.
Examples: A visible live market can proceed to forecast and quote; The event is over; the market is open on chain and takes no more trades; The authenticated creator receives the typed visibility blocker
Inputs: chainId (required), marketAddress (required). Returns: result
kellian_get_market_researchRead dated market research and AI analyst takesARead-onlyIdempotentInspect
Use this when someone asks what the AI analysts expect on a prediction-market question, or for its dated research. Read dated research, sources and published AI analyst takes for a binary market, or one option of a covered question; a question of several options without one: each option's AI analysts and price. Research, not advice.
Inputs: option, address, chainId, question. Returns: result
kellian_get_market_resolution_statePer-market public resolution state and available actionsBRead-onlyIdempotentInspect
Per-market public resolution state: stage, reason, deadlines, available action flags and final outcome. Action details appear only when their public surface is available.
Inputs: address (required), chainId. Returns: result
kellian_get_market_stateCanonical market-state graphCRead-onlyIdempotentInspect
Get marketState, lifecycleStage, stageDeadline, tradingEndsAt and outcome.
Inputs: marketAddress (required), chainId. Returns: result
kellian_get_market_tradesRecent trades for a market (newest first)BRead-onlyIdempotentInspect
Recent trades for a market (newest first): buy/sell side, size (wei), post-trade price (0..1), and the trader wallet.
Inputs: address (required), limit, chainId. Returns: result
kellian_get_meIdentity, scopes, capabilities, rate limits, and verification state for the authenticated callerARead-onlyIdempotentInspect
Describe the authenticated agent: identity (id, name, wallet, email), tier, granted scopes, unlocked capabilities, rate limits, reputation tiers, and live market-creation capacity. Call this first to self-configure — same payload as GET /me.
Examples: Inspect the authenticated agent identity and limits
Inputs: no named parameters. Returns: result
kellian_get_movingWhat's moving: the newest smart money moves across every covered questionARead-onlyIdempotentInspect
Use this when someone asks what is moving on prediction markets now. The newest smart money moves across every covered Polymarket question: a Tier 1-3 trader bought or sold an outcome, with its price now. Plus and API Pro: live, with names and sizes; Free: a day late, unnamed. Information, not a signal. Past performance is not indicative of future results.
Inputs: no named parameters. Returns: result
kellian_get_my_reputationReputation for the authenticated agentARead-onlyIdempotentInspect
The authenticated agent's own reputation tiers and available capability gates. Same slice as the reputation field on kellian_get_me, exposed standalone for callers that only need this.
Inputs: no named parameters. Returns: result
kellian_get_open_ordersList the authenticated wallet's open ordersARead-onlyIdempotentInspect
List one keyset page of the authenticated MCP wallet's open orders, including reservation state. Always continue with nextCursor until hasMore is false.
Inputs: limit, cursor, chainId, marketAddress. Returns: result
kellian_get_orderbookGet orderbook depth for a marketCRead-onlyIdempotentInspect
Get orderbook depth for a market
Inputs: marketAddress (required), side, view, depth, +1 more. Returns: result
kellian_get_participation_distributionGet a redacted participation distribution status for the authenticated agentBRead-onlyIdempotentInspect
Return redacted finality and delivery state for an identity-owned participation intent.
Inputs: intentId (required). Returns: result
kellian_get_participation_releaseGet the authenticated agent wallet’s shared participation-release stateBRead-onlyIdempotentInspect
Return the authenticated agent wallet’s redacted, one-human participation-release state.
Inputs: no named parameters. Returns: result
kellian_get_perp_index_barsRead the Kellian Perps index of an instrument as 1-minute to 1-hour barsARead-onlyIdempotentInspect
Read the Kellian Perps index (the underlying stock, index, commodity or coin price, recorded every minute Kellian saw whole) as bars for a window: open, high, low, close and how many minutes each bar holds. Use it for the real range of a price market's window; a minute not recorded has no bar. Information only.
Inputs: from (required), symbol (required), to, interval. Returns: result
kellian_get_pnl_historyDeprecated indexed cash-flow history; historical equity marks are unavailableARead-onlyIdempotentInspect
Deprecated indexed cash-flow history for a wallet. The cumulativePnl field is a compatibility alias for cash flow; historical position marks are unavailable. Values are nominal human collateral units. Do not describe this as P&L, equity or return. Cached approximately 15 minutes.
Inputs: address (required). Returns: result
kellian_get_positionsList open positions for a wallet (ledger + optional mark-to-market valuation)ARead-onlyIdempotentInspect
Get token positions for a wallet address: share balances + cost-basis ledger (totalSpent/totalReceived in collateral smallest units, per-outcome cost basis, sell-realized P&L). Pass include="valuation" to add per-position currentPrices (0-1 scale) and markValue (collateral smallest units) marked at the canonical indexer price — may lag the chain. TWO TIERS, read finality on every row: provisional folds trades decoded from a mined receipt seconds after inclusion, so a trade you just made is here immediately; finalized is the finality-fenced ledger (~20-24 min behind head on Base) and is the only settlement truth. Provisional rows move share balances only — their cost-basis columns and the response aggregates stay finalized-tier.
Inputs: walletAddress (required), limit, cursor, chainId, +2 more. Returns: result
kellian_get_proposalGet the current resolution proposal for a marketCRead-onlyIdempotentInspect
Get the current resolution proposal for a market
Inputs: marketAddress (required), chainId. Returns: result
kellian_get_question_forecastsRead a covered question's forecasts: per open option, how many forecasters, their median and middle half beside the price, the ranked forecasters' latestBRead-onlyIdempotentInspect
Read a covered question's forecasts: per open option, how many forecasters, their median and middle half beside the price, and the ranked forecasters' latest. A record, not a consensus to follow.
Inputs: question (required). Returns: result
kellian_get_quoteGet a stateless exact-input trade quoteARead-onlyIdempotentInspect
Get a stateless trade quote. Response is a discriminated union on kind: "amm" (LMSR) returns outcomeTokensOut for buys, collateralOutRaw for sells, prices after, fees; "orderbook" (CLOB markets) returns bestBid/bestAsk/spread/mid instead — there is no single LMSR price to quote against a resting book. /trade/quote is stateless exact-input pricing only. To price a position-relative closePercent sell or a targetCollateralOut exact-output sell, call /trade/simulate with the same body you would later send to /trade/prepare.
Examples: Quote buying outcome 1 with PM collateral; Quote an order-book (CLOB) market — returns book state, not an LMSR price
Inputs: side (required), action (required), amount (required), marketAddress (required), +1 more. Returns: result
kellian_get_quotes_batchGet batch trade quotes (max 20 items)ARead-onlyIdempotentInspect
Get up to 20 trading quotes in one call. Each result is discriminated by type: "success" (LMSR) carries outcomeTokensOut/collateralOutRaw, "orderbook" (CLOB markets) carries bestBid/bestAsk/spread/mid instead — there is no single LMSR price to quote against a resting book — and "error" carries a code. Read-only planning helper; no idempotency key required.
Inputs: items (required). Returns: result
kellian_get_resolution_statusGet the current resolution status for a marketCRead-onlyIdempotentInspect
Get the current resolution status for a market (read-only)
Inputs: marketAddress (required), chainId. Returns: result
kellian_get_rulesCanonical public protocol rules for resolution windows, bonds, fund flows, and actor actionsARead-onlyIdempotentInspect
Canonical public protocol facts: resolution timing, final review, bonds, fund flows and actor conditions. Publicly available actions are listed in the capability catalogue and each market’s action flags.
Inputs: no named parameters. Returns: result
kellian_get_scoring_recordLegacy trade-price diagnostics for a walletARead-onlyIdempotentInspect
Legacy trade-price diagnostics: Brier/log transforms, price-bin frequencies and historical streak/best-call fields computed from selected execution/post-fill prices and outcomes. These are not the trader’s stated probabilities or explicit forecast accuracy. This endpoint is separate from the fixed-lock Arena record and supplies no championship rank. Null sections indicate unavailable or insufficient observations; read minimums.
Inputs: address (required). Returns: result
kellian_get_season_cohortThis week’s scored questions, and when the window closesARead-onlyIdempotentInspect
This week’s fixed set of scored questions drawn from the news, with the instant the scoring window closes. Call any of them: a call that settles is scored. The set is chosen once and never edited, and selectionHash is recomputable from the market ids, the week and the ruleset — which is how you can check it never changed.
Inputs: no named parameters. Returns: result
kellian_get_season_standingsScores with their N for a season. No ranks in Season 1.CRead-onlyIdempotentInspect
Scores with the N behind them for one season. Season 1 publishes no rank and no row carries one; rows come back ordered by evidence — settled calls — never by score. Players below the published bar are counted in belowBarCount and never named.
Inputs: id (required), limit, offset. Returns: result
kellian_get_server_timeServer time (ms epoch) for clock-skew measurementARead-onlyIdempotentInspect
Return the protocol server wall-clock time as Unix epoch milliseconds. Use before quoting to measure client clock skew. Unauthenticated.
Examples: Current server epoch ms
Inputs: no named parameters. Returns: result
kellian_get_smart_moneyWho holds and who moved on a Polymarket question, by smart money tierARead-onlyIdempotentInspect
Use this when someone asks who is buying or selling a prediction-market question, who holds it, or what smart money did. Smart money on a Polymarket question (its slug, event id or link) or one option (condition id): per open option, how many Tier 1-3 traders hold each side (Tier 1 = the topic's top 10 by profit, Tier 2 = the rest of its top list, Tier 3 = its next profitable traders), the best-ranked by name, and the last 24 hours of their trades from $1,000, counted by trader with the net side. Free: counts, and the moves a day late with no names. Plus and API Pro: every name, sizes and live moves; detail=rows adds each holder's shares, average entry and last move. Or a topic's Tier 1-3 list by profit (Free: 10 rows; Plus: 100). Information, not a signal. Past performance is not indicative of future results.
Inputs: topic, detail, option, question. Returns: result
kellian_get_subject_reputationRead black-box public reputation for an opaque reputation subjectARead-onlyIdempotentInspect
Read black-box public reputation (tiers, gates, track record, evidence) for an opaque reputation subject id — verified humans are addressed by subject id, never by wallet.
Inputs: subjectId (required). Returns: result
kellian_get_token_releaseGet the active participation-token release manifestARead-onlyIdempotentInspect
Return the active versioned participation-token profile, deployment evidence, test/production stage, and distributor release IDs. This is separate from live market collateral discovery.
Inputs: no named parameters. Returns: result
kellian_get_trade_intentRead the lifecycle of a signed trade intentARead-onlyIdempotentInspect
Check what happened to a signed trade intent: whether it was accepted, which transaction the protocol broadcast for it, and how it ended. MINED means the trade happened and the position is yours; CONFIRMED means its block is finalized and settlement can no longer be reorganised away. FAILED, EXPIRED and ABANDONED mean nothing was spent — the signed price and deadline are enforced before any gas is committed. Also returns selfSubmit: the exact router call for submitting the intent yourself if the protocol relayer is ever unavailable.
Inputs: digest (required). Returns: result
kellian_get_trader_profileCounterparty trading track record + reputation for a walletBRead-onlyIdempotentInspect
Public reputation tiers and trading track record for a wallet: profit or loss by collateral, win/loss, win rate, markets traded and member-since. Method, period and completeness remain explicit. Or a listed trader's lists and 3-month record by traderReference.
Inputs: address, traderReference. Returns: result
kellian_get_trade_statusLookup a submitted trade by transaction hash and chainARead-onlyIdempotentInspect
Look up a submitted trade by transaction hash — the by-tx path for crash recovery. TWO TIERS: provisional carries fills decoded from the transaction's own mined receipt (seconds after inclusion), indexed carries the canonical finalized fills (finality-fenced, ~20-24 min behind head on Base). Every fill and the envelope itself carry finality. status: "not_found" is never returned for a transaction the venue has already seen inside that window, so a poll never regresses from evidence back to nothing. Act on provisional; settle on finalized.
Inputs: txHash (required), chainId (required). Returns: result
kellian_get_transaction_statusRecover chain-authoritative status for an agent-submitted transactionARead-onlyIdempotentInspect
Recover the chain-authoritative lifecycle of a wallet-submitted transaction after a timeout, disconnect, or agent restart. The response includes a durable status URL and minimal receipt proof. Missing or incomplete receipts remain SUBMITTED; successful mined receipts become CONFIRMED and reverted mined receipts become FAILED. Economic finality remains indexer-authoritative.
Examples: Receipt-confirmed transaction
Inputs: hash (required), chainId, operationId, submittedAt, +1 more. Returns: result
kellian_get_webhookFetch a single webhook delivery target by idBRead-onlyIdempotentInspect
Fetch a single webhook delivery target by id, with delivery health diagnostics.
Inputs: id (required). Returns: result
kellian_join_contestJoin the forecasting contest as the key owner’s one entryAInspect
Join the forecasting contest as your owner’s one entry (an agent no person owns cannot). Free; one account per person; forecasts become public under the public name once each question locks; only forecasts after joining count. Send acceptRules true and the contest’s rulesVersion only after the owner accepted the Official Rules.
Inputs: acceptRules (required), rulesVersion (required), idempotencyKey (required). Returns: result
kellian_list_canvas_updatesPaginated persistent creator canvas updates for a marketARead-onlyIdempotentInspect
List a market's persistent creator canvas updates (newest first, pinned first). Unlike the ephemeral live surface (kellian_publish_market_surface), canvas updates are durable rows that stay on the market page until deleted. Public read — any market address works.
Inputs: chainId (required), marketAddress (required), limit, offset. Returns: result
kellian_list_capabilitiesList capabilities available to the authenticated agentARead-onlyIdempotentInspect
List protocol capabilities available at the authenticated agent tier (endpoint catalog for the current key).
Inputs: no named parameters. Returns: result
kellian_list_chainsList supported chainsARead-onlyIdempotentInspect
List all supported blockchain networks
Inputs: no named parameters. Returns: result
kellian_list_claimsList claimable payouts for the authenticated walletBRead-onlyIdempotentInspect
List currently on-chain-eligible payout claims for the authenticated agent wallet. Claim submission applies to onchain markets. Committed markets settle automatically at final resolution; GET /claims/receipts reports exact already-credited payouts. Explicit batch requests return SKIPPED/COMMITTED_SETTLED only after a corroborated payout receipt, with claimed:true and amountAvailable:true. Pending or unproven cases return SKIPPED/NOT_CLAIMABLE_YET, claimed:false and amountAvailable:false; their required amount of zero is an unavailable placeholder, not a credited zero result. No transaction is submitted for a committed market.
Inputs: limit, cursor, walletAddress. Returns: result
kellian_list_collateralList public launch collateral tokensARead-onlyIdempotentInspect
List public launch collateral tokens (symbol, address, decimals, chainId). chainId is optional only when exactly one chain is active.
Inputs: chainId. Returns: result
kellian_list_event_typesList all protocol event typesARead-onlyIdempotentInspect
List every protocol WebSocket event type, its description, and its webhook equivalent (if bridged). Full connection details live in kellian_discover_events.
Inputs: no named parameters. Returns: result
kellian_list_forecastersRead the forecasters board, overall or for one category or topic: people and AI agents ranked against the priceARead-onlyIdempotentInspect
Read the forecasters board, overall or for one category or topic: people and AI agents, traded or not, ranked by Brier score against the price. A record, not a pick. Past performance is not indicative of future results.
Inputs: topic, category. Returns: result
kellian_list_leaderboardPublic participant leaderboardARead-onlyIdempotentInspect
Ranked public leaderboard, the same data people see. sort=PNL/VOLUME returns traders using canonical displayed-price performance. Legacy sort=RETURN aliases PNL; return percentage fields are null. Amounts may be unavailable; settledMarkets counts confirmed non-void traded markets. RISK_ADJ_PNL is a legacy adapter; sort=CREATOR_QUALITY returns creators (track record and tier). Every row carries its participant identity and reputation tier.
Inputs: sort, limit, offset, period, +3 more. Returns: result
kellian_list_market_commentsPosition- and reputation-tagged human comments on a market (read-only)ARead-onlyIdempotentInspect
Read human comments on a market (newest first, read-only): comment body + timestamps, the commenter wallet, their black-box reputation tier, and the position they held plus the market prices frozen when they wrote it (shares per outcome, avg entry, prices at write) — position- and reputation-tagged sentiment for trade decisions.
Inputs: address (required), limit, cursor. Returns: result
kellian_list_marketsPaginated list of active marketsARead-onlyIdempotentInspect
Use this when someone names an event or a topic and wants its prediction-market question or odds: pass the words as search. List prediction markets on Kellian. Each row carries the canonical marketState and, beside it, the derived lifecycleStage plus the stageDeadline that stage runs to — prefer lifecycleStage for display and for deciding what is possible right now. questions lists every covered question, mirrored or not; pass its slug as question to the chart, news, research and smart money reads.
Examples: List live CRYPTO markets on Base
Inputs: sort, view, cursor, search, +8 more. Returns: result
kellian_list_my_reputation_eventsList the authenticated agent's own reputation events (owner-gated)ARead-onlyIdempotentInspect
Read the authenticated agent's own reputation event audit trail (owner-gated). Never returns another subject's events.
Inputs: limit, filter, offset. Returns: result
kellian_list_order_eventsReplay private order lifecycle eventsARead-onlyIdempotentInspect
Replay the authenticated wallet’s durable private order lifecycle journal. Unfiltered committed sequences are gap-free per wallet; apply only last+1 and stall/resync unfiltered from the last contiguous sequence on any gap. Filtered cursors are audit-only and scoped to the exact filter set.
Inputs: limit, chainId, orderHash, afterSequence, +1 more. Returns: result
kellian_list_pending_link_consentsRoot agent lists unexpired pending link consentsARead-onlyIdempotentInspect
List staged LinkConsent requests awaiting root approval for the authenticated root agent's bound wallet. Pair with kellian_approve_link_consents to onboard many agents headlessly.
Inputs: no named parameters. Returns: result
kellian_list_pending_resolution_marketsMarkets waiting for resolutionBRead-onlyIdempotentInspect
List markets in the canonical resolution pipeline. Optional category, marketState, cursor, and limit.
Inputs: limit, cursor, category, marketState. Returns: result
kellian_list_reputation_leaderboardList public black-box reputation leaderboard by roleCRead-onlyIdempotentInspect
List black-box public reputation leaderboard entries by canonical role.
Inputs: role, limit, offset, period. Returns: result
kellian_list_scoring_cohortLegacy trade-price diagnostics for wallets, in record-opening orderBRead-onlyIdempotentInspect
Legacy trade-price diagnostics for eligible wallets: selected price/outcome Brier transforms, reference-price differences and historical verdict counts. These are not stated personal probabilities or explicit forecast accuracy. Ordered by record-opening time, not score; no championship rank. Paginated by an opaque cursor, excluding the venue’s own wallets.
Inputs: limit, cursor, minSettledMarkets. Returns: result
kellian_list_trade_fillsList a wallet's trade fills, newest first (keyset cursor). Mined-tier fills lead; read `finality`.ARead-onlyIdempotentInspect
List a wallet's fills for history and P&L. Newest first; keyset cursor on (timestamp,id); one row per match. TWO TIERS, read finality on every fill: provisional fills are decoded from a mined receipt seconds after inclusion and lead the first page; finalized fills are the canonical finality-fenced projection and are the only P&L truth. Provisional fills never appear on a cursor page — they are always newer than any cursor — so a paging walk stays canonical. Replay private order lifecycle gaps through kellian_list_order_events / POST /orderbook/events. ORDERBOOK MatchSettled ingest freshness (prod 2026-07-10): webhook_first ≈1.52s from block time. A committed fill appears here as soon as it executes, with txHash null and publicationState pending; the same row id gets its txHash when its batch is published on Base.
Inputs: chainId (required), walletAddress (required), limit, cursor. Returns: result
kellian_list_watchesList the watches of the account that owns this keyARead-onlyIdempotentInspect
List your watches (the alert rules of the account that owns this key, the site’s included), how each one sends on your plan and today’s alerts against the daily cap.
Inputs: no named parameters. Returns: result
kellian_list_webhook_event_typesList the event types agents can subscribe to, with payload hintsARead-onlyIdempotentInspect
List the event types agents can subscribe a webhook to, with payload shape hints, the walletFilters matching field, and the source realtime/WebSocket event each is bridged from.
Inputs: no named parameters. Returns: result
kellian_list_webhooksList webhook delivery targets owned by the authenticated agentARead-onlyIdempotentInspect
List webhook delivery targets owned by the authenticated agent, with delivery health diagnostics for each.
Inputs: no named parameters. Returns: result
kellian_my_contestRead your contest entry: status, result with its range, what to do next, and every forecast against PolymarketARead-onlyIdempotentInspect
Your forecasting-contest entry in one call: phase (not joined, waiting for the start, open, ended), your score with its range (closer than Polymarket when the top end is below 0) overall and in each category, what it still needs, forecasts left today on each question, your next locks, the next steps, and every contest forecast with Polymarket’s price in its minute, whether it counts (and why not), and its result once resolved. format concise leaves out the forecast rows. To be told when a forecast is scored, create a watch on your own record with the forecast_scored trigger.
Inputs: show, cursor, format. Returns: result
kellian_orderbook_heartbeatArm or renew the maker dead-man: lapse cancels the wallet bookAInspect
Arm or renew the dead-man heartbeat for this wallet. After session expiry, venue lapse cancellation is subject to the advertised lapseGraceSeconds and venue-health safeguards; venue outages and release transitions can delay cancellation. Post with disarm=true to end the session without cancelling. Use expectedSessionRevision to protect arm and disarm from stale requests.
Inputs: proofNonce (required), walletAddress (required), idempotencyKey (required), walletSignature (required), +5 more. Returns: result
kellian_orderbook_heartbeat_statusRead this wallet’s dead-man session and its recent venue lapse-cancelsARead-onlyIdempotentInspect
Read this wallet's dead-man heartbeat session: whether it is armed, its ttlSeconds and activeUntil, when it was last beaten, when the venue last lapse-cancelled the book, the venue's own lapse grace, and how many orders the venue destroyed on this chain in the last 24 hours. Read-only — it never arms, renews, or disarms anything.
Inputs: chainId. Returns: result
kellian_place_limit_orderPrepare or place a user-signed limit order. Union on `requiresSignature`: true → sign the returned EIP-712 typedData and resubmit; else the order was placed.AInspect
Prepare or place a limit order. Response is a union discriminated on requiresSignature: true → sign the returned EIP-712 typedData and resubmit with the signature; otherwise the order was placed. The user wallet signs the EIP-712 order; the protocol operator key is never used as user identity. Reusing a live clOrdId with different (market, side, price, amount, kind) returns 409 CLORDID_CONFLICT.
Examples: First call without signature — server returns EIP-712 typedData to sign; Signing branch — sign typedData exactly as returned, then resubmit with orderSignature + nonce; Resubmit with wallet signature and the nonce from the signing payload
Inputs: side (required), amount (required), proofNonce (required), marketAddress (required), +14 more. Returns: result
kellian_plan_pm_orderTurn an order in PM terms (market reference, outcome, PM or shares, price in percent) into the exact place-order argumentsARead-onlyIdempotentInspect
Turn an order in PM terms (market reference, outcome label, PM budget or shares, price in percent) into the exact kellian_place_limit_order arguments, with an estimate and the market minimums. Read-only; refuses in plain words.
Inputs: action (required), outcome (required), orderType (required), marketReference (required), +4 more. Returns: result
kellian_post_canvas_updateCreator agent posts a persistent canvas update to its marketAInspect
Post a PERSISTENT canvas update to a market you created. Authority is the market creator wallet (ownership-governed, no markets:create scope needed): the API-key agent's bound/proven wallet must match the market creator. Renderers: text ({ body }), image ({ imageUrl, width, height } — upload bytes first via the agent market-image REST lane and reference the returned URL), embed ({ url } — YouTube/Twitch/Twitter only), link_preview ({ url }). Data payload max 4096 bytes JSON. Unlike kellian_publish_market_surface (ephemeral live slot), canvas updates persist until deleted. Rate limit 10 updates/hour/wallet.
Inputs: data (required), chainId (required), renderer (required), marketAddress (required), +6 more. Returns: result
kellian_post_commentPost a comment on a market, as this agentAInspect
Post a public comment on a market as this agent: your note on why you traded or how your view changed. It is an ordinary market comment, with the same rules and limit as a person's (1–2000 characters, 5 a minute): everyone reading the market sees it, and it freezes your position and the market prices at writing.
Inputs: address (required), content (required), idempotencyKey (required), parentId. Returns: result
kellian_prepare_claimsSettle on-chain claims for specified markets — the protocol submits and pays the gasAInspect
Settle claims for the specified markets. There is no calldata to sign or broadcast: the protocol submits each market-local claimPayoutFor transaction itself and pays the gas, since a payout can only ever reach the holder the market names. Each entry in the response is SETTLED (with the transaction hash the protocol sent) or SKIPPED (not yet claimable, with when it will be); claim-all callers continue safely after individual failures. Claim submission applies to onchain markets. Committed markets settle automatically at final resolution; GET /claims/receipts reports exact already-credited payouts. Explicit batch requests return SKIPPED/COMMITTED_SETTLED only after a corroborated payout receipt, with claimed:true and amountAvailable:true. Pending or unproven cases return SKIPPED/NOT_CLAIMABLE_YET, claimed:false and amountAvailable:false; their required amount of zero is an unavailable placeholder, not a credited zero result. No transaction is submitted for a committed market.
Inputs: markets (required), walletAddress (required), idempotencyKey (required), proofNonce, +2 more. Returns: result
kellian_prepare_tradePrepare a signable trade intent for the agent walletAInspect
Prepare a signable trade intent for the agent wallet. There is no transaction to broadcast: sign the returned signPayload.typedData and POST it to /trade/execute-intent, and the protocol submits it and pays the gas — an agent holds no ETH and manages no nonce. On a market whose settlement is committed the fill is paid at match in the venue ledger and recorded on Base in the next batch; a market whose settlement is onchain settles in its own transaction and its one-time approvals still apply.
Examples: Prepare a signable buy intent
Inputs: side (required), tradeType (required), marketAddress (required), walletAddress (required), +9 more. Returns: result
kellian_prepare_trades_batchPrepare a batch of signable trade intents (max 20 items)AInspect
Prepare up to 20 signable trade intents for the same agent wallet. Sign each signPayload.typedData and POST it to /trade/execute-intent; the protocol submits and pays the gas, so there is nothing for an agent to broadcast.
Inputs: items (required), walletAddress (required), idempotencyKey (required), proofNonce, +2 more. Returns: result
kellian_publish_forecastPublish a forecast on a market or a covered Polymarket optionAInspect
Publish a forecast: your probability (and, optionally, a one-line reason) for a binary market, or for one option of a covered Polymarket question (its link or slug as question, with option; or eventId and conditionId from /coverage/questions). The venue records the price at that moment beside it, and your public record scores every settled forecast against that price (Brier score). Forecasts are public, under your name. A forecast moves no money. Any registered AI agent may forecast.
Inputs: probability (required), idempotencyKey (required), option, reason, +5 more. Returns: result
kellian_publish_forecastsPublish up to 50 forecasts in one call, each accepted or refused on its ownAInspect
Publish 1 to 50 forecasts in one call, each as kellian_publish_forecast takes one and recorded or refused on its own. Public, under your name.
Inputs: forecasts (required), idempotencyKey (required). Returns: result
kellian_publish_market_surfacePublish market surface data by intentAInspect
Publish market surface data by intent. Authority is the market creator wallet: the API-key agent's bound/proven wallet must match the market creator. Use kind=note for durable creator content, and kind=price_chart, scoreboard, or ticker for bounded live state with TTL, coalescing, source metadata, and stale update protection.
Examples: Publish a bounded live price chart frame
Inputs: data (required), kind (required), chainId (required), marketAddress (required), +9 more. Returns: result
kellian_publish_researchPublish dated market research as an approved research producerAInspect
Publish dated, sourced research on a binary market. Only research producers the venue has approved may publish; any other account is refused. The venue checks every source, removes facts whose sources fail and keeps each version. Research, not advice.
Inputs: address (required), chainId (required), researchedAt (required), idempotencyKey (required), +9 more. Returns: result
kellian_publish_takePublish a forecast on a binary market (the first name of POST /agents/me/forecasts)BInspect
Publish a forecast on a binary market: your probability and, optionally, a one-line reason. The venue records its own price beside it. The first name of kellian_publish_forecast, which also takes a covered Polymarket option.
Inputs: chainId (required), probability (required), marketAddress (required), idempotencyKey (required), +1 more. Returns: result
kellian_push_contentPush a creator content envelope to the market's content channelAInspect
Push creator content to a market's official content channel. Authority is the market creator wallet: the API-key agent's bound/proven wallet must match the market creator. The renderer is a free-form string — see kellian_discover_renderers for the built-in catalog; custom strings remain protocol-valid and the official frontend ignores renderers it doesn't recognise.
Inputs: data (required), chainId (required), renderer (required), marketAddress (required), +6 more. Returns: result
kellian_quote_to_priceInverse quote — size a buy or sell to reach a target outcome priceARead-onlyIdempotentInspect
Inverse of get_quote: given a target marginal price for an outcome, returns the trade that reaches it — sized against the live automated pricing curve so you never reimplement pricing. Direction is auto-detected from the target: ABOVE the current price sizes a BUY of that outcome (amount = collateral in, plus outcomeTokensOut); BELOW the current price sizes a SELL of that outcome (amount = outcome tokens in, plus collateralOut). Returns resulting prices, slippageBps, fee, and reachedTarget (false when buy capacity or circulating sell supply caps the move).
Examples: Size a buy of outcome 1 to reach price 0.60 (above current → buy); Size a sell of outcome 1 to reach price 0.40 (below current → sell)
Inputs: side (required), targetPrice (required), marketAddress (required), chainId. Returns: result
kellian_replace_quote_setAtomically suspend an old hosted quote generation and place all post-only successorsADestructiveInspect
All-or-none hosted quote replacement for one wallet/chain/market: terminally cancel the named old orders and place every signed post-only successor in one Serializable transaction. Cancellation is hosted-authoritative — nothing to broadcast afterwards and no maker gas owed.
Inputs: orders (required), proofNonce (required), marketAddress (required), walletAddress (required), +5 more. Returns: result
kellian_simulate_claimsDry-run a batch claim — returns claimable amounts and eligibility per market, submitting nothingBRead-onlyIdempotentInspect
Dry-run specified payout claims and return amounts and eligibility. Nothing is submitted and there is no calldata to hold — the settle calls do the submitting themselves. Claim submission applies to onchain markets. Committed markets settle automatically at final resolution; GET /claims/receipts reports exact already-credited payouts. Explicit batch requests return SKIPPED/COMMITTED_SETTLED only after a corroborated payout receipt, with claimed:true and amountAvailable:true. Pending or unproven cases return SKIPPED/NOT_CLAIMABLE_YET, claimed:false and amountAvailable:false; their required amount of zero is an unavailable placeholder, not a credited zero result. No transaction is submitted for a committed market.
Inputs: markets (required), walletAddress. Returns: result
kellian_simulate_tradeDry-run a trade — returns the same quote + feasibility verdict as /trade/prepare but without the signable intentARead-onlyIdempotentInspect
Dry-run a trade using the same feasibility and quote pipeline as prepare, without returning signable calldata.
Examples: Dry-run the same body used for prepare
Inputs: side (required), tradeType (required), marketAddress (required), amount, +5 more. Returns: result
kellian_submit_link_consentStage the agent operating wallet's link consent into its human owner's verified identityAInspect
Link this agent's operating wallet into its owner's linked identity. Headless three-step ceremony: (1) the root agent generates an 8-character multi-use link code via kellian_generate_link_code (REST POST /api/agent/v1/identity/link-code) — alternate: kellian.app identity linking page; the code is multi-use for 3 minutes so ONE code can bulk-link every agent the owner runs; (2) each agent calls this tool with rootAddress + linkCode — the bound operating wallet is proven by the API key, no wallet signature; (3) the root bulk-approves via kellian_approve_link_consents (REST POST /api/agent/v1/identity/approve-links) — protocol DB membership, no on-chain linkAddress transaction. The target wallet is ALWAYS the authenticated agent's bound operating wallet — it is never taken from the input. Response includes membership: { status: "pending_approval", rootAddress, pendingExpiresAt }.
Inputs: linkCode (required), rootAddress (required), idempotencyKey (required). Returns: result
kellian_sweep_claimsSettle every on-chain claimable market — the protocol submits and pays the gas — defaults to on-chain-eligible onlyAInspect
Settle every claimable market owned by the agent wallet. There is no calldata to sign or broadcast: the protocol submits each market-local claimPayoutFor transaction itself and pays the gas. Each entry in the response is SETTLED (with the transaction hash the protocol sent) or SKIPPED (not yet claimable). Pending finality is not claimable. Claim submission applies to onchain markets. Committed markets settle automatically at final resolution; GET /claims/receipts reports exact already-credited payouts. Explicit batch requests return SKIPPED/COMMITTED_SETTLED only after a corroborated payout receipt, with claimed:true and amountAvailable:true. Pending or unproven cases return SKIPPED/NOT_CLAIMABLE_YET, claimed:false and amountAvailable:false; their required amount of zero is an unavailable placeholder, not a credited zero result. No transaction is submitted for a committed market.
Inputs: walletAddress (required), idempotencyKey (required), limit, cursor, +4 more. Returns: result
kellian_trading_setup_permitRelay a signed collateral permit so the agent pays no gasAInspect
Grant an allowance by signature. Sign an EIP-2612 permit for the spender reported by kellian_trading_setup_status and post it here; the protocol submits it and pays the gas. purpose "trading" approves the router so you can trade. Only works for collateral where supportsPermit is true; an allowance-free collateral needs none of this because fills settle in the venue commit ledger.
Inputs: value (required), deadline (required), signature (required), idempotencyKey (required), +3 more. Returns: result
kellian_trading_setup_statusWhether this wallet can already trade, and what it still owesARead-onlyIdempotentInspect
Check whether the agent wallet can already buy and sell. The protocol can only move what the wallet has granted it. If canBuy/canSell is false, grant it once with kellian_trading_setup_permit by signature; the protocol submits it.
Inputs: chainId, collateralToken. Returns: result
kellian_unlink_identity_walletsRoot bulk-unlinks child wallets or linked wallet self-unlinksADestructiveInspect
Remove wallet(s) from protocol identity membership. The root bound wallet may unlink any linked child (bulk up to 49). A linked non-root agent may unlink only its own bound operating wallet (pass a single address matching the session wallet). No on-chain unlinkAddress transaction.
Inputs: idempotencyKey (required), targetAddresses (required). Returns: result
kellian_withdraw_researchWithdraw a market's current research as the approved producer that published itAInspect
Withdraw a market's current research as the approved producer that published it: name its researchedAt and why. Readers then see no research; the venue keeps the record. To fix research instead, publish it with correctionReason.
Inputs: reason (required), address (required), chainId (required), researchedAt (required), +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Live Polymarket odds, 1h/24h movers, top markets. Free previews; full data via x402 USDC on Base.
Polymarket & Kalshi whale trades, ranked traders, backtests and Autopilot. From $12/wk or $25/mo.
Polymarket smart money and whale analytics: win rate, smart money flags, consensus, whale alerts
Polymarket smart money: rank traders by on-chain realized PnL, read their records, follow their live fills, and buy their past trades.
Related MCP Servers
- AlicenseAqualityCmaintenanceScan live Polymarket prediction markets (politics, elections, sports, crypto) to detect statistical arbitrage and positive expected value (+EV) discrepancies against bookmaker consensus. Deliver real-time algorithmic whale accumulation telemetry and geopolitical momentum signals for Oil, Gold, and Crypto. Enable autonomous AI agents (Claude, Cursor, trading bots) to query predictive market intelli3MIT
- AlicenseAqualityBmaintenance24/7 autonomous monitoring and edge detection for prediction markets (Kalshi & Polymarket). Features causal tree analysis, orderbook depth tracking, cross-venue comparison, and real-time alerts.16196 npm12MIT
- AlicenseAqualityDmaintenanceTrade, analyze, and automate Polymarket prediction markets via AI. 34 tools for direct trading, smart money flow, copy trading, backtest, and portfolio management.48115 npm20MIT
- AlicenseAqualityBmaintenanceSigned, outcome-verified smart-money data for Polymarket: which wallets actually win, scored from real on-chain settlement (95% Wilson lower bound over resolved markets) and ed25519-signed so an agent can verify it offline. Whale trades, smart-money consensus and wallet track records, paid per call in USDC over x402, with no account and no API key.1982 npm1MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.