{
 "openapi": "3.1.0",
 "info": {
  "title": "Zorvu API",
  "version": "1.0.0",
  "summary": "Measured risk data for Robinhood Chain tokens and official Stock Tokens.",
  "description": "Zorvu measures Robinhood Chain tokens and official Stock Tokens: automated token checks, a pre-sign check for transactions (Zorvu Shield), and how much of a Stock Token the on-chain pools could take on a sale, against the reference price.\n\nEvery result is a measurement with the time it was taken. A pass means the token or transaction passed Zorvu's checks at that time; it is not a recommendation and not a promise about the future. A figure Zorvu could not read is null with a reason, never a pass and never zero. Zorvu does not total liquidity across tokens: a pool pairing two Stock Tokens counts toward both. Zorvu never builds, routes, signs or sends a transaction and holds no keys. Not financial advice.\n\nZorvu is not affiliated with Robinhood Markets, Inc. or its affiliates.",
  "termsOfService": "https://zorvu.app/terms",
  "contact": {
   "name": "Zorvu",
   "url": "https://zorvu.app/developers",
   "email": "disputes@zorvu.app"
  }
 },
 "externalDocs": {
  "description": "Developer reference",
  "url": "https://zorvu.app/developers"
 },
 "servers": [
  {
   "url": "https://zorvu.app"
  }
 ],
 "tags": [
  {
   "name": "Stock Tokens"
  },
  {
   "name": "Shield"
  },
  {
   "name": "Token checks"
  },
  {
   "name": "Status"
  }
 ],
 "paths": {
  "/api/v1/depth": {
   "get": {
    "operationId": "getStockSellDepth",
    "tags": [
     "Stock Tokens"
    ],
    "security": [],
    "summary": "Current sell depth for one official Stock Token",
    "description": "How much of an official Robinhood Chain Stock Token the on-chain pools took on a sale at the last reading, and at what price against the reference price: fills at $1,000, $10,000 and $100,000, and the largest size within 2% and within 5% of the reference.\n\nGive one of `symbol` or `address`. A ticker resolves only to the official registry token, never to a lookalike contract. Keyless, 30 requests a minute per IP. Current reading only.\n\nA reading older than 30 minutes is not served (404 `no_reading`). A max-size search older than 2 hours is `max_size.reading: \"no_reading\"` with null figures. A rung the engine could not measure has null figures and says why. `capped: true` means the search stopped at its ceiling, so the real size is at least that large. These are measurements, not a quote and not advice.",
    "parameters": [
     {
      "name": "symbol",
      "in": "query",
      "required": false,
      "description": "Ticker of an official Stock Token, for example NVDA. 1 to 10 letters, digits or dots; case does not matter.",
      "schema": {
       "type": "string",
       "pattern": "^[A-Za-z0-9.]{1,10}$"
      }
     },
     {
      "name": "address",
      "in": "query",
      "required": false,
      "description": "Contract address of an official Stock Token.",
      "schema": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The current reading.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/DepthReading"
        }
       }
      }
     },
     "400": {
      "description": "Neither or both of symbol and address, or a malformed one.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: invalid_request, invalid_symbol, invalid_address."
        }
       }
      }
     },
     "404": {
      "description": "Not an official Stock Token (`not_official_stock_token`), or no usable reading (`no_reading`).",
      "content": {
       "application/json": {
        "schema": {
         "oneOf": [
          {
           "$ref": "#/components/schemas/DepthNoReading"
          },
          {
           "allOf": [
            {
             "$ref": "#/components/schemas/V1Error"
            }
           ],
           "description": "Error codes: not_official_stock_token."
          }
         ]
        }
       }
      }
     },
     "429": {
      "description": "Per-IP limit reached.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: rate_limited_minute."
        }
       }
      },
      "headers": {
       "retry-after": {
        "schema": {
         "type": "string"
        },
        "description": "Seconds to wait."
       }
      }
     },
     "503": {
      "description": "Temporarily unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: unavailable."
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/check": {
   "get": {
    "operationId": "checkToken",
    "tags": [
     "Token checks"
    ],
    "security": [
     {
      "bearerAuth": []
     }
    ],
    "summary": "Automated risk checks on one Robinhood Chain token",
    "description": "The grade, each check with its result and reason, the drainer code check, and when every underlying reading was taken. A grade says what Zorvu's automated checks measured at the time shown; it is not a recommendation and not a promise about the future. While Zorvu's token measurements are an archive this endpoint answers `Not yet checked`, `Limited data`, `Elevated risk`, `High risk` or `Not applicable`, never `Low risk`, so `passed_zorvu_safety_checks` is always `false` here: see the `grade` field. A check Zorvu could not run is `inconclusive` or `no_data`, never a pass.",
    "parameters": [
     {
      "name": "address",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Check result.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/TokenCheck"
        }
       }
      },
      "headers": {
       "x-ratelimit-limit-minute": {
        "schema": {
         "type": "string"
        }
       },
       "x-ratelimit-remaining-minute": {
        "schema": {
         "type": "string"
        }
       },
       "x-ratelimit-limit-day": {
        "schema": {
         "type": "string"
        }
       },
       "x-ratelimit-remaining-day": {
        "schema": {
         "type": "string"
        }
       },
       "x-ratelimit-reset-day": {
        "schema": {
         "type": "string"
        },
        "description": "Unix seconds of the next 00:00 UTC."
       }
      }
     },
     "400": {
      "description": "Malformed address.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: invalid_address."
        }
       }
      }
     },
     "401": {
      "description": "No key, or an unknown or revoked key.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: missing_key, invalid_key."
        }
       }
      }
     },
     "429": {
      "description": "Key limit reached.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: rate_limited_minute, rate_limited_day."
        }
       }
      },
      "headers": {
       "retry-after": {
        "schema": {
         "type": "string"
        },
        "description": "Seconds to wait."
       }
      }
     },
     "503": {
      "description": "Temporarily unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: unavailable."
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/precheck": {
   "post": {
    "operationId": "precheckTransaction",
    "tags": [
     "Shield"
    ],
    "security": [
     {
      "bearerAuth": []
     }
    ],
    "summary": "Check a Robinhood Chain transaction before it is signed",
    "description": "Send the transaction you are about to sign and get back `pass`, `warn` or `block` with the reasons. `pass` means it passed the checks listed in `checks_run` at `checked_at`, nothing broader; it is not a promise about what the transaction will do. Zorvu checks a transaction someone else built: it never builds, routes, signs or sends one. The body, `tx.from` and the policy are never stored or logged. Same keys and limits as /api/v1/check.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/PrecheckRequest"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "Verdict and reasons.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PrecheckResponse"
        }
       }
      },
      "headers": {
       "x-ratelimit-limit-minute": {
        "schema": {
         "type": "string"
        }
       },
       "x-ratelimit-remaining-minute": {
        "schema": {
         "type": "string"
        }
       },
       "x-ratelimit-limit-day": {
        "schema": {
         "type": "string"
        }
       },
       "x-ratelimit-remaining-day": {
        "schema": {
         "type": "string"
        }
       },
       "x-ratelimit-reset-day": {
        "schema": {
         "type": "string"
        },
        "description": "Unix seconds of the next 00:00 UTC."
       }
      }
     },
     "400": {
      "description": "Invalid body.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: invalid_json, invalid_request, unsupported_chain."
        }
       }
      }
     },
     "401": {
      "description": "No key, or an unknown or revoked key.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: missing_key, invalid_key."
        }
       }
      }
     },
     "413": {
      "description": "Body over 64 KB.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: body_too_large."
        }
       }
      }
     },
     "429": {
      "description": "Key limit reached.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: rate_limited_minute, rate_limited_day."
        }
       }
      },
      "headers": {
       "retry-after": {
        "schema": {
         "type": "string"
        },
        "description": "Seconds to wait."
       }
      }
     },
     "503": {
      "description": "Temporarily unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/V1Error"
          }
         ],
         "description": "Error codes: unavailable."
        }
       }
      }
     }
    }
   }
  },
  "/api/stocks": {
   "get": {
    "operationId": "listStockTokens",
    "tags": [
     "Stock Tokens"
    ],
    "security": [],
    "summary": "Official Stock Token registry with pool readings and lookalike counts",
    "description": "Without `symbol`: every active official Stock Token with its latest pool reading, official quote and count of known lookalike contracts. With `symbol`: the same for one token plus Zorvu's notes on it. Every reading carries its time. A lookalike's `liq_peak` is the highest liquidity ever seen for it, not what it holds now. No liquidity total is given. Keyless, 30 requests a minute per IP.",
    "parameters": [
     {
      "name": "symbol",
      "in": "query",
      "required": false,
      "description": "Ticker of an official Stock Token. 1 to 10 letters, digits or dots.",
      "schema": {
       "type": "string",
       "pattern": "^[A-Za-z0-9.]{1,10}$"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The registry (no symbol) or one token (with symbol).",
      "content": {
       "application/json": {
        "schema": {
         "oneOf": [
          {
           "$ref": "#/components/schemas/StocksList"
          },
          {
           "$ref": "#/components/schemas/StocksOne"
          }
         ]
        }
       }
      }
     },
     "400": {
      "description": "Malformed symbol.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PlainError"
        }
       }
      }
     },
     "404": {
      "description": "Not an official Stock Token.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PlainError"
        }
       }
      }
     },
     "429": {
      "description": "Per-IP limit reached.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PlainError"
        }
       }
      }
     },
     "503": {
      "description": "Temporarily unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PlainError"
        }
       }
      }
     }
    }
   }
  },
  "/api/check": {
   "get": {
    "operationId": "checkTokenBrowser",
    "tags": [
     "Token checks"
    ],
    "security": [],
    "summary": "The free checker behind zorvu.app/check (browser only)",
    "description": "The free token checker used by the zorvu.app/check page. It needs a Cloudflare Turnstile verification from a browser and answers 403 `needs_verification` without one. Programs should use GET /api/v1/check with a key.",
    "parameters": [
     {
      "name": "address",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     },
     {
      "name": "x-turnstile",
      "in": "header",
      "required": false,
      "description": "Cloudflare Turnstile token from the zorvu.app/check page.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Check result, in the shape the check page reads.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true
        }
       }
      }
     },
     "400": {
      "description": "Malformed address.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PlainError"
        }
       }
      }
     },
     "403": {
      "description": "No browser verification.",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/PlainError"
          }
         ],
         "properties": {
          "needs_verification": {
           "type": "boolean"
          }
         }
        }
       }
      }
     },
     "429": {
      "description": "Per-IP limit reached.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PlainError"
        }
       }
      }
     },
     "503": {
      "description": "Temporarily unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PlainError"
        }
       }
      }
     }
    }
   }
  },
  "/api/health": {
   "get": {
    "operationId": "getHealth",
    "tags": [
     "Status"
    ],
    "security": [],
    "summary": "Whether Zorvu's data jobs are current",
    "description": "200 while every data job that feeds Zorvu is current, 503 with the late check named when any is not. Keyless.",
    "responses": {
     "200": {
      "description": "Every check passes.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Health"
        }
       }
      }
     },
     "429": {
      "description": "Per-IP limit reached.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PlainError"
        }
       }
      }
     },
     "503": {
      "description": "At least one check fails, or the status cannot be read.",
      "content": {
       "application/json": {
        "schema": {
         "oneOf": [
          {
           "$ref": "#/components/schemas/Health"
          },
          {
           "$ref": "#/components/schemas/PlainError"
          }
         ]
        }
       }
      }
     }
    }
   },
   "head": {
    "operationId": "headHealth",
    "tags": [
     "Status"
    ],
    "security": [],
    "summary": "Same status as GET, no body",
    "responses": {
     "200": {
      "description": "Every check passes."
     },
     "429": {
      "description": "Per-IP limit reached."
     },
     "503": {
      "description": "At least one check fails."
     }
    }
   }
  }
 },
 "components": {
  "securitySchemes": {
   "bearerAuth": {
    "type": "http",
    "scheme": "bearer",
    "description": "A Zorvu API key: \"Authorization: Bearer <key>\". Keys are issued by invitation during the preview."
   }
  },
  "schemas": {
   "V1Error": {
    "type": "object",
    "required": [
     "api_version",
     "error"
    ],
    "properties": {
     "api_version": {
      "const": "v1"
     },
     "error": {
      "type": "object",
      "required": [
       "code",
       "message"
      ],
      "properties": {
       "code": {
        "type": "string"
       },
       "message": {
        "type": "string"
       }
      }
     }
    }
   },
   "PlainError": {
    "type": "object",
    "required": [
     "error"
    ],
    "properties": {
     "error": {
      "type": "string"
     }
    }
   },
   "DepthRung": {
    "type": "object",
    "required": [
     "usd",
     "fill_price",
     "impact_pct",
     "reading"
    ],
    "properties": {
     "usd": {
      "type": "integer",
      "enum": [
       1000,
       10000,
       100000
      ],
      "description": "Size of the sale in USD."
     },
     "fill_price": {
      "type": [
       "number",
       "null"
      ],
      "description": "Average price per token the pools filled at. Null when not measured."
     },
     "impact_pct": {
      "type": [
       "number",
       "null"
      ],
      "description": "Fill against the reference price, in percent. Negative is below: -0.82 means 0.82% below. Null when not measured."
     },
     "reading": {
      "type": "string",
      "enum": [
       "ok",
       "no_route",
       "rate_limited",
       "error",
       "not_measured"
      ],
      "description": "ok: measured. no_route: the pools could not take this sale. rate_limited, error: the quote failed. not_measured: not quoted in this run (the engine stops after no route or a rate limit at a smaller size)."
     }
    }
   },
   "DepthMaxSize": {
    "type": "object",
    "required": [
     "within_2pct_usd",
     "within_5pct_usd",
     "capped",
     "read_at",
     "reading_age_seconds",
     "reading"
    ],
    "properties": {
     "within_2pct_usd": {
      "type": [
       "number",
       "null"
      ],
      "description": "Largest sale in USD the pools took within 2% of the reference price. Null when unknown, never zero."
     },
     "within_5pct_usd": {
      "type": [
       "number",
       "null"
      ],
      "description": "Same, within 5%."
     },
     "capped": {
      "type": [
       "boolean",
       "null"
      ],
      "description": "true: the search stopped at its ceiling, so the real size is at least the figure shown."
     },
     "read_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time",
      "description": "When the max-size search ran (hourly)."
     },
     "reading_age_seconds": {
      "type": [
       "integer",
       "null"
      ]
     },
     "reading": {
      "type": "string",
      "enum": [
       "ok",
       "no_reading"
      ],
      "description": "no_reading when the search is older than 2 hours or has no figure; both figures are then null."
     }
    }
   },
   "DepthReading": {
    "type": "object",
    "required": [
     "api_version",
     "symbol",
     "address",
     "official_stock_token",
     "reference_price",
     "reference_source",
     "read_at",
     "reading_age_seconds",
     "ladder",
     "max_size",
     "route_fee_bps",
     "hops_at_100k",
     "note",
     "freshness",
     "checked_at",
     "disclaimer"
    ],
    "properties": {
     "api_version": {
      "const": "v1"
     },
     "symbol": {
      "type": "string"
     },
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
     },
     "official_stock_token": {
      "const": true
     },
     "reference_price": {
      "type": [
       "number",
       "null"
      ],
      "description": "Per-token reference price the fills are measured against."
     },
     "reference_source": {
      "type": [
       "string",
       "null"
      ],
      "description": "official: the official quote. pool: the pool price, used when the official quote is older than 30 minutes."
     },
     "read_at": {
      "type": "string",
      "format": "date-time",
      "description": "When the ladder was measured."
     },
     "reading_age_seconds": {
      "type": "integer"
     },
     "ladder": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
       "$ref": "#/components/schemas/DepthRung"
      }
     },
     "max_size": {
      "$ref": "#/components/schemas/DepthMaxSize"
     },
     "route_fee_bps": {
      "type": [
       "integer",
       "null"
      ],
      "description": "The router's fee in basis points, as quoted. Fill prices are before this fee."
     },
     "hops_at_100k": {
      "type": [
       "integer",
       "null"
      ],
      "description": "Pools the $100,000 sale was routed through."
     },
     "note": {
      "type": [
       "string",
       "null"
      ],
      "description": "The depth engine's own note on this reading, for example \"no route at 100k\"."
     },
     "freshness": {
      "type": "object",
      "required": [
       "reading_max_age_seconds",
       "max_size_max_age_seconds"
      ],
      "properties": {
       "reading_max_age_seconds": {
        "type": "integer"
       },
       "max_size_max_age_seconds": {
        "type": "integer"
       }
      }
     },
     "checked_at": {
      "type": "string",
      "format": "date-time"
     },
     "disclaimer": {
      "type": "string"
     }
    }
   },
   "DepthNoReading": {
    "type": "object",
    "required": [
     "api_version",
     "error",
     "symbol",
     "address",
     "official_stock_token",
     "read_at",
     "reading_age_seconds",
     "disclaimer"
    ],
    "description": "404 no_reading: an official Stock Token with no usable reading. read_at is the time of the last reading, if there is one.",
    "properties": {
     "api_version": {
      "const": "v1"
     },
     "error": {
      "type": "object",
      "required": [
       "code",
       "message"
      ],
      "properties": {
       "code": {
        "const": "no_reading"
       },
       "message": {
        "type": "string"
       }
      }
     },
     "symbol": {
      "type": "string"
     },
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
     },
     "official_stock_token": {
      "const": true
     },
     "read_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "reading_age_seconds": {
      "type": [
       "integer",
       "null"
      ]
     },
     "disclaimer": {
      "type": "string"
     }
    }
   },
   "TokenCheck": {
    "type": "object",
    "required": [
     "api_version",
     "address",
     "grade",
     "passed_zorvu_safety_checks",
     "checks",
     "freshness",
     "disclaimer"
    ],
    "properties": {
     "api_version": {
      "const": "v1"
     },
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
     },
     "chain": {
      "type": "string"
     },
     "symbol": {
      "type": [
       "string",
       "null"
      ]
     },
     "in_zorvu_data": {
      "type": "boolean",
      "description": "true when Zorvu holds token measurements from the last 7 days for this address (all archived readings; see token_data)."
     },
     "token_data": {
      "type": [
       "string",
       "null"
      ],
      "enum": [
       "archived",
       "none",
       null
      ],
      "description": "archived: Zorvu's token measurements are archived readings from the last 7 days; they never count as a pass and may support a warn or fail, each dated in checks[].reading_at. none: no measurement from the last 7 days (older readings are not used). null for a base asset."
     },
     "archive": {
      "type": [
       "object",
       "null"
      ],
      "description": "max_age_days (7), last_reading_at (Zorvu's last measurement of this token, or null) and data_ends (when Zorvu's token measurements end).",
      "additionalProperties": true
     },
     "ticker_source": {
      "type": [
       "string",
       "null"
      ],
      "enum": [
       "registry",
       "live",
       "stored",
       "archived",
       "skipped_fast",
       "unavailable",
       null
      ],
      "description": "Where the ticker for the lookalike check came from: the official registry, a live symbol()/name() read, an archived reading from the last 7 days, or none (the live read did not answer)."
     },
     "grade": {
      "type": "string",
      "description": "What Zorvu's automated checks measured, not a recommendation. Returned today: `Not applicable` (a base asset of the chain, which Zorvu does not run project checks on), `Not yet checked`, `Limited data`, `Elevated risk`, `High risk`. Not returned today: `Low risk` needs at least 3 of the 4 core checks (liquidity, holders, sell test, deployer history) to have a result and fewer than 2 warnings overall, and those four readings are archived; an archived reading never counts as a pass, so a core check can only reach that 3 by having warned or failed, which grades the token `Elevated risk` or `High risk` instead. `Insufficient data` is not returned by this endpoint either. Deliberately not an enum: the set widens again if Zorvu's token measurements resume, and a client that rejected an unlisted grade would then reject a valid answer."
     },
     "passed_zorvu_safety_checks": {
      "type": "boolean",
      "description": "`true` only when the grade is `Low risk`, so on this endpoint it is always `false` while Zorvu's token measurements are an archive: see the `grade` field. An archived reading never counts as a pass. Shield's `passed_zorvu_safety_checks`, on each entry of its `tokens[]`, is a different field with its own rule and does become `true`."
     },
     "checked_factors": {
      "type": [
       "integer",
       "null"
      ]
     },
     "checks": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "id": {
         "type": "string"
        },
        "status": {
         "type": "string",
         "description": "pass, warn, fail, inconclusive or no_data."
        },
        "result": {
         "type": "string"
        },
        "detail": {
         "type": [
          "string",
          "null"
         ]
        },
        "reading_at": {
         "type": "string",
         "format": "date-time",
         "description": "Set when the check rests on an archived reading: when that reading was taken."
        }
       }
      }
     },
     "notes": {
      "type": "array",
      "items": {
       "type": "object"
      }
     },
     "drainer_check": {
      "type": [
       "object",
       "null"
      ]
     },
     "freshness": {
      "type": "object",
      "description": "ISO 8601 times of the dataset and each underlying reading.",
      "additionalProperties": {
       "type": [
        "string",
        "null"
       ],
       "format": "date-time"
      }
     },
     "stats": {
      "type": [
       "object",
       "null"
      ],
      "additionalProperties": true
     },
     "disclaimer": {
      "type": "string"
     },
     "dispute": {
      "type": [
       "string",
       "null"
      ]
     }
    }
   },
   "PrecheckRequest": {
    "type": "object",
    "required": [
     "chain_id",
     "tx"
    ],
    "properties": {
     "chain_id": {
      "description": "4663 (Robinhood Chain).",
      "oneOf": [
       {
        "const": 4663
       },
       {
        "const": "4663"
       }
      ]
     },
     "mode": {
      "type": "string",
      "enum": [
       "default",
       "fast"
      ]
     },
     "tx": {
      "type": "object",
      "required": [
       "to"
      ],
      "properties": {
       "to": {
        "type": "string",
        "pattern": "^0x[0-9a-fA-F]{40}$"
       },
       "data": {
        "type": "string",
        "pattern": "^0x([0-9a-fA-F]{2})*$"
       },
       "from": {
        "type": "string",
        "pattern": "^0x[0-9a-fA-F]{40}$"
       },
       "value": {
        "oneOf": [
         {
          "type": "string"
         },
         {
          "type": "integer",
          "minimum": 0
         }
        ]
       }
      }
     },
     "intent": {
      "type": "object",
      "properties": {
       "token": {
        "type": "string",
        "pattern": "^0x[0-9a-fA-F]{40}$"
       },
       "side": {
        "type": "string",
        "enum": [
         "buy",
         "sell"
        ]
       },
       "usd": {
        "type": "number",
        "minimum": 0
       }
      }
     },
     "policy": {
      "type": "object",
      "properties": {
       "max_usd": {
        "type": "number",
        "minimum": 0
       },
       "allow_to": {
        "type": "array",
        "maxItems": 200,
        "items": {
         "type": "string",
         "pattern": "^0x[0-9a-fA-F]{40}$"
        }
       },
       "allow_tokens": {
        "type": "array",
        "maxItems": 200,
        "items": {
         "type": "string",
         "pattern": "^0x[0-9a-fA-F]{40}$"
        }
       },
       "block_unlimited_approvals": {
        "type": "boolean"
       }
      }
     }
    }
   },
   "PrecheckReason": {
    "type": "object",
    "required": [
     "code",
     "severity",
     "subject",
     "detail"
    ],
    "properties": {
     "code": {
      "type": "string",
      "enum": [
       "drainer_contract",
       "drainer_recipient",
       "drainer_review",
       "lookalike_stock_token",
       "sell_check_failed",
       "high_risk_token",
       "token_not_graded",
       "unlimited_approval",
       "approval_to_wallet",
       "size_over_depth_5pct",
       "size_over_depth_2pct",
       "policy_max_usd",
       "policy_to_not_allowed",
       "policy_token_not_allowed",
       "check_unavailable",
       "not_decoded",
       "depth_unavailable",
       "not_checked_fast"
      ]
     },
     "severity": {
      "type": "string",
      "enum": [
       "info",
       "warn",
       "block"
      ]
     },
     "subject": {
      "type": [
       "string",
       "null"
      ]
     },
     "detail": {
      "type": "string"
     }
    }
   },
   "PrecheckResponse": {
    "type": "object",
    "required": [
     "api_version",
     "verdict",
     "mode",
     "reasons",
     "checks_run",
     "decoded",
     "tokens",
     "depth",
     "checked_at",
     "disclaimer"
    ],
    "properties": {
     "api_version": {
      "const": "v1"
     },
     "verdict": {
      "type": "string",
      "enum": [
       "pass",
       "warn",
       "block"
      ]
     },
     "mode": {
      "type": "string",
      "enum": [
       "default",
       "fast"
      ]
     },
     "reasons": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/PrecheckReason"
      }
     },
     "checks_run": {
      "type": "array",
      "items": {
       "type": "string",
       "enum": [
        "calldata_decode",
        "drainer_address_list",
        "drainer_code",
        "lookalike_stock_token",
        "approval_amount",
        "spender_code",
        "sell_depth",
        "policy"
       ]
      },
      "description": "The checks that ran on every address they apply to. `pass` covers only these. A check that did not run is left out, and a reason says why."
     },
     "decoded": {
      "type": "object",
      "properties": {
       "method": {
        "type": [
         "string",
         "null"
        ]
       },
       "selector": {
        "type": [
         "string",
         "null"
        ]
       },
       "args": {
        "type": [
         "object",
         "null"
        ]
       }
      }
     },
     "tokens": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "pattern": "^0x[0-9a-fA-F]{40}$"
        },
        "symbol": {
         "type": [
          "string",
          "null"
         ]
        },
        "grade": {
         "type": [
          "string",
          "null"
         ]
        },
        "passed_zorvu_safety_checks": {
         "type": "boolean",
         "description": "true when every check in this token's checks_run passed and no warn or block names the token. The grade is not one of those checks."
        },
        "official_stock_token": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "lookalike_of": {
         "type": [
          "string",
          "null"
         ]
        },
        "drainer_check": {
         "type": [
          "string",
          "null"
         ]
        },
        "checks_run": {
         "type": "array",
         "items": {
          "type": "string",
          "enum": [
           "drainer_code",
           "lookalike_stock_token"
          ]
         },
         "description": "The checks that ran on this token."
        }
       }
      }
     },
     "depth": {
      "type": [
       "object",
       "null"
      ],
      "properties": {
       "address": {
        "type": "string",
        "pattern": "^0x[0-9a-fA-F]{40}$"
       },
       "max_usd_2pct": {
        "type": [
         "number",
         "null"
        ]
       },
       "max_usd_5pct": {
        "type": [
         "number",
         "null"
        ]
       },
       "read_at": {
        "type": [
         "string",
         "null"
        ],
        "format": "date-time"
       },
       "max_read_at": {
        "type": [
         "string",
         "null"
        ],
        "format": "date-time"
       },
       "capped": {
        "type": "boolean"
       }
      }
     },
     "checked_at": {
      "type": "string",
      "format": "date-time"
     },
     "disclaimer": {
      "type": "string"
     }
    }
   },
   "StockToken": {
    "type": "object",
    "description": "One official Stock Token. Every figure has its time; null means no reading.",
    "additionalProperties": true,
    "properties": {
     "symbol": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
     },
     "lookalikes": {
      "type": "integer"
     },
     "lookalike_examples": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "pattern": "^0x[0-9a-fA-F]{40}$"
        },
        "liq_peak": {
         "type": [
          "number",
          "null"
         ],
         "description": "Highest liquidity ever seen for this lookalike, not what it holds now."
        }
       }
      }
     },
     "dex_price": {
      "type": [
       "number",
       "null"
      ]
     },
     "liquidity_usd": {
      "type": [
       "number",
       "null"
      ]
     },
     "liquidity_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "official_price": {
      "type": [
       "number",
       "null"
      ]
     },
     "official_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "gap_pct": {
      "type": [
       "number",
       "null"
      ]
     },
     "halted": {
      "type": "boolean"
     }
    }
   },
   "StocksList": {
    "type": "object",
    "required": [
     "disclaimer",
     "tokens"
    ],
    "additionalProperties": true,
    "properties": {
     "disclaimer": {
      "type": "string"
     },
     "registry_synced_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "board_synced_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "official_count": {
      "type": "integer"
     },
     "tokens": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/StockToken"
      }
     }
    }
   },
   "StocksOne": {
    "type": "object",
    "required": [
     "disclaimer",
     "token"
    ],
    "additionalProperties": true,
    "properties": {
     "disclaimer": {
      "type": "string"
     },
     "registry_synced_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "board_synced_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "token": {
      "$ref": "#/components/schemas/StockToken"
     },
     "notes": {
      "type": "array",
      "items": {
       "type": "object"
      }
     }
    }
   },
   "Health": {
    "type": "object",
    "required": [
     "ok",
     "checks",
     "checked_at"
    ],
    "properties": {
     "ok": {
      "type": "boolean"
     },
     "checked_at": {
      "type": "string",
      "format": "date-time"
     },
     "checks": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "ok",
        "limit"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "ok": {
         "type": "boolean"
        },
        "age_s": {
         "type": [
          "integer",
          "null"
         ]
        },
        "value": {
         "type": [
          "integer",
          "null"
         ]
        },
        "limit": {
         "type": "integer"
        },
        "error": {
         "type": "string"
        }
       }
      }
     },
     "info": {
      "type": "array",
      "description": "Readings shown for information; they never change ok or the status code. chain_watch_caught_up: seconds since the chain watcher was last at the chain head with no new token left to check. chain_watch_pending: new tokens waiting for their checks. null when missing or unreadable.",
      "items": {
       "type": "object",
       "required": [
        "name"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "age_s": {
         "type": [
          "integer",
          "null"
         ]
        },
        "value": {
         "type": [
          "integer",
          "null"
         ]
        }
       }
      }
     }
    }
   }
  }
 }
}
