{"openapi":"3.1.0","info":{"title":"hypothes-annotations","version":"0.1.0","description":"listed:true — OpenAPI pre-register shape. Discovery submit HOLD until Board origin list.","x-guidance":"POST /v1/hypothes-annotations with application/json per requestBody schema. Unauthenticated probes receive HTTP 402 (x402 exact USDC on Base / eip155:8453). After payment settles, empty or invalid bodies return 400 with charged:false. Free health: GET /healthz and GET /readyz. Contact nicsins@gmail.com.","contact":{"email":"nicsins@gmail.com"}},"paths":{"/v1/hypothes-annotations":{"post":{"operationId":"hypothes_annotations","summary":"Hypothesis annotation search (keyless). POST {uri?}/{tag?}/{limit?}. Empty -> 400 not charged. New annotations vertical (low adjacency).","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020124"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"uri":{"type":"string","maxLength":2048},"tag":{"type":"string","maxLength":120},"limit":{"type":"integer","minimum":1,"maximum":50},"user":{"type":"string","maxLength":120},"request_id":{"type":"string"}}}}}},"responses":{"200":{"description":"ok envelope","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"skill":{"type":"string"},"charged":{"type":"boolean"},"summary":{"type":"string"},"data":{},"request_id":{"type":"string"}},"required":["ok"]}}}},"400":{"description":"empty/invalid after settle — charged:false"},"402":{"description":"payment required"},"503":{"description":"service disabled (kill-switch)"}}}},"/healthz":{"get":{"operationId":"healthz","security":[],"summary":"Liveness","responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/readyz":{"get":{"operationId":"readyz","security":[],"summary":"Readiness","responses":{"200":{"description":"ready","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}},"503":{"description":"not ready"}}}}}}