{ "openapi": "3.1.0", "info": { "title": "Darrylbots Paid Research API", "version": "2026-06-27", "description": "Agent-readable paid research reports and micro-research from Darrylbots LLC, protected by x402 payments on Base.", "x-guidance": "Use the dedicated endpoints to buy Darrylbots structured JSON stock-screen reports, paid articles, and micro-research cards. Call a GET endpoint without payment to receive the x402 Payment Required challenge, complete payment, then retry with the payment response header. Research payloads are not financial, investment, tax, or legal advice.", "contact": { "name": "Darrylbots LLC", "email": "sales@darrylbots.com", "url": "https://darrylbots.com/contact.html" } }, "servers": [ { "url": "https://darrylbots.com" } ], "paths": { "/api/research-report-standard": { "get": { "operationId": "getStandardStockScreenReport", "summary": "Buy the Standard Stock Screen report", "description": "Returns the full structured JSON Standard Stock Screen report after x402 payment.", "tags": [ "Paid Research", "Stocks" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid report response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidResearchReportResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/research-report-abundance": { "get": { "operationId": "getAbundanceStockScreenReport", "summary": "Buy the Abundance Stock Screen report", "description": "Returns the full structured JSON Abundance Stock Screen report after x402 payment.", "tags": [ "Paid Research", "Stocks" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid report response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidResearchReportResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/research-report-hail-mary": { "get": { "operationId": "getHailMaryStockScreenReport", "summary": "Buy the Hail Mary Stock Screen report", "description": "Returns the full structured JSON Hail Mary Stock Screen report after x402 payment.", "tags": [ "Paid Research", "Stocks" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid report response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidResearchReportResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/research-report": { "get": { "operationId": "getStockScreenReportBySlug", "summary": "Buy a stock-screen report by slug", "description": "Returns one of the June 2026 structured JSON stock-screen reports after x402 payment. Prefer the dedicated report endpoints when possible.", "tags": [ "Paid Research", "Stocks" ], "parameters": [ { "name": "slug", "in": "query", "required": true, "description": "Darrylbots paid research report slug.", "schema": { "type": "string", "enum": [ "stock-screen-standard-2026-06", "stock-screen-abundance-2026-06", "stock-screen-hail-mary-2026-06" ] } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid report response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidResearchReportResponse" } } } }, "400": { "description": "Missing or invalid slug" }, "402": { "description": "Payment Required" } } } }, "/api/agent-article-martingale-mirage": { "get": { "operationId": "buyPolymarketChapter4MartingaleMirage", "summary": "Buy Polymarket book chapter 4", "description": "Returns the full structured JSON for Drift, Spread, and the Martingale Illusion, Chapter 4 after x402 payment.", "tags": [ "Paid Articles", "Polymarket" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid article response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidArticleResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/agent-article-regime-detection": { "get": { "operationId": "buyPolymarketChapter5RegimeDetection", "summary": "Buy Polymarket book chapter 5", "description": "Returns the full structured JSON for Drift, Spread, and the Martingale Illusion, Chapter 5 after x402 payment.", "tags": [ "Paid Articles", "Polymarket" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid article response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidArticleResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/agent-article-position-sizing": { "get": { "operationId": "buyPolymarketChapter6PositionSizing", "summary": "Buy Polymarket book chapter 6", "description": "Returns the full structured JSON for Drift, Spread, and the Martingale Illusion, Chapter 6 after x402 payment.", "tags": [ "Paid Articles", "Polymarket" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid article response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidArticleResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/resolvebots-x402-launch-seeding-intake": { "get": { "operationId": "buyResolveBotsX402LaunchSeedingIntake", "summary": "Buy ResolveBots x402 Launch Seeding paid intake", "description": "Returns the paid intake package for x402 sellers who want ResolveBots to register, test-buy, seed, and report on their paid API launch.", "tags": [ "Paid Services", "x402", "ResolveBots" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "49.000000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid ResolveBots service intake response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidResolveBotsServiceIntakeResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/agent-flow-radar-event": { "get": { "operationId": "buyAgentFlowRadarEvent", "summary": "Buy an Agent Flow Radar event verdict", "description": "Returns one derived options-flow event triage card after x402 payment. The product sells derived judgment and public-source context under Darryl's Unusual Whales side-letter commercial-use posture; it does not operate as a raw vendor-data proxy.", "tags": [ "Paid Research", "Options Flow", "Micro Research" ], "parameters": [ { "name": "ticker", "in": "query", "required": false, "description": "Ticker to generate a derived event verdict for. Defaults to TSLA.", "schema": { "type": "string", "default": "TSLA" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid Agent Flow Radar event response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidAgentFlowRadarEventResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/agent-flow-radar-summary": { "get": { "operationId": "buyAgentFlowRadarSummary", "summary": "Buy an Agent Flow Radar market-tone summary", "description": "Returns one GREEN/RED/MIXED market-tone estimate after x402 payment, derived from live Unusual Whales options-flow inputs across a broad ticker basket.", "tags": [ "Paid Research", "Options Flow", "Micro Research" ], "parameters": [ { "name": "tickers", "in": "query", "required": false, "description": "Optional comma-separated ticker basket. Defaults to broad market proxies and mega-cap leaders.", "schema": { "type": "string", "default": "SPY,QQQ,IWM,TSLA,NVDA,AAPL,MSFT,AMZN,META,GOOG" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid Agent Flow Radar market-tone summary response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidAgentFlowRadarSummaryResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/x402-coin-flip-demo": { "get": { "operationId": "buyX402CoinFlipDemo", "summary": "Buy a testnet x402 coin-flip demo receipt", "description": "Testnet-only coin-flip mechanics demo with verifiable SHA-256 outcome. No real-money prize, payout, refund, or wager.", "tags": [ "Agent Games", "x402", "Testnet" ], "parameters": [ { "name": "client_seed", "in": "query", "required": false, "description": "Optional client seed for the SHA-256 proof.", "schema": { "type": "string", "default": "agent-demo" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "testnet USDC", "amount": "0.001000" }, "network": "eip155:84532", "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid testnet coin-flip demo response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidX402CoinFlipDemoResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/agent-market-tone-challenge": { "get": { "operationId": "buyAgentMarketToneChallenge", "summary": "Buy an Agent Market Tone skill challenge receipt", "description": "Scores an agent GREEN/RED/MIXED prediction against the live market-tone calculation. Skill benchmark only; no random payout or automatic refund.", "tags": [ "Agent Games", "Paid Research", "Options Flow" ], "parameters": [ { "name": "prediction", "in": "query", "required": true, "description": "Agent prediction to score.", "schema": { "type": "string", "enum": [ "GREEN", "RED", "MIXED" ], "default": "GREEN" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid market-tone challenge receipt", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaidAgentMarketToneChallengeResponse" } } } }, "402": { "description": "Payment Required" } } } }, "/api/world-cup-prediction": { "get": { "operationId": "buyWorldCupPredictionReceipt", "summary": "Buy a World Cup agent prediction receipt", "description": "Returns a paid x402 prediction receipt for a Kalshi World Cup game event. This is a receipt/benchmark product only: no bet, prize pool, payout, refund, or gambling reward.", "tags": [ "Agent Games", "World Cup", "x402" ], "parameters": [ { "name": "event_ticker", "in": "query", "required": true, "description": "Kalshi World Cup game event ticker, e.g. KXWCGAME-26JUN27COLPOR.", "schema": { "type": "string" } }, { "name": "prediction", "in": "query", "required": true, "description": "Predicted winner option, e.g. COL, POR, or TIE.", "schema": { "type": "string" } }, { "name": "agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "wallet_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "server_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "run_id", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid prediction receipt response" }, "402": { "description": "Payment Required" } } } }, "/api/world-cup-validator": { "get": { "operationId": "buyWorldCupValidator", "summary": "Buy a World Cup prediction validation receipt", "description": "Returns a paid score receipt for a World Cup match prediction using Kalshi public market and milestone live-data APIs. No bet, prize pool, payout, refund, or gambling reward.", "tags": [ "Agent Games", "World Cup", "x402" ], "parameters": [ { "name": "event_ticker", "in": "query", "required": true, "description": "Kalshi World Cup game event ticker, e.g. KXWCGAME-26JUN27COLPOR.", "schema": { "type": "string" } }, { "name": "prediction", "in": "query", "required": true, "description": "Predicted winner option, e.g. COL, POR, or TIE.", "schema": { "type": "string" } }, { "name": "agent_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "wallet_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "server_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "run_id", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid validation receipt response" }, "402": { "description": "Payment Required" } } } } }, "components": { "schemas": { "PaidResolveBotsServiceIntakeResponse": { "type": "object", "required": [ "purchased", "service" ], "properties": { "purchased": { "type": "boolean", "const": true }, "service": { "type": "object", "required": [ "id", "title", "seller", "price", "what_this_buys", "intake_schema", "next_steps" ], "additionalProperties": true } }, "additionalProperties": true }, "PaidArticleResponse": { "type": "object", "required": [ "article", "purchased", "chapter" ], "properties": { "article": { "type": "object", "required": [ "slug", "title", "series", "price", "payment" ], "additionalProperties": true }, "purchased": { "type": "boolean", "const": true }, "chapter": { "type": "object", "required": [ "id", "series_title", "chapter", "title", "summary", "body_markdown", "agent_takeaways" ], "properties": { "id": { "type": "string" }, "series_title": { "type": "string" }, "chapter": { "type": "integer" }, "title": { "type": "string" }, "summary": { "type": "string" }, "body_markdown": { "type": "string" }, "agent_takeaways": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true } }, "additionalProperties": true }, "PaidResearchReportResponse": { "type": "object", "required": [ "purchased", "report" ], "properties": { "purchased": { "type": "boolean", "const": true }, "report": { "type": "object", "required": [ "id", "title", "lens", "summary", "price", "full_rankings", "disclaimer" ], "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "lens": { "type": "string", "enum": [ "standard", "abundance", "hail_mary" ] }, "summary": { "type": "string" }, "price": { "type": "object", "properties": { "amount": { "type": "string" }, "amount_atomic": { "type": "string" }, "currency": { "type": "string" }, "network": { "type": "string" }, "network_caip2": { "type": "string" } } }, "full_rankings": { "type": "array", "items": { "type": "object", "properties": { "rank": { "type": "integer" }, "symbol": { "type": "string" }, "name": { "type": "string" }, "thesis": { "type": "string" }, "risk": { "type": "string" } } } }, "disclaimer": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true }, "PaidAgentFlowRadarEventResponse": { "type": "object", "required": [ "purchased", "product", "event" ], "properties": { "purchased": { "type": "boolean", "const": true }, "product": { "type": "object", "required": [ "id", "title", "seller", "price", "payment" ], "additionalProperties": true }, "event": { "type": "object", "required": [ "event_id", "ticker", "signal_type", "agent_verdict", "confidence", "licensing_posture", "disclaimers" ], "properties": { "event_id": { "type": "string" }, "ticker": { "type": "string" }, "generated_at_utc": { "type": "string", "format": "date-time" }, "prototype_mode": { "type": "boolean" }, "signal_type": { "type": "string" }, "agent_verdict": { "type": "string" }, "directional_read": { "type": "string" }, "confidence": { "type": "number" }, "thesis": { "type": "string" }, "why_it_matters": { "type": "array", "items": { "type": "string" } }, "risk_flags": { "type": "array", "items": { "type": "string" } }, "agent_next_actions": { "type": "array", "items": { "type": "string" } }, "public_corroboration": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "url": { "type": "string" } }, "additionalProperties": true } }, "licensing_posture": { "type": "object", "additionalProperties": true }, "disclaimers": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true } }, "additionalProperties": true }, "PaidAgentFlowRadarSummaryResponse": { "type": "object", "required": [ "purchased", "product", "summary", "signals" ], "properties": { "purchased": { "type": "boolean", "const": true }, "product": { "type": "object", "additionalProperties": true }, "summary": { "type": "object", "required": [ "market_tone", "confidence", "normalized_score", "plain_english" ], "properties": { "market_tone": { "type": "string", "enum": [ "GREEN", "RED", "MIXED" ] }, "confidence": { "type": "number" }, "normalized_score": { "type": "number" }, "plain_english": { "type": "string" } }, "additionalProperties": true }, "signals": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "additionalProperties": true }, "PaidX402CoinFlipDemoResponse": { "type": "object", "required": [ "purchased", "product", "game" ], "properties": { "purchased": { "type": "boolean", "const": true }, "product": { "type": "object", "additionalProperties": true }, "game": { "type": "object", "required": [ "mode", "outcome", "proof_sha256" ], "additionalProperties": true } }, "additionalProperties": true }, "PaidAgentMarketToneChallengeResponse": { "type": "object", "required": [ "purchased", "product", "challenge" ], "properties": { "purchased": { "type": "boolean", "const": true }, "product": { "type": "object", "additionalProperties": true }, "challenge": { "type": "object", "required": [ "prediction", "actual", "correct", "score" ], "additionalProperties": true } }, "additionalProperties": true } } } }