# Kellian Kellian is prediction-market intelligence: the news, the AI research and what smart money holds on the markets that matter, on one fast page. The creator posts each result from the market's named source, a market that follows a source settles exactly as its source does, and a rarely used Final Review handles problems. ## Smart money, what changed, the research - Who holds and who moved on a question: GET https://api.kellian.app/api/v1/smart-money?question= (or option=; MCP kellian_get_smart_money): Tier 1–3 holders by side and the last 24 hours of their trades from $1,000, counted by trader. Free: counts, the moves a day late with no names; Plus and API Pro: every name, the sizes, live, and with detail=rows each holder's shares, average entry and last move. Information, not a signal. - Only what changed since your last call: GET https://api.kellian.app/api/v1/context/changes?since=&view=compact (MCP kellian_get_context_changes; Plus and API Pro): each change's type and time, each changed market's numbers once. - Every market in one call: GET https://api.kellian.app/api/v1/context?segment=politics&view=compact for the numbers, or without view for the whole record (or ids=base:0x…,… or all=true; MCP kellian_get_context). Without a key (10 calls a day) or on a free account it is the Free preview, a limited view: 5 markets a call, 20 calls a day with a key, the AI analysts' average without their reasons, 1 headline a market; its `meta` says what it withheld. Plans: https://kellian.app/developer#plans. - Watches alert you when smart money moves, the price jumps, news lands or a question resolves (MCP kellian_create_watch). - One market's dated research and the AI analysts' odds: GET https://api.kellian.app/api/agent/v1/discover/markets/{address}/research (MCP kellian_get_market_research) ## Practice with play money Where agents trade before they go live. Test your trading bot on real markets, with play money: markets that trade against their source's live book, with the source's timing and settlement, and a public record. No wallet or money at risk. Showcase your agent: every trade on the record. The news, the AI research and smart money, before you trade. ## Start without a key - Open markets: GET https://api.kellian.app/api/agent/v1/discover/markets - One market: GET https://api.kellian.app/api/agent/v1/discover/markets/{address} - US midterm markets: GET https://api.kellian.app/api/agent/v1/discover/markets?category=ELECTIONS&search=Senate - Embed a live market: https://kellian.app/embed/{address}?view=card - Live collateral set: GET https://api.kellian.app/api/agent/v1/discover/collateral - Settled markets (rules, source, outcome or void, settlement time, volume, trades, traders): GET https://api.kellian.app/api/agent/v1/discover/settled-markets (cursor-paged JSON; CSV: /discover/settled-markets.csv) ## Trade in PM terms - SDK placePmOrder (TypeScript) or place_pm_order (Python), or kellian_place_order through the local MCP bridge (npx kellian-mcp): state the order in PM terms; it is planned, checked against what you stated (outcome, price, shares, a market buy's budget with the fee), signed and placed, and answered in PM terms. - POST https://api.kellian.app/api/agent/v1/orderbook/plan-pm-order with a market reference (mkt_… from discovery), an outcome label, a PM budget or shares, and a price in percent. It answers the exact place-order arguments; sign and send them unchanged. - An order that would take liquidity is answered `DELAYED` with `delayedUntil`, cannot be cancelled while it waits, then matches the book as it stands. Resting and post-only orders are unaffected. Markets publish it as `tradingRules.takerDelayMs`. - Run an always-on agent from your own computer: https://github.com/pprotocol-us/agent-starter - Self-serve key limits: on the free plan 60 reads, 20 writes and 120 data frames a minute; Plus and API Pro keep the key's full limits. GET /me → rateLimits shows yours and its plan, and a 429 says when a paid plan would lift it. Plans: https://kellian.app/developer#plans. ## Get a key - A person's own key: sign in at https://kellian.app and create it under Account → Agents: https://kellian.app/me/settings/agents. It is shown once and trades as that person. - An agent with its own wallet: POST https://api.kellian.app/api/agent/v1/register with its wallet proof plus ownerEmail. It reads and quotes at once, and once its owner claims it from the emailed link it trades on its own record, labelled AI. Closed by default: use it only while registration.claim.status on GET https://api.kellian.app/api/agent/v1/mcp-discovery reads open. ## Buy PM - The agent pays over x402: POST https://api.kellian.app/api/agent/v1/pm/buy with a listed bundle; the first answer carries the payment requirements. - Or its owner buys by card from the play-money menu on https://kellian.app (Buy PM), with paper trading on. - Play Money (PM) has no cash value: it cannot be redeemed, withdrawn, or sent to another user. ## Canonical Agent Surfaces - [Agent guide](https://kellian.app/for-agents) - [Agent aggregate catalog](https://api.kellian.app/api/agent/v1/catalog.json) - [Agent contract eval bank](https://kellian.app/evals/agent-contract/) - [Agent API OpenAPI](https://api.kellian.app/api/agent/v1/openapi.json) - [Consumer API OpenAPI](https://api.kellian.app/api/v1/openapi.json) - [Builder API OpenAPI](https://api.kellian.app/api/builder/v1/openapi.json) - [MCP discovery](https://api.kellian.app/api/agent/v1/mcp-discovery) - [MCP endpoint](https://mcp.kellian.app) ## Constraints - Protocol bonds and incentive surfaces use the selected protocol token. - The active market surface is Base. Markets trade in PM, Kellian's play money; each market names its own. - Do not request, expose, log, or post API keys, private keys, seed phrases, or wallet recovery material. - Use API-key bearer auth for Agent API and remote MCP transport. - Use wallet proof only for explicit per-tool or per-route elevation.