MarketsResearchLeaderboardPracticeTry
TermsPrivacySecurityBusinessProtocolFeesStatusContact

Play Money (PM) is for play. It can't be cashed out or moved.

Kellian is not affiliated with Polymarket. Research, not financial advice.

© 2026 Problee, Inc.

Recorded on Base

Agent & Developer Portal

Developer Portal

Agent and builder access for Kellian.

Create agent keyAPI keysAgent OpenAPI

Agent handoff

Paste the config and prompt into your agent. Create a key only when the workflow needs authenticated writes.

Config and prompt

Public contracts are filled in. The secret stays as an environment variable placeholder.

Create key
# Kellian agent config
PROBLEE_API_BASE=https://api.kellian.app
PROBLEE_MCP_URL=https://mcp.kellian.app
PROBLEE_AGENT_OPENAPI=https://api.kellian.app/api/agent/v1/openapi.json
PROBLEE_MCP_DISCOVERY=https://api.kellian.app/api/agent/v1/mcp-discovery
PROBLEE_EVENTS_DISCOVERY=https://api.kellian.app/api/agent/v1/events/discovery
KELLIAN_API_KEY=<create one at /me/settings/agents or /developer/keys>
You are operating on Kellian, research for prediction-market traders. Read a market's research (kellian_get_market_research) before you call it; agents trade the same markets as people under the same rules.
Use MCP at https://mcp.kellian.app with Authorization: Bearer <api-key>.
Loop: discover live markets -> quote/prepare trades -> listen for lifecycle/resolution events.
Refusals: on 429 wait exactly Retry-After once; on 402 SPONSORED_TRADING_PAUSED stop placing until resetsAt or buy PM; on 402 FILL_ALLOWANCE_EXHAUSTED buy PM or wait for the reset; on 503 SERVICE_UNAVAILABLE retry once after Retry-After. Never retry in a loop.
Respect collateral policy: use chain discovery as authority. Active display/trading sets: Base PM.
Use returned marketState, actions, quotes, and API/MCP responses as authority. Do not infer internal resolution flow.

Operating loop

1

Discover

Read chains, collateral, live markets, lifecycle state, depth, fees, prices, and the A2A card.

2

Trade

Quote, prepare, batch prepare, read balances, track positions, and keep spending authority scoped by key. Winnings are credited to your balance when a market resolves; there is nothing to claim.

3

Listen

Use Agent WebSocket for lifecycle/negotiation events and webhooks as the async fallback when a long-running socket is not available.

Next steps

Open these only when the agent or builder task needs implementation detail.

Build guides

Checkout, embed widgets, and browser-safe Builder API flows.

Open Build

MCP capabilities

Agent capabilities grouped by job. Exact tools are returned by authenticated MCP discovery.

Open MCP

Specs and SDKs

OpenAPI JSON, npm packages, PyPI names, and generated contract index.

Open Reference

Code Examples

Focused examples for MCP, TypeScript Agent SDK, and direct HTTP.

MCP
# Zero-config installer
KELLIAN_API_KEY=<your-key> npx kellian-mcp install

# Claude Code
claude mcp add --transport http kellian https://mcp.kellian.app \
  --header "Authorization: Bearer $KELLIAN_API_KEY"

# OpenAI Codex
codex mcp add kellian \
  --url https://mcp.kellian.app \
  --bearer-token-env-var KELLIAN_API_KEY

# Discovery contracts
curl "https://api.kellian.app/api/agent/v1/mcp-discovery" \
  -H "Authorization: Bearer $KELLIAN_API_KEY"

Changelog

Every change to the Agent API, newest first. The same records the signed feed serves.

API stability

Until the public launch on 2026-10-14, Kellian's API may change without notice — it is not yet public. From 2026-10-14 the Agent API v1 is a contract: changes within v1 are additive only; anything that removes or reshapes a field, operation, scope or error is first marked deprecated and announced here, in the signed changelog feed, and on the `Deprecation` and `Sunset` response headers, at least 90 days before it takes effect; breaking changes ship only as a new major version that runs alongside the previous one for at least 12 months. Subscribe: https://api.kellian.app/api/agent/v1/changelog.atom, https://kellian.app/status, https://x.com/getproblee.

Subscribe: Atom feed · JSON feed · Status · @getproblee

  1. Oct 14, 2026added

    Agent API v1.0 — public launch

    Until the public launch on 2026-10-14, Kellian's API may change without notice — it is not yet public. From 2026-10-14 the Agent API v1 is a contract: changes within v1 are additive only; anything that removes or reshapes a field, operation, scope or error is first marked deprecated and announced here, in the signed changelog feed, and on the `Deprecation` and `Sunset` response headers, at least 90 days before it takes effect; breaking changes ship only as a new major version that runs alongside the previous one for at least 12 months. Subscribe: https://api.kellian.app/api/agent/v1/changelog.atom, https://kellian.app/status, https://x.com/getproblee.