{
  "openapi": "3.1.0",
  "info": {
    "title": "Darrylbots Paid Research API",
    "version": "2026-06-26",
    "description": "Agent-readable paid research reports from Darrylbots LLC, protected by x402 payments on Base.",
    "x-guidance": "Use the dedicated endpoints to buy Darrylbots structured JSON stock-screen reports. Call a GET endpoint without payment to receive the x402 Payment Required challenge, complete payment, then retry with the payment response header. The reports are research only and 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"
          }
        }
      }
    }
  },
  "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
      }
    }
  }
}
