{
  "markdown": "# Event Resolver API\n\n[![MCP Server](https://img.shields.io/badge/MCP-server-blue)](https://event-resolver.api.klymax402.com/mcp)\n[![x402](https://img.shields.io/badge/payments-x402-6E56CF)](https://x402.org)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n\nResolve prediction market events with confidence scores. Aggregates news, price feeds, and web data to determine if real-world events occurred. Settlement oracle for binary, numeric, and categorical outcomes. Pay-per-call via [x402](https://x402.org) (USDC on Base L2) -- no API key, no signup, no rate-limit wall.\n\nPart of the [klymax402](https://klymax402.com) marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.\n\n## Quickstart -- MCP\n\nAdd to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"event-resolver\": {\n      \"url\": \"https://event-resolver.api.klymax402.com/mcp\"\n    }\n  }\n}\n```\n\n## Quickstart -- HTTP (x402)\n\n```bash\ncurl -X POST \"https://event-resolver.api.klymax402.com/api/resolve\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"question\":\"...\"}'\n# -> 402 Payment Required, with an x402 payment challenge in the response body\n```\n\nAny x402-aware client ([`@x402/fetch`](https://www.npmjs.com/package/@x402/fetch), [`x402-agent-tools`](https://www.npmjs.com/package/x402-agent-tools), ATXP) handles the 402 -> sign -> retry cycle automatically.\n\n## Tools\n\n| Tool | Method | Path | Price | Description |\n|---|---|---|---|---|\n| `event_resolve_outcome` | POST | `/api/resolve` | $0.012 | Resolve a prediction market event/question. Aggregates multiple data sources to determine outcome with confidence score. |\n| `event_verify_claim` | POST | `/api/verify` | $0.008 | Quick-verify a factual claim. Returns verdict (true/false/unverifiable) with confidence and evidence. |\n| `event_check_price_threshold` | POST | `/api/price-check` | $0.005 | Check if a crypto/stock price crossed a threshold. Common prediction market resolution pattern. |\n\n### `event_resolve_outcome`\n\nUse this when you need to determine the outcome of a real-world event for prediction market settlement. Takes a natural language question (e.g. \"Did BTC reach $100K?\", \"Did France win the 2026 World Cup?\") and returns a structured resolution with confidence score.\n\n**Parameters**\n\n| Name | Type | Required | Description |\n|---|---|---|---|\n| `question` | string | yes | The event question to resolve, e.g. 'Did BTC reach $100K by April 2026?' or 'Did the Lakers win the NBA Finals 2026?' |\n| `type` | string | no | Type of resolution expected. binary = Yes/No, numeric = a number, categorical = one of several options. Default: binary. |\n\n**Returns**\n\n- `question` -- the original question being resolved\n- `resolved` -- whether the event can be conclusively determined (true/false)\n- `outcome` -- the determined result -- \"Yes\"/\"No\" for binary, a number for numeric, or a category string\n- `confidence` -- 0-100 score indicating certainty of the resolution\n- `sources` -- array of data sources consulted, each with name, url, and whether it agrees with the outcome\n- `timestamp` -- ISO timestamp of when the resolution was performed\n\nExample response:\n\n```json\n{ \"question\": \"Did BTC reach $100K?\", \"resolved\": true, \"outcome\": \"Yes\", \"confidence\": 95, \"sources\": [{ \"name\": \"CoinGecko\", \"url\": \"https://coingecko.com\", \"agrees\": true }], \"timestamp\": \"2026-04-13T12:00:00Z\" }\n```\n\n**Not for**: prediction market odds (use `prediction_list_markets`), crypto prices only (use `token_get_price`), full fact checking with sources (use `research_check_fact`), trust/security scoring (use `trust_score_evaluate`).\n\n### `event_verify_claim`\n\nUse this when you need to quickly verify whether a factual claim is true or false. Simpler and cheaper than full event resolution -- designed for fast claim checking without structured market settlement.\n\n**Parameters**\n\n| Name | Type | Required | Description |\n|---|---|---|---|\n| `claim` | string | yes | The factual claim to verify, e.g. 'Bitcoin is above $90,000' or 'The US unemployment rate is below 4%' |\n\n**Returns**\n\n- `claim` -- the original claim being verified\n- `verdict` -- \"true\", \"false\", or \"unverifiable\" if insufficient data\n- `confidence` -- 0-100 score indicating certainty of the verdict\n- `evidence` -- array of strings summarizing supporting or contradicting evidence found\n\nExample response:\n\n```json\n{ \"claim\": \"Tesla stock is above $300\", \"verdict\": \"true\", \"confidence\": 90, \"evidence\": [\"CoinGecko/financial APIs confirm current price above threshold\", \"Multiple news sources corroborate\"] }\n```\n\n**Not for**: prediction market odds (use `prediction_list_markets`), full fact checking with sources (use `research_check_fact`), stock prices (use `stock_get_quote`), crypto prices only (use `token_get_price`).\n\n### `event_check_price_threshold`\n\nUse this when you need to check if a cryptocurrency or stock price has crossed a specific threshold -- the most common resolution type in prediction markets. Returns current price, whether threshold was crossed, and direction.\n\n**Parameters**\n\n| Name | Type | Required | Description |\n|---|---|---|---|\n| `asset` | string | yes | Asset name or CoinGecko ID (e.g. 'bitcoin', 'ethereum', 'solana', 'dogecoin') |\n| `threshold` | number | yes | Price threshold in USD to check against |\n| `direction` | string | yes | Whether to check if price is above or below the threshold |\n\n**Returns**\n\n- `asset` -- the asset being checked (e.g. \"bitcoin\", \"ethereum\", \"solana\")\n- `currentPrice` -- the current price in USD from CoinGecko\n- `threshold` -- the target price threshold\n- `direction` -- \"above\" or \"below\" -- which direction constitutes crossing\n- `crossed` -- boolean indicating whether the price has crossed the threshold in the specified direction\n\nExample response:\n\n```json\n{ \"asset\": \"bitcoin\", \"currentPrice\": 102450.23, \"threshold\": 100000, \"direction\": \"above\", \"crossed\": true }\n```\n\n**Not for**: crypto prices only (use `token_get_price`), prediction market odds (use `prediction_list_markets`), stock prices (use `stock_get_quote`), trust/security scoring (use `trust_score_evaluate`).\n\n## Example agent prompts\n\n- \"Determine the outcome of a real-world event for prediction market settlement\"\n- \"Quickly verify whether a factual claim is true or false\"\n- \"Check if a cryptocurrency or stock price has crossed a specific threshold -- the most common resolution type in prediction markets\"\n\n## Payment\n\n- Protocol: [x402](https://x402.org) -- HTTP-native pay-per-call, no signup, no API key\n- Network: Base L2 (`eip155:8453`)\n- Asset: USDC\n- Facilitator: Coinbase CDP (primary), PayAI (fallback)\n- Also reachable via [ATXP](https://atxp.ai) (OAuth-wrapped x402, RFC 9728 protected-resource metadata)\n\n## Part of klymax402\n\n100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.\n\n- Catalog: https://klymax402.com/llms.txt\n- Full API reference: https://klymax402.com/llms-full.txt\n- Live stats: https://klymax402.com/stats\n\n## License\n\nMIT\n",
  "bytes": 7037,
  "sha": "c339f8b1585f3a7523fead9b05c4b9c57bd74d955d6c0c3cec4f2f4557827809",
  "repo_slug": "br0ski777/event-resolver-x402",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_br0ski777_event_resolver_d5d026be/readme"
}