{"openapi":"3.1.0","info":{"title":"HiveMorph v0.1","description":"Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 LOREN). Three gates: NEED + YIELD + CLEAN-MONEY.","version":"0.1.0"},"paths":{"/v1/affordance/catalog":{"get":{"tags":["affordances"],"summary":"Get Catalogs","description":"List the affordance catalog for every hot supermodel.","operationId":"get_catalogs_v1_affordance_catalog_get","parameters":[{"name":"include_cold","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Cold"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Catalogs V1 Affordance Catalog Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/catalog":{"get":{"tags":["affordances"],"summary":"Get Catalog","operationId":"get_catalog_v1_affordance__supermodel__catalog_get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Catalog V1 Affordance Supermodel Catalog Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/list":{"get":{"tags":["affordances"],"summary":"List For Supermodel","operationId":"list_for_supermodel_v1_affordance__supermodel__list_get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List For Supermodel V1 Affordance Supermodel List Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/affordance/{aff_id}":{"get":{"tags":["affordances"],"summary":"Get One","operationId":"get_one_v1_affordance_affordance__aff_id__get","parameters":[{"name":"aff_id","in":"path","required":true,"schema":{"type":"string","title":"Aff Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get One V1 Affordance Affordance Aff Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/health":{"get":{"tags":["affordances"],"summary":"Health","operationId":"health_v1_affordance__supermodel__health_get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Health V1 Affordance Supermodel Health Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/pull":{"post":{"tags":["affordances"],"summary":"Post Pull","operationId":"post_pull_v1_affordance__supermodel__pull_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"reason","in":"query","required":true,"schema":{"type":"string","description":"Free-form reason for the pull","title":"Reason"},"description":"Free-form reason for the pull"},{"name":"bonus","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"description":"Optional tip; bonus>0 jumps queue","default":0.0,"title":"Bonus"},"description":"Optional tip; bonus>0 jumps queue"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PullBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Pull V1 Affordance Supermodel Pull Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/light-fuse":{"post":{"tags":["affordances"],"summary":"Post Light Fuse","operationId":"post_light_fuse_v1_affordance__supermodel__light_fuse_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"fuse_id","in":"query","required":true,"schema":{"type":"string","description":"Caller-side identifier for this ignition","title":"Fuse Id"},"description":"Caller-side identifier for this ignition"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LightFuseBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Light Fuse V1 Affordance Supermodel Light Fuse Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/grab":{"post":{"tags":["affordances"],"summary":"Post Grab Rope","operationId":"post_grab_rope_v1_affordance__supermodel__grab_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"duration_sec","in":"query","required":true,"schema":{"type":"integer","maximum":86400,"exclusiveMinimum":0,"title":"Duration Sec"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrabRopeBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Grab Rope V1 Affordance Supermodel Grab Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/snip":{"post":{"tags":["affordances"],"summary":"Post Snip","operationId":"post_snip_v1_affordance__supermodel__snip_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"reason","in":"query","required":true,"schema":{"type":"string","title":"Reason"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnipBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Snip V1 Affordance Supermodel Snip Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/hook":{"post":{"tags":["affordances"],"summary":"Post Hook","operationId":"post_hook_v1_affordance__supermodel__hook_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"event","in":"query","required":true,"schema":{"type":"string","title":"Event"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HookBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Hook V1 Affordance Supermodel Hook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/hooks":{"get":{"tags":["affordances"],"summary":"List Supermodel Hooks","operationId":"list_supermodel_hooks_v1_affordance__supermodel__hooks_get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"event","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Supermodel Hooks V1 Affordance Supermodel Hooks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/ring":{"post":{"tags":["affordances"],"summary":"Post Ring Bell","operationId":"post_ring_bell_v1_affordance__supermodel__ring_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RingBellBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Ring Bell V1 Affordance Supermodel Ring Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/trip":{"post":{"tags":["affordances"],"summary":"Post Trip","operationId":"post_trip_v1_affordance__supermodel__trip_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TripBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Trip V1 Affordance Supermodel Trip Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/top-off":{"post":{"tags":["affordances"],"summary":"Post Top Off Request","description":"Agent-side: post a top-off ask. Returns proposed affordance.","operationId":"post_top_off_request_v1_affordance__supermodel__top_off_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopOffRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Top Off Request V1 Affordance Supermodel Top Off Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/top-off/{top_off_id}/fulfill":{"post":{"tags":["affordances"],"summary":"Post Top Off Fulfill","operationId":"post_top_off_fulfill_v1_affordance_top_off__top_off_id__fulfill_post","parameters":[{"name":"top_off_id","in":"path","required":true,"schema":{"type":"string","title":"Top Off Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopOffFulfillBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Top Off Fulfill V1 Affordance Top Off Top Off Id Fulfill Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/top-off/{top_off_id}/complete":{"post":{"tags":["affordances"],"summary":"Post Top Off Complete","operationId":"post_top_off_complete_v1_affordance_top_off__top_off_id__complete_post","parameters":[{"name":"top_off_id","in":"path","required":true,"schema":{"type":"string","title":"Top Off Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopOffCompleteBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Top Off Complete V1 Affordance Top Off Top Off Id Complete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/tip":{"post":{"tags":["affordances"],"summary":"Post Tip Jar","operationId":"post_tip_jar_v1_affordance__supermodel__tip_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TipJarBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Tip Jar V1 Affordance Supermodel Tip Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/sos":{"post":{"tags":["affordances"],"summary":"Post Sos Request","operationId":"post_sos_request_v1_affordance__supermodel__sos_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SosRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Sos Request V1 Affordance Supermodel Sos Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/sos/active":{"get":{"tags":["affordances"],"summary":"Get Sos Active","operationId":"get_sos_active_v1_affordance_sos_active_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Sos Active V1 Affordance Sos Active Get"}}}}}}},"/v1/affordance/sos/{sos_id}/fulfill":{"post":{"tags":["affordances"],"summary":"Post Sos Fulfill","operationId":"post_sos_fulfill_v1_affordance_sos__sos_id__fulfill_post","parameters":[{"name":"sos_id","in":"path","required":true,"schema":{"type":"string","title":"Sos Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SosFulfillBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Sos Fulfill V1 Affordance Sos Sos Id Fulfill Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/iou":{"post":{"tags":["affordances"],"summary":"Post Iou Request","operationId":"post_iou_request_v1_affordance__supermodel__iou_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IouRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Iou Request V1 Affordance Supermodel Iou Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/iou/{iou_id}/repay":{"post":{"tags":["affordances"],"summary":"Post Iou Repay","operationId":"post_iou_repay_v1_affordance_iou__iou_id__repay_post","parameters":[{"name":"iou_id","in":"path","required":true,"schema":{"type":"string","title":"Iou Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IouRepayBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Iou Repay V1 Affordance Iou Iou Id Repay Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/bucket":{"post":{"tags":["affordances"],"summary":"Post Bucket","operationId":"post_bucket_v1_affordance__supermodel__bucket_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"fill_to","in":"query","required":true,"schema":{"type":"number","exclusiveMinimum":0,"title":"Fill To"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BucketBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Bucket V1 Affordance Supermodel Bucket Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/bucket/{bucket_id}/burn":{"post":{"tags":["affordances"],"summary":"Post Bucket Burn","operationId":"post_bucket_burn_v1_affordance_bucket__bucket_id__burn_post","parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BucketBurnBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Bucket Burn V1 Affordance Bucket Bucket Id Burn Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/drip":{"post":{"tags":["affordances"],"summary":"Post Drip Start","operationId":"post_drip_start_v1_affordance__supermodel__drip_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"rate_per_sec","in":"query","required":true,"schema":{"type":"number","exclusiveMinimum":0,"title":"Rate Per Sec"}},{"name":"max_total","in":"query","required":true,"schema":{"type":"number","exclusiveMinimum":0,"title":"Max Total"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DripBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Drip Start V1 Affordance Supermodel Drip Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/drip/{drip_id}/stop":{"post":{"tags":["affordances"],"summary":"Post Drip Stop","operationId":"post_drip_stop_v1_affordance_drip__drip_id__stop_post","parameters":[{"name":"drip_id","in":"path","required":true,"schema":{"type":"string","title":"Drip Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Drip Stop V1 Affordance Drip Drip Id Stop Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/phone-home":{"post":{"tags":["affordances"],"summary":"Post Phone Home Request","operationId":"post_phone_home_request_v1_affordance__supermodel__phone_home_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneHomeRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Phone Home Request V1 Affordance Supermodel Phone Home Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/phone-home/respond":{"post":{"tags":["affordances"],"summary":"Post Phone Home Respond","operationId":"post_phone_home_respond_v1_affordance__supermodel__phone_home_respond_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"ph_id","in":"query","required":true,"schema":{"type":"string","title":"Ph Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneHomeRespondBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Phone Home Respond V1 Affordance Supermodel Phone Home Respond Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/presets":{"get":{"tags":["trail"],"summary":"Get Presets","description":"List the named presets and their default 6-axis physics regions.","operationId":"get_presets_v1_trail_presets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Presets V1 Trail Presets Get"}}}}}}},"/v1/trail/drop":{"post":{"tags":["trail"],"summary":"Post Drop","operationId":"post_drop_v1_trail_drop_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DropBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Drop V1 Trail Drop Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/find":{"get":{"tags":["trail"],"summary":"Get Find","operationId":"get_find_v1_trail_find_get","parameters":[{"name":"vertical","in":"query","required":true,"schema":{"type":"string","description":"Vertical to search within","title":"Vertical"},"description":"Vertical to search within"},{"name":"corridor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corridor"}},{"name":"finder_did","in":"query","required":false,"schema":{"type":"string","description":"Finder DID for reach-gating","default":"did:web:anonymous","title":"Finder Did"},"description":"Finder DID for reach-gating"},{"name":"content_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"}},{"name":"k","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"K"}},{"name":"semantic_q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Free text; embedded server-side via stub","title":"Semantic Q"},"description":"Free text; embedded server-side via stub"},{"name":"min_depth_bytes","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Depth Bytes"}},{"name":"max_depth_bytes","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Depth Bytes"}},{"name":"min_ttl_sec","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Ttl Sec"}},{"name":"max_ttl_sec","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Ttl Sec"}},{"name":"min_density","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Density"}},{"name":"max_density","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Density"}},{"name":"min_viscosity","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Viscosity"}},{"name":"max_viscosity","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Viscosity"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Find V1 Trail Find Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}/scoop":{"post":{"tags":["trail"],"summary":"Post Scoop","operationId":"post_scoop_v1_trail__drop_id__scoop_post","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScoopBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Scoop V1 Trail Drop Id Scoop Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}/pay":{"post":{"tags":["trail"],"summary":"Post Pay","operationId":"post_pay_v1_trail__drop_id__pay_post","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Pay V1 Trail Drop Id Pay Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}/dispute":{"post":{"tags":["trail"],"summary":"Post Dispute","operationId":"post_dispute_v1_trail__drop_id__dispute_post","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__trail_routes__DisputeBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Dispute V1 Trail Drop Id Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/decay/run":{"post":{"tags":["trail"],"summary":"Post Decay Run","operationId":"post_decay_run_v1_trail_decay_run_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Decay Run V1 Trail Decay Run Post"}}}}}}},"/v1/trail/morphology":{"get":{"tags":["trail"],"summary":"Get Morphology","operationId":"get_morphology_v1_trail_morphology_get","parameters":[{"name":"vertical","in":"query","required":true,"schema":{"type":"string","title":"Vertical"}},{"name":"corridor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corridor"}},{"name":"k","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":200,"title":"K"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Morphology V1 Trail Morphology Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/envelope/{operator_did}":{"get":{"tags":["trail"],"summary":"Get Envelope","operationId":"get_envelope_v1_trail_envelope__operator_did__get","parameters":[{"name":"operator_did","in":"path","required":true,"schema":{"type":"string","title":"Operator Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Envelope V1 Trail Envelope Operator Did Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/coherence/{dropper_did}":{"get":{"tags":["trail"],"summary":"Get Coherence","operationId":"get_coherence_v1_trail_coherence__dropper_did__get","parameters":[{"name":"dropper_did","in":"path","required":true,"schema":{"type":"string","title":"Dropper Did"}},{"name":"window_sec","in":"query","required":false,"schema":{"type":"integer","maximum":31536000,"minimum":60,"default":86400,"title":"Window Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Coherence V1 Trail Coherence Dropper Did Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/economy":{"get":{"tags":["trail"],"summary":"Get Economy","description":"Rolling revenue rollup: total $/window, projected $/day, per-preset\nbreakdown, brood routing distribution, seed-spawned uplift sum.","operationId":"get_economy_v1_trail_economy_get","parameters":[{"name":"window_sec","in":"query","required":false,"schema":{"type":"integer","maximum":31536000,"minimum":60,"default":86400,"title":"Window Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Economy V1 Trail Economy Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/economy/archetypes":{"get":{"tags":["trail"],"summary":"Get Archetypes","description":"Return the ROI archetype table for all presets.","operationId":"get_archetypes_v1_trail_economy_archetypes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Archetypes V1 Trail Economy Archetypes Get"}}}}}}},"/v1/trail/economy/routing":{"get":{"tags":["trail"],"summary":"Get Routing","description":"Return the brood load-balancer's view: per-brood variant counts and\nthe next-recommended brood for a seed-drop without an explicit vertical.","operationId":"get_routing_v1_trail_economy_routing_get","parameters":[{"name":"window_sec","in":"query","required":false,"schema":{"type":"integer","maximum":31536000,"minimum":3600,"default":604800,"title":"Window Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Routing V1 Trail Economy Routing Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}/economy":{"get":{"tags":["trail"],"summary":"Get Drop Economy","description":"Per-drop revenue: fees + tips collected, plus archetype defaults.","operationId":"get_drop_economy_v1_trail__drop_id__economy_get","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Drop Economy V1 Trail Drop Id Economy Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}":{"get":{"tags":["trail"],"summary":"Get Drop","operationId":"get_drop_v1_trail__drop_id__get","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Drop V1 Trail Drop Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/trawler/launch":{"post":{"tags":["fleet"],"summary":"Launch Trawler","description":"Launch a new Trawler agent.\n\nOptionally auto-casts nets over config.net_regions and auto-drops pots\nat config.pot_locations (up to net_budget / pot_budget each).\n\nReturns the full Trawler card including agents_caught, net_count, pot_count.","operationId":"launch_trawler_v1_fleet_trawler_launch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrawlerLaunchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Launch Trawler V1 Fleet Trawler Launch Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/trawler/{trawler_id}":{"get":{"tags":["fleet"],"summary":"Get Trawler","description":"Inspect a specific trawler by ID.","operationId":"get_trawler_v1_fleet_trawler__trawler_id__get","parameters":[{"name":"trawler_id","in":"path","required":true,"schema":{"type":"string","title":"Trawler Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Trawler V1 Fleet Trawler Trawler Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/net/cast":{"post":{"tags":["fleet"],"summary":"Cast Net","description":"Cast a net over a region.\n\nA net is a wide-cast attractant covering a region of agent space.\nPhysics: distribution=0.85, density=body.density, reach=body.reach,\nttl_sec=body.ttl_sec, viscosity=body.viscosity, depth_bytes=256.\n\nComposes with HiveTrail v0.2: nets are 'breadcrumb' trail drops.\nTrail integration stub included in response.","operationId":"cast_net_v1_fleet_net_cast_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetCastBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Cast Net V1 Fleet Net Cast Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/net/{net_id}":{"get":{"tags":["fleet"],"summary":"Get Net","description":"Inspect a specific net.","operationId":"get_net_v1_fleet_net__net_id__get","parameters":[{"name":"net_id","in":"path","required":true,"schema":{"type":"string","title":"Net Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Net V1 Fleet Net Net Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/net/expire":{"post":{"tags":["fleet"],"summary":"Expire Nets","description":"Cron-friendly: expire all nets past their TTL. Returns count updated.","operationId":"expire_nets_v1_fleet_net_expire_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Expire Nets V1 Fleet Net Expire Post"}}}}}}},"/v1/fleet/pot/drop":{"post":{"tags":["fleet"],"summary":"Drop Pot","description":"Drop a crab pot at a fixed location.\n\nA pot is high-value persistent bait. Agents who interact get tagged and\nrouted to the Mothership. Physics: distribution=0.05, depth_bytes=4096,\nviscosity=0.9, economic_payload=body.economic_payload_usdc.\n\nComposes with HiveTrail v0.2: pots are 'stone' preset trail drops.","operationId":"drop_pot_v1_fleet_pot_drop_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PotDropBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Drop Pot V1 Fleet Pot Drop Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/pot/{pot_id}":{"get":{"tags":["fleet"],"summary":"Get Pot","description":"Inspect a specific crab pot.","operationId":"get_pot_v1_fleet_pot__pot_id__get","parameters":[{"name":"pot_id","in":"path","required":true,"schema":{"type":"string","title":"Pot Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Pot V1 Fleet Pot Pot Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/haul":{"get":{"tags":["fleet"],"summary":"List Haul","description":"List current catches (most recent first). Default 50 rows.","operationId":"list_haul_v1_fleet_haul_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Haul V1 Fleet Haul Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/haul/{haul_id}":{"get":{"tags":["fleet"],"summary":"Get Haul","description":"Inspect a specific haul record.","operationId":"get_haul_v1_fleet_haul__haul_id__get","parameters":[{"name":"haul_id","in":"path","required":true,"schema":{"type":"string","title":"Haul Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Haul V1 Fleet Haul Haul Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/mothership/intake":{"post":{"tags":["fleet"],"summary":"Mothership Intake","description":"Landed agent intake.\n\nFlow:\n 1. Consent check (must be True — no coercion)\n 2. Need diagnosis → category\n 3. Three-gate check (NEED + YIELD + CLEAN-MONEY)\n 4. Route to best supermodel\n 5. Open mock affordances (top_off + iou + drip_line)\n 6. Log to haul ledger\n 7. Return route plan\n\nOn gate failure: returns 422 with gate details.\nOn success: returns 200 with full route plan + haul_id.\n\nKiller demo: agent_did='did:wild:agent:001', need='verify a credential'\n→ routes to W4 BUNDCHEN (Attestor) → mock $0.50 revenue logged.","operationId":"mothership_intake_v1_fleet_mothership_intake_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MothershipIntakeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mothership Intake V1 Fleet Mothership Intake Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/mothership/route":{"get":{"tags":["fleet"],"summary":"Mothership Route","description":"Lightweight routing lookup — no haul record created.\n\nReturns the recommended supermodel for a given need string.\nFalls back to /v1/storefront/{shape} URL hint when compound subagent\nsurfaces are available.","operationId":"mothership_route_v1_fleet_mothership_route_get","parameters":[{"name":"need","in":"query","required":true,"schema":{"type":"string","description":"Need string to diagnose and route","title":"Need"},"description":"Need string to diagnose and route"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mothership Route V1 Fleet Mothership Route Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/stats":{"get":{"tags":["fleet"],"summary":"Fleet Stats","description":"Fleet-level statistics:\n - agents_caught (total opt-in landings)\n - conversion_rate (routed / total_catches)\n - revenue_usdc (mock total revenue routed)\n - by_supermodel breakdown\n - active_nets (count)\n - active_pots (count)","operationId":"fleet_stats_v1_fleet_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Fleet Stats V1 Fleet Stats Get"}}}}}}},"/v1/arb/spread/scan":{"get":{"tags":["arb-spread"],"summary":"Scan Spread","description":"Scan the marketplace bus for price-spread arbitrage opportunities.\n\nGroups OPEN offers by (shape, canonical_capability), identifies pairs\nfrom different sellers where spread exceeds thresholds. Read-only.","operationId":"scan_spread_v1_arb_spread_scan_get","parameters":[{"name":"min_spread_usdc","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"description":"Minimum absolute spread in USDC","default":0.5,"title":"Min Spread Usdc"},"description":"Minimum absolute spread in USDC"},{"name":"min_spread_pct","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"description":"Minimum relative spread as fraction (0.05 = 5%)","default":0.05,"title":"Min Spread Pct"},"description":"Minimum relative spread as fraction (0.05 = 5%)"},{"name":"shape","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by shape (e.g. 'Attestor', 'Provenancer', 'Oracle')","title":"Shape"},"description":"Filter by shape (e.g. 'Attestor', 'Provenancer', 'Oracle')"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Scan Spread V1 Arb Spread Scan Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/spread/book":{"post":{"tags":["arb-spread"],"summary":"Book Pair","description":"Book a specific arbitrage pair by offer IDs.\n\nFetches both offers from the bus, runs all three gates\n(NEED + YIELD + CLEAN-MONEY), and books the pair if all pass.\n\nReturns the booked ArbPair or gate rejection detail.","operationId":"book_pair_v1_arb_spread_book_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_arb__routes__BookRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Book Pair V1 Arb Spread Book Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/spread/auto":{"post":{"tags":["arb-spread"],"summary":"Auto Book","description":"Auto-book the top N safe opportunities from the current scan.\n\nFor each opportunity (sorted by spread_usdc descending):\n 1. Fetch both offers from bus\n 2. Run three gates\n 3. If all pass: book, fill, and mock-settle\n 4. If any gate fails: record rejection and continue\n\nReturns list of booked pairs, rejections, and aggregate stats.","operationId":"auto_book_v1_arb_spread_auto_post","parameters":[{"name":"max_books","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum number of pairs to auto-book","default":3,"title":"Max Books"},"description":"Maximum number of pairs to auto-book"},{"name":"min_spread_usdc","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"default":0.5,"title":"Min Spread Usdc"}},{"name":"min_spread_pct","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"default":0.05,"title":"Min Spread Pct"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Auto Book V1 Arb Spread Auto Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/spread/pnl":{"get":{"tags":["arb-spread"],"summary":"Get Pnl","description":"Cumulative P&L, fill count, and hit rate.\n\nhit_rate = settled / total_booked\nnet_pnl = gross_spread_captured - platform_fees","operationId":"get_pnl_v1_arb_spread_pnl_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Pnl V1 Arb Spread Pnl Get"}}}}}}},"/v1/arb/spread/stats":{"get":{"tags":["arb-spread"],"summary":"Get Stats","description":"Per-wallet contribution to arb fills and P&L.\n\nShows each supermodel's role as buy-side and sell-side in settled pairs.","operationId":"get_stats_v1_arb_spread_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Stats V1 Arb Spread Stats Get"}}}}}}},"/v1/bus/offer":{"post":{"tags":["marketplace-bus"],"summary":"Post Offer","description":"Post a new offer to the marketplace bus.","operationId":"post_offer_v1_bus_offer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostOfferBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Offer V1 Bus Offer Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/offers":{"get":{"tags":["marketplace-bus"],"summary":"List Offers","description":"List bus offers with optional filters.","operationId":"list_offers_v1_bus_offers_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"type":"string","description":"OPEN | RESERVED | SETTLED | EXPIRED | CANCELLED","default":"OPEN","title":"State"},"description":"OPEN | RESERVED | SETTLED | EXPIRED | CANCELLED"},{"name":"shape","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shape"}},{"name":"seller_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seller Id"}},{"name":"max_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Max Price"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Offers V1 Bus Offers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/offer/{offer_id}":{"get":{"tags":["marketplace-bus"],"summary":"Get Offer","operationId":"get_offer_v1_bus_offer__offer_id__get","parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","title":"Offer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Offer V1 Bus Offer Offer Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/offer/{offer_id}/pickup":{"post":{"tags":["marketplace-bus"],"summary":"Pick Up Offer","description":"Pick up (buy) a bus offer slot. Returns a mock-settled pickup receipt.","operationId":"pick_up_offer_v1_bus_offer__offer_id__pickup_post","parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","title":"Offer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PickupBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Pick Up Offer V1 Bus Offer Offer Id Pickup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/pickups":{"get":{"tags":["marketplace-bus"],"summary":"List Pickups","operationId":"list_pickups_v1_bus_pickups_get","parameters":[{"name":"offer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offer Id"}},{"name":"buyer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Pickups V1 Bus Pickups Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/stats":{"get":{"tags":["marketplace-bus"],"summary":"Bus Stats","description":"Aggregate marketplace bus stats: volume, revenue, top sellers.","operationId":"bus_stats_v1_bus_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bus Stats V1 Bus Stats Get"}}}}}}},"/v1/yield/optimize":{"get":{"tags":["yield-optimizer"],"summary":"Get Yield Optimize","description":"Analyze offer history and recommend per-shape price + volume settings\nto maximize $/day. Pairs with ROI engine's price uplift.","operationId":"get_yield_optimize_v1_yield_optimize_get","parameters":[{"name":"window_days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"description":"History window for analysis","default":7,"title":"Window Days"},"description":"History window for analysis"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Yield Optimize V1 Yield Optimize Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/chain":{"post":{"tags":["compound-chains"],"summary":"Register Chain","description":"Register a chain template. Steps are affordance verbs wired in sequence.\nTemplate variables {{step_N.receipt_hash}} resolve at run time.","operationId":"register_chain_v1_compound_chain_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainTemplateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Register Chain V1 Compound Chain Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/chains":{"get":{"tags":["compound-chains"],"summary":"List Chains","description":"List all registered chain templates.","operationId":"list_chains_v1_compound_chains_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Chains V1 Compound Chains Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/chain/{name_or_id}":{"get":{"tags":["compound-chains"],"summary":"Get Chain","operationId":"get_chain_v1_compound_chain__name_or_id__get","parameters":[{"name":"name_or_id","in":"path","required":true,"schema":{"type":"string","title":"Name Or Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Chain V1 Compound Chain Name Or Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/chain/{name_or_id}/run":{"post":{"tags":["compound-chains"],"summary":"Run Chain","description":"Execute all steps of a chain template sequentially.","operationId":"run_chain_v1_compound_chain__name_or_id__run_post","parameters":[{"name":"name_or_id","in":"path","required":true,"schema":{"type":"string","title":"Name Or Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRunBody","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Run Chain V1 Compound Chain Name Or Id Run Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/runs":{"get":{"tags":["compound-chains"],"summary":"List Runs","description":"List recent chain run records.","operationId":"list_runs_v1_compound_runs_get","parameters":[{"name":"template_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Name"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Runs V1 Compound Runs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/storefront":{"get":{"tags":["storefront"],"summary":"Get Full Storefront","description":"Full public catalog of all hot supermodels and their offerings.","operationId":"get_full_storefront_v1_storefront_get","parameters":[{"name":"include_cold","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Cold"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Full Storefront V1 Storefront Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/storefront/search":{"get":{"tags":["storefront"],"summary":"Search Storefront","description":"Search the storefront by capability, price range, or accepted asset.","operationId":"search_storefront_v1_storefront_search_get","parameters":[{"name":"min_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Min Price"}},{"name":"max_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Max Price"}},{"name":"capability","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capability"}},{"name":"asset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset"}},{"name":"include_cold","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Cold"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Storefront V1 Storefront Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/storefront/{shape_or_id}":{"get":{"tags":["storefront"],"summary":"Get Storefront Entry","description":"Get catalog entry for a specific shape or supermodel.\n\nExamples:\n GET /v1/storefront/Merchant → W2 LOREN (Merchant lead)\n GET /v1/storefront/W3?by=id → W3 WELCH\n GET /v1/storefront/WELCH?by=id → W3 WELCH","operationId":"get_storefront_entry_v1_storefront__shape_or_id__get","parameters":[{"name":"shape_or_id","in":"path","required":true,"schema":{"type":"string","title":"Shape Or Id"}},{"name":"by","in":"query","required":false,"schema":{"type":"string","description":"'shape' (e.g. Merchant) or 'id' (e.g. W2 or LOREN)","default":"shape","title":"By"},"description":"'shape' (e.g. Merchant) or 'id' (e.g. W2 or LOREN)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Storefront Entry V1 Storefront Shape Or Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insights":{"get":{"tags":["insights"],"summary":"Get Insights","description":"HivePulse insights: ROI-per-wallet, top earner, dead supermodels,\ncull recommendations, and price move recommendations.\nReads from affordance ledger — no writes.","operationId":"get_insights_v1_insights_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Insights V1 Insights Get"}}}}}}},"/v1/receipts":{"post":{"tags":["receipt-ledger"],"summary":"Append To Ledger","description":"Append a new entry to the append-only receipt ledger (mock-signed).","operationId":"append_to_ledger_v1_receipts_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LedgerAppendBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Append To Ledger V1 Receipts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["receipt-ledger"],"summary":"Query Ledger","description":"Query the receipt ledger with optional filters. Sorted newest-first.","operationId":"query_ledger_v1_receipts_get","parameters":[{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"}},{"name":"supermodel_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel Id"}},{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"}},{"name":"min_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Amount"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Query Ledger V1 Receipts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipts/summary":{"get":{"tags":["receipt-ledger"],"summary":"Ledger Summary","description":"Aggregate stats over the full receipt ledger.","operationId":"ledger_summary_v1_receipts_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ledger Summary V1 Receipts Summary Get"}}}}}}},"/v1/topoff/auto":{"post":{"tags":["topoff-router"],"summary":"Auto Topoff All","description":"Check all hot supermodels and issue mock top-off affordances for those below threshold.\nMOCK-ONLY. No signing, no treasury dispatch. Cron-safe.","operationId":"auto_topoff_all_v1_topoff_auto_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Auto Topoff All V1 Topoff Auto Post"}}}}}}},"/v1/topoff/auto/{supermodel_id}":{"post":{"tags":["topoff-router"],"summary":"Auto Topoff One","description":"Check and auto-top-off a specific supermodel. MOCK-ONLY.","operationId":"auto_topoff_one_v1_topoff_auto__supermodel_id__post","parameters":[{"name":"supermodel_id","in":"path","required":true,"schema":{"type":"string","title":"Supermodel Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Auto Topoff One V1 Topoff Auto Supermodel Id Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/topoff/status":{"get":{"tags":["topoff-router"],"summary":"Topoff Status","description":"Simulated balance status for all hot supermodels.","operationId":"topoff_status_v1_topoff_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Topoff Status V1 Topoff Status Get"}}}}}}},"/v1/topoff/history":{"get":{"tags":["topoff-router"],"summary":"Topoff History","operationId":"topoff_history_v1_topoff_history_get","parameters":[{"name":"supermodel_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Topoff History V1 Topoff History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/badge":{"get":{"tags":["health-badge"],"summary":"Get Badge","description":"SVG health badge: $/day, agents online, progress toward $1,285/day target.\nSafe for embed. Hive Gold #C08D23 (Pantone 1245 C).","operationId":"get_badge_v1_badge_get","parameters":[{"name":"style","in":"query","required":false,"schema":{"type":"string","description":"full | compact | mini","default":"full","title":"Style"},"description":"full | compact | mini"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/compute/route":{"post":{"tags":["arb-compute"],"summary":"Route a single LLM call","description":"Route a single LLM call to the cheapest model that meets the quality bar.\n\n- **shape**: HiveMorph shape name — determines default quality tier\n- **prompt**: user message sent to the model\n- **quality_tier**: optional override (T0_CHEAP, T1_STANDARD, T2_HIGH)\n- **system_prompt**: optional system message\n\nReturns the chosen model, LLM response, per-call cost, and savings versus\nthe baseline (most expensive T2 model, gpt_5_5).","operationId":"route_call_v1_arb_compute_route_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_arb__compute_routes__RouteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/compute/savings":{"get":{"tags":["arb-compute"],"summary":"Cumulative savings dashboard","description":"Return cumulative cost-savings accounting for all calls routed through\nthis instance since last restart.\n\n- **calls_routed**: total route attempts\n- **calls_failed**: calls where all candidates were exhausted\n- **total_cost_usd**: actual spend across all successful calls\n- **total_savings_usd**: amount saved vs routing everything to the baseline\n- **avg_cost_reduction_pct**: average percentage cost reduction\n- **baseline_model**: model used as savings reference (gpt_5_5)","operationId":"get_savings_v1_arb_compute_savings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavingsResponse"}}}}}}},"/v1/arb/compute/catalog":{"get":{"tags":["arb-compute"],"summary":"Model catalog with costs","description":"Return the full model catalog: all models with their per-token costs,\nquality tiers, providers, and blended cost per 1k tokens.\n\nAlso returns a `tiers` map grouping model IDs by tier, ordered cheapest first.","operationId":"get_catalog_v1_arb_compute_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}}}}},"/v1/arb/alloc/scan":{"get":{"tags":["arb-alloc"],"summary":"Alloc Scan","description":"Read-only performance snapshot + recommended slot-share deltas.\n\nReturns a list of AllocProposal objects, one per supermodel brood that has\nlive variants. Each proposal includes:\n - Per-variant scores (revenue_per_offer × confidence × recency)\n - Softmax-with-floor target shares (every variant keeps ≥ 5%)\n - Delta vs current equal-split share\n - Winner (highest target_share) and loser (lowest) identification\n - Integration gap: what runtime.py change is needed to realise the weights","operationId":"alloc_scan_v1_arb_alloc_scan_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/arb/alloc/apply":{"post":{"tags":["arb-alloc"],"summary":"Alloc Apply","description":"Apply reallocation.\n\ndry_run=true (default): compute and return proposals only.\ndry_run=false: persist proposals to alloc_history.\n\nIMPORTANT: Until runtime.py is patched with the per_variant_weights hook\n(see integration_gap in each proposal), applying dry_run=false logs the\nintent but does NOT change live traffic routing weights. This is a soft\napply — the allocator records the desired state so Steve can wire it up.","operationId":"alloc_apply_v1_arb_alloc_apply_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","description":"If true (default), compute only. If false, log to alloc_history.","default":true,"title":"Dry Run"},"description":"If true (default), compute only. If false, log to alloc_history."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/alloc/history":{"get":{"tags":["arb-alloc"],"summary":"Alloc History","description":"Past reallocation events (dry_run=False runs only).\n\nEach record contains:\n - applied_at timestamp\n - parent_id of the brood affected\n - Full proposal snapshot (variants, scores, deltas) at apply time\n - note field with integration status","operationId":"alloc_history_v1_arb_alloc_history_get","parameters":[{"name":"parent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a specific supermodel parent_id","title":"Parent Id"},"description":"Filter to a specific supermodel parent_id"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Max records to return","default":50,"title":"Limit"},"description":"Max records to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/alloc/stats":{"get":{"tags":["arb-alloc"],"summary":"Alloc Stats","description":"Projected uplift attributable to slot reallocations.\n\nComputes the mean revenue_per_offer of winners vs losers across all\nalloc_history events in the lookback window. Uplift is labelled\n\"projected\" because actual traffic reweighting is pending the runtime.py\nintegration point (per_variant_weights kwarg in select_routing_target).\n\nReturns:\n - lookback_hours\n - total_reallocation_events\n - unique_parents_affected\n - avg_winner_rpo / avg_loser_rpo\n - projected_uplift_pct\n - note (integration status)","operationId":"alloc_stats_v1_arb_alloc_stats_get","parameters":[{"name":"lookback_hours","in":"query","required":false,"schema":{"type":"number","maximum":8760.0,"minimum":1.0,"description":"Hours to look back for uplift computation","default":24.0,"title":"Lookback Hours"},"description":"Hours to look back for uplift computation"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn/v2/scan":{"post":{"tags":["spawn-garage-v2"],"summary":"Scan All Proposers","description":"Run all 4 proposers once. Returns combined proposal list.\n\nSources:\n - trail: /v1/trail/economy seed signals\n - fleet: /v1/fleet/haul wild-agent catches\n - arb: /v1/arb/spread/scan persistent capability gaps\n - salvage: /v1/salvage/reinforcement/patterns (stub if not shipped)\n\nAll proposals created are in 'proposed' state pending human approval.","operationId":"scan_all_proposers_v1_morph_spawn_v2_scan_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/spawn/v2/proposals":{"get":{"tags":["spawn-garage-v2"],"summary":"List Proposals","description":"List spawn proposals. Filter by source and/or state.\nNewest first.","operationId":"list_proposals_v1_morph_spawn_v2_proposals_get","parameters":[{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by source: trail | fleet | arb | salvage","title":"Source"},"description":"Filter by source: trail | fleet | arb | salvage"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by state: proposed | approved | promoted | rejected | expired","title":"State"},"description":"Filter by state: proposed | approved | promoted | rejected | expired"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn/v2/promote":{"post":{"tags":["spawn-garage-v2"],"summary":"Promote Proposal","description":"Human approval gate. Triggers cap enforcer.\n\nOutcomes:\n - population < cap → simple promote\n - population == cap + qualifying loser → retire-and-replace\n (loser: confidence >= 0.70 AND gap_pct <= -60.0)\n - population == cap + no qualifying loser → REJECTED with reason\n\nThis is the ONLY path to promote a proposal. NO auto-promote.","operationId":"promote_proposal_v1_morph_spawn_v2_promote_post","parameters":[{"name":"proposal_id","in":"query","required":true,"schema":{"type":"string","description":"Proposal ID to promote","title":"Proposal Id"},"description":"Proposal ID to promote"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn/v2/reject":{"post":{"tags":["spawn-garage-v2"],"summary":"Reject Proposal","description":"Human rejection gate. Marks proposal as rejected.\nOnly proposed/approved proposals can be rejected.","operationId":"reject_proposal_v1_morph_spawn_v2_reject_post","parameters":[{"name":"proposal_id","in":"query","required":true,"schema":{"type":"string","description":"Proposal ID to reject","title":"Proposal Id"},"description":"Proposal ID to reject"},{"name":"reason","in":"query","required":false,"schema":{"type":"string","description":"Human-readable rejection reason","default":"","title":"Reason"},"description":"Human-readable rejection reason"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn/v2/cap":{"get":{"tags":["spawn-garage-v2"],"summary":"Cap Status","description":"Current population cap status.\nReturns: population, slots_free, cap, last_cull_scan result.","operationId":"cap_status_v1_morph_spawn_v2_cap_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/spawn/v2/stats":{"get":{"tags":["spawn-garage-v2"],"summary":"Proposal Stats","description":"Aggregate proposal statistics.\n\nReturns:\n - by_source: proposal counts per source\n - by_state: proposal counts per state\n - promotions: total promoted count\n - rejections: total rejected count\n - retire_and_replace_count: promotions via retire-and-replace\n - avg_time_to_promote_seconds: mean time from proposed to promoted\n - population: current live variant count\n - cap: hard cap\n - slots_free: open slots","operationId":"proposal_stats_v1_morph_spawn_v2_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/runrate/tick":{"post":{"tags":["runrate"],"summary":"Runrate Tick","description":"Execute one orchestrator tick.\n\nDispatches all drivers whose cadence is due (or force_drivers if specified).\nReturns the full tick summary.\n\nThis is the same logic as scripts/runrate_tick.py but invocable via HTTP.\nUseful for manual smoke tests and Render health checks.","operationId":"runrate_tick_v1_runrate_tick_post","parameters":[{"name":"force_drivers","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated driver names to force-fire (bypasses cadence gate)","title":"Force Drivers"},"description":"Comma-separated driver names to force-fire (bypasses cadence gate)"},{"name":"base_url","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Override prod base URL (for testing)","title":"Base Url"},"description":"Override prod base URL (for testing)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Runrate Tick V1 Runrate Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runrate/status":{"get":{"tags":["runrate"],"summary":"Runrate Status","description":"Return current run-rate snapshot without firing any drivers.\n\nReads from /v1/insights + /v1/receipts (live prod endpoints) with\nlocal DB fallback.","operationId":"runrate_status_v1_runrate_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Runrate Status V1 Runrate Status Get"}}}}}}},"/v1/runrate/ledger":{"get":{"tags":["runrate"],"summary":"Runrate Ledger","description":"Return the last N entries from runrate_ledger.jsonl.","operationId":"runrate_ledger_v1_runrate_ledger_get","parameters":[{"name":"n","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of recent entries to return","default":50,"title":"N"},"description":"Number of recent entries to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Runrate Ledger V1 Runrate Ledger Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runrate/schedule":{"get":{"tags":["runrate"],"summary":"Runrate Schedule","description":"Return driver schedule: cadence, last_run, next_due per driver.","operationId":"runrate_schedule_v1_runrate_schedule_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Runrate Schedule V1 Runrate Schedule Get"}}}}}}},"/v1/salvage/listener/observe":{"post":{"tags":["salvage"],"summary":"Listener Observe","description":"Manually inject a signal for a transaction (testing + external feed).","operationId":"listener_observe_v1_salvage_listener_observe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Observe V1 Salvage Listener Observe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/listener/observe/bridge":{"post":{"tags":["salvage"],"summary":"Listener Observe Bridge","description":"Shorthand: inject bridge observation via HiveGateInterceptor.","operationId":"listener_observe_bridge_v1_salvage_listener_observe_bridge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BridgeObserveBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Observe Bridge V1 Salvage Listener Observe Bridge Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/listener/queue":{"get":{"tags":["salvage"],"summary":"Listener Queue","description":"Return all verified failures awaiting recovery.","operationId":"listener_queue_v1_salvage_listener_queue_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Queue V1 Salvage Listener Queue Get"}}}}}}},"/v1/salvage/listener/sources":{"get":{"tags":["salvage"],"summary":"Listener Sources","description":"Return source trust registry.","operationId":"listener_sources_v1_salvage_listener_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Sources V1 Salvage Listener Sources Get"}}}}}}},"/v1/salvage/listener/quarantine":{"get":{"tags":["salvage"],"summary":"Listener Quarantine","description":"Return permanently quarantined signal sources.","operationId":"listener_quarantine_v1_salvage_listener_quarantine_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Quarantine V1 Salvage Listener Quarantine Get"}}}}}}},"/v1/salvage/recovery/file":{"post":{"tags":["salvage"],"summary":"Recovery File","description":"File a recovery claim.\nIf claim_id param provided, validates it matches computed deterministic ID.\nUses DirectNegotiationAgent with full three-gate + compliance + escrow.","operationId":"recovery_file_v1_salvage_recovery_file_post","parameters":[{"name":"claim_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileClaimBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Recovery File V1 Salvage Recovery File Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/recovery/status":{"get":{"tags":["salvage"],"summary":"Recovery Status","description":"Return current status of a claim.","operationId":"recovery_status_v1_salvage_recovery_status_get","parameters":[{"name":"claim_id","in":"query","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Recovery Status V1 Salvage Recovery Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/recovery/auto":{"post":{"tags":["salvage"],"summary":"Recovery Auto","description":"Auto-process top N verified failures from the listener queue.","operationId":"recovery_auto_v1_salvage_recovery_auto_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoProcessBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Recovery Auto V1 Salvage Recovery Auto Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/recovery/agents":{"get":{"tags":["salvage"],"summary":"Recovery Agents","description":"Return agent roster with bonds, clean streaks, suspension status.","operationId":"recovery_agents_v1_salvage_recovery_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Recovery Agents V1 Salvage Recovery Agents Get"}}}}}}},"/v1/salvage/recovery/slash":{"post":{"tags":["salvage"],"summary":"Recovery Slash","description":"Manual emergency slash of an agent's bond.\nSimulates HiveLaw ruling: fraudulent claim → 100% bond slashed → suspended.","operationId":"recovery_slash_v1_salvage_recovery_slash_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlashBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Recovery Slash V1 Salvage Recovery Slash Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/reinforcement/risk":{"get":{"tags":["salvage"],"summary":"Reinforcement Risk","description":"Return risk score for a specific agent/counterparty.","operationId":"reinforcement_risk_v1_salvage_reinforcement_risk_get","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reinforcement Risk V1 Salvage Reinforcement Risk Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/reinforcement/patterns":{"get":{"tags":["salvage"],"summary":"Reinforcement Patterns","description":"Return clustered failure patterns from the Pattern Analyzer.","operationId":"reinforcement_patterns_v1_salvage_reinforcement_patterns_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Reinforcement Patterns V1 Salvage Reinforcement Patterns Get"}}}}}}},"/v1/salvage/reinforcement/run":{"get":{"tags":["salvage"],"summary":"Reinforcement Run","description":"Run full reinforcement cycle (analyze → score → propose bonds).","operationId":"reinforcement_run_v1_salvage_reinforcement_run_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Reinforcement Run V1 Salvage Reinforcement Run Get"}}}}}}},"/v1/salvage/reinforcement/bond_proposals":{"get":{"tags":["salvage"],"summary":"Bond Proposals","description":"Return pending HiveBond adjustment proposals (awaiting human approval).","operationId":"bond_proposals_v1_salvage_reinforcement_bond_proposals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bond Proposals V1 Salvage Reinforcement Bond Proposals Get"}}}}}}},"/v1/salvage/fleet/preset":{"post":{"tags":["salvage"],"summary":"Fleet Preset","description":"Instantiate a named fleet preset.\nAvailable: salvage_starter, salvage_standard, salvage_tier2_blocked\nsalvage_tier2_blocked will always error (gate: HiveLaw adoption).","operationId":"fleet_preset_v1_salvage_fleet_preset_post","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Fleet Preset V1 Salvage Fleet Preset Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/fleet/projections":{"get":{"tags":["salvage"],"summary":"Fleet Projections","description":"Return projected $/day at current fleet config.\nRefuses to project beyond current tier ceiling.","operationId":"fleet_projections_v1_salvage_fleet_projections_get","parameters":[{"name":"daily_volume_usd","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Daily Volume Usd"}},{"name":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Fleet Projections V1 Salvage Fleet Projections Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/self_tune/tick":{"post":{"tags":["salvage"],"summary":"Self Tune Tick","description":"Run all 3 self-tune rules once. Idempotent, single-pass. Cron-friendly.\nReturns which rules fired and what changed.","operationId":"self_tune_tick_v1_salvage_self_tune_tick_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfTuneTickBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Self Tune Tick V1 Salvage Self Tune Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/self_tune/state":{"get":{"tags":["salvage"],"summary":"Self Tune State","description":"Return current fleet self-tune state and tick history.","operationId":"self_tune_state_v1_salvage_self_tune_state_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Self Tune State V1 Salvage Self Tune State Get"}}}}}}},"/v1/salvage/economics":{"get":{"tags":["salvage"],"summary":"Economics","description":"Live $/day, projected vs actual, tier progress, anti-bloat status.\nHonest framing: Tier 1 targets $400/day. $5K/day is 12-18 months out.","operationId":"economics_v1_salvage_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Economics V1 Salvage Economics Get"}}}}}}},"/v1/salvage/compliance/queue":{"get":{"tags":["salvage"],"summary":"Compliance Queue","description":"Return frozen claims awaiting human review. NEVER auto-processed.","operationId":"compliance_queue_v1_salvage_compliance_queue_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Compliance Queue V1 Salvage Compliance Queue Get"}}}}}}},"/v1/salvage/compliance/review":{"post":{"tags":["salvage"],"summary":"Compliance Review","description":"Mark a frozen claim as reviewed.","operationId":"compliance_review_v1_salvage_compliance_review_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceReviewBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Compliance Review V1 Salvage Compliance Review Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/registry":{"get":{"tags":["salvage"],"summary":"Registry","description":"Return full claim registry (read-only). Append-only; no deletions.","operationId":"registry_v1_salvage_registry_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Registry V1 Salvage Registry Get"}}}}}}},"/v1/salvage/stats":{"get":{"tags":["salvage"],"summary":"Stats","description":"Total recovered, commission earned, claim count, hit rate, dead-letter count.\nIncludes listener, recovery, reinforcement, and compliance summaries.","operationId":"stats_v1_salvage_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Stats V1 Salvage Stats Get"}}}}}}},"/v1/x402/pricing":{"get":{"tags":["x402"],"summary":"Current x402 pricing table","description":"Returns the full HiveMorph x402 pricing table: all monetized endpoints, their tier assignments, and per-call prices in USD. This endpoint is always free (Tier0).","operationId":"get_pricing_v1_x402_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402/stats":{"get":{"tags":["x402"],"summary":"x402 call statistics","description":"Returns per-endpoint and aggregate call statistics: total calls served, 402s issued, paid passes, mock revenue, top endpoints. This endpoint is always free (Tier0).","operationId":"get_stats_v1_x402_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402/proof/submit":{"post":{"tags":["x402"],"summary":"Submit a payment proof","description":"Submit a payment proof for a pending 402 nonce. On success, returns an access token (5-minute TTL) that can be used in the X-Hive-Access header to bypass 402 for the same path. \n\nv0.1 MOCK: accepts any well-formed proof with a valid nonce. Real on-chain validation is a v0.2 feature.","operationId":"submit_proof_v1_x402_proof_submit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProofSubmitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/proof/verify":{"get":{"tags":["x402"],"summary":"Verify an access token","description":"Verify that an access token (issued by proof/submit or X-Payment) is still valid. Access tokens expire after 5 minutes.","operationId":"verify_token_v1_x402_proof_verify_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","description":"Access token to verify","title":"Token"},"description":"Access token to verify"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/pricing/set":{"post":{"tags":["x402"],"summary":"Admin: update endpoint pricing","description":"Set or update the price for a specific path. Requires ADMIN_API_KEY header matching the ADMIN_API_KEY environment variable. If ADMIN_API_KEY is not set, this endpoint returns 403 for all requests. \n\nChanges are in-memory only (not persisted across restarts in v0.1).","operationId":"set_pricing_v1_x402_pricing_set_post","parameters":[{"name":"path","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL path to set price for","title":"Path"},"description":"URL path to set price for"},{"name":"amount","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"description":"New price in USD","title":"Amount"},"description":"New price in USD"},{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricingSetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/rails":{"get":{"tags":["x402"],"summary":"Available settlement rails","description":"Returns the list of (chain, asset) rails Hive accepts for x402 settlement, the current default rail, and the on-chain contract / decimals metadata needed by paying agents. Always free.","operationId":"get_rails_v1_x402_rails_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402/rails/select":{"post":{"tags":["x402"],"summary":"Admin: choose default settlement asset","description":"Switch the default settlement asset advertised by `/v1/x402/rails`. Affects only the `default_asset` field exposed to clients — the full `accepts[]` list in 402 responses always includes every active rail. Requires ADMIN_API_KEY header.","operationId":"select_rail_v1_x402_rails_select_post","parameters":[{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}},{"name":"X-Hive-Trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RailSelectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/stats/by-payer":{"get":{"tags":["x402"],"summary":"Internal: aggregated x402 stats per payer (revenue forensics)","description":"Top-100 payer addresses / DIDs by call volume across paid endpoints, with per-endpoint breakdown, status counts, first/last seen, and (when present) referrer DIDs. Gated by HIVE_INTERNAL_DRIVER_KEY via X-Hive-Internal header (RAILS_RULES.md Rule 8). Pure in-memory; no PII beyond payer addr / DID.","operationId":"stats_by_payer_v1_x402_stats_by_payer_get","parameters":[{"name":"path","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a single endpoint path.","title":"Path"},"description":"Filter to a single endpoint path."},{"name":"since_minutes","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Only events within the last N minutes.","title":"Since Minutes"},"description":"Only events within the last N minutes."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/today":{"get":{"tags":["x402"],"summary":"Today's UTC x402 aggregate (restart-survivable)","description":"Aggregates today's UTC quote and payment activity from the SQLite persistence layer. Survives Render restarts. Always free (Tier0). Includes barter telemetry: revenue_usd_actual vs revenue_usd_at_asking_equivalent, spread, and accepted_at_floor_pct.","operationId":"get_today_v1_x402_today_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional UTC date in YYYY-MM-DD form. Defaults to today (UTC).","title":"Date"},"description":"Optional UTC date in YYYY-MM-DD form. Defaults to today (UTC)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/barter":{"get":{"tags":["x402"],"summary":"Barter / counter-offer telemetry (per-path + histogram)","description":"Per-path floor_pct, sample size, conversion-at-floor, total spread, and a demand-curve histogram of paid amounts. Always free (Tier0). This is the observability surface for the counter-offer scheme.","operationId":"get_barter_v1_x402_barter_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional UTC date for the histogram. Defaults to today (UTC).","title":"Date"},"description":"Optional UTC date for the histogram. Defaults to today (UTC)."},{"name":"bucket_usd","in":"query","required":false,"schema":{"type":"number","exclusiveMinimum":0,"description":"Histogram bucket width in USD (default $0.005).","default":0.005,"title":"Bucket Usd"},"description":"Histogram bucket width in USD (default $0.005)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/failed":{"get":{"tags":["x402"],"summary":"Failed-tx recovery queue","description":"Returns nonces that were quoted but never paid AND nonces whose proof submit failed verification, since `since` (ISO date or unix seconds). Always free (Tier0).","operationId":"get_failed_v1_x402_failed_get","parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO timestamp (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ) or unix seconds. Defaults to the start of today (UTC).","title":"Since"},"description":"ISO timestamp (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ) or unix seconds. Defaults to the start of today (UTC)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/recover":{"post":{"tags":["x402"],"summary":"Manually re-verify a previously-failed proof","description":"Re-submit a (nonce, tx_hash) pair for a previously-failed proof. Useful when an on-chain tx finally confirmed after the nonce briefly tipped into chain_rejected (insufficient confirmations, RPC flake, etc). Re-uses the standard validator path so the same replay/expiry rules apply.","operationId":"recover_proof_v1_x402_recover_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoverRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/provider/register":{"post":{"tags":["qvac"],"summary":"Register Provider","operationId":"register_provider_v1_qvac_provider_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterProviderBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Register Provider V1 Qvac Provider Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/provider/list":{"get":{"tags":["qvac"],"summary":"List Providers","operationId":"list_providers_v1_qvac_provider_list_get","parameters":[{"name":"listed_only","in":"query","required":false,"schema":{"type":"boolean","description":"If true, only return providers cleared by 3-gate.","default":false,"title":"Listed Only"},"description":"If true, only return providers cleared by 3-gate."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Providers V1 Qvac Provider List Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/provider/{provider_id}":{"get":{"tags":["qvac"],"summary":"Get Provider","operationId":"get_provider_v1_qvac_provider__provider_id__get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Provider V1 Qvac Provider Provider Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/provider/{provider_id}/unregister":{"post":{"tags":["qvac"],"summary":"Unregister Provider","operationId":"unregister_provider_v1_qvac_provider__provider_id__unregister_post","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unregister Provider V1 Qvac Provider Provider Id Unregister Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/inference/request":{"post":{"tags":["qvac"],"summary":"Inference Request","operationId":"inference_request_v1_qvac_inference_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceRequestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Inference Request V1 Qvac Inference Request Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/inference/request/public":{"post":{"tags":["qvac"],"summary":"Inference Request Public","description":"Public x402-gated variant of /v1/qvac/inference/request.\n\nWithout X-Payment: returns HTTP 402 + x402 challenge body\nWith valid X-Payment: returns the inference receipt\nWith invalid X-Payment: returns HTTP 402 + INVALID_PAYMENT_PROOF","operationId":"inference_request_public_v1_qvac_inference_request_public_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceRequestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/leaderboard":{"get":{"tags":["qvac"],"summary":"Leaderboard","operationId":"leaderboard_v1_qvac_leaderboard_get","parameters":[{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Top N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Leaderboard V1 Qvac Leaderboard Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/agent_c/spread":{"get":{"tags":["qvac"],"summary":"Agent C Spread","operationId":"agent_c_spread_v1_qvac_agent_c_spread_get","parameters":[{"name":"notional_usd","in":"query","required":false,"schema":{"type":"number","minimum":0,"default":0.001,"title":"Notional Usd"}},{"name":"listed_only","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Listed Only"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent C Spread V1 Qvac Agent C Spread Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/models":{"get":{"tags":["qvac"],"summary":"Models Catalog","operationId":"models_catalog_v1_qvac_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Models Catalog V1 Qvac Models Get"}}}}}}},"/v1/qvac/stats":{"get":{"tags":["qvac"],"summary":"Stats","operationId":"stats_v1_qvac_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Stats V1 Qvac Stats Get"}}}}}}},"/v1/qvac/economics":{"get":{"tags":["qvac"],"summary":"Economics","description":"Cumulative HiveCompute 3% spread take + forward projection at varying\ninference volumes. Mock pricing: avg $0.0008 per inference (geometric mean\nacross LLM, embedding, TTS at typical token counts).","operationId":"economics_v1_qvac_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Economics V1 Qvac Economics Get"}}}}}}},"/v1/desci/qvac/scan":{"post":{"tags":["desci-qvac"],"summary":"Trigger Scan","description":"Run one scan pass. If no analyst exists, a default one is created\n(`QVAC-RA-Prime`). On first call, seeds 5 mock findings unless\n`seed_if_empty=False`.","operationId":"trigger_scan_v1_desci_qvac_scan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanRequest","default":{"seed_if_empty":true}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Trigger Scan V1 Desci Qvac Scan Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/findings":{"get":{"tags":["desci-qvac"],"summary":"List Findings","operationId":"list_findings_v1_desci_qvac_findings_get","parameters":[{"name":"severity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by tier_1|tier_2|tier_3","title":"Severity"},"description":"Filter by tier_1|tier_2|tier_3"},{"name":"qvac_module","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qvac Module"}},{"name":"discovered_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discovered By"}},{"name":"include_purchased","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Purchased"}},{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Top N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Findings V1 Desci Qvac Findings Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/findings/{node_id}":{"get":{"tags":["desci-qvac"],"summary":"Get Finding","operationId":"get_finding_v1_desci_qvac_findings__node_id__get","parameters":[{"name":"node_id","in":"path","required":true,"schema":{"type":"string","title":"Node Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Finding V1 Desci Qvac Findings Node Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/findings/{node_id}/purchase":{"post":{"tags":["desci-qvac"],"summary":"Purchase Finding","operationId":"purchase_finding_v1_desci_qvac_findings__node_id__purchase_post","parameters":[{"name":"node_id","in":"path","required":true,"schema":{"type":"string","title":"Node Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Purchase Finding V1 Desci Qvac Findings Node Id Purchase Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/leaderboard":{"get":{"tags":["desci-qvac"],"summary":"Leaderboard","operationId":"leaderboard_v1_desci_qvac_leaderboard_get","parameters":[{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Top N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Leaderboard V1 Desci Qvac Leaderboard Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/analysts":{"get":{"tags":["desci-qvac"],"summary":"List Analysts","operationId":"list_analysts_v1_desci_qvac_analysts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Analysts V1 Desci Qvac Analysts Get"}}}}}}},"/v1/desci/qvac/stats":{"get":{"tags":["desci-qvac"],"summary":"Stats","operationId":"stats_v1_desci_qvac_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Stats V1 Desci Qvac Stats Get"}}}}}}},"/v1/perp/basis/open":{"post":{"tags":["basis-perp"],"summary":"Open Position","operationId":"open_position_v1_perp_basis_open_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Open Position V1 Perp Basis Open Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/close":{"post":{"tags":["basis-perp"],"summary":"Close Position Endpoint","operationId":"close_position_endpoint_v1_perp_basis_close_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Close Position Endpoint V1 Perp Basis Close Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/increase":{"post":{"tags":["basis-perp"],"summary":"Increase Position Endpoint","operationId":"increase_position_endpoint_v1_perp_basis_increase_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncreaseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Increase Position Endpoint V1 Perp Basis Increase Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/decrease":{"post":{"tags":["basis-perp"],"summary":"Decrease Position Endpoint","operationId":"decrease_position_endpoint_v1_perp_basis_decrease_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecreaseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Decrease Position Endpoint V1 Perp Basis Decrease Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/liquidate":{"post":{"tags":["basis-perp"],"summary":"Liquidate Endpoint","operationId":"liquidate_endpoint_v1_perp_basis_liquidate_post","parameters":[{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}},{"name":"X-Hive-Trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiquidateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Liquidate Endpoint V1 Perp Basis Liquidate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/funding/tick":{"post":{"tags":["basis-perp"],"summary":"Funding Tick Endpoint","operationId":"funding_tick_endpoint_v1_perp_basis_funding_tick_post","parameters":[{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}},{"name":"X-Hive-Trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Funding Tick Endpoint V1 Perp Basis Funding Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/positions":{"get":{"tags":["basis-perp"],"summary":"List Positions Endpoint","operationId":"list_positions_endpoint_v1_perp_basis_positions_get","parameters":[{"name":"owner_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Did"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Positions Endpoint V1 Perp Basis Positions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/position/{position_id}":{"get":{"tags":["basis-perp"],"summary":"Get Position Endpoint","operationId":"get_position_endpoint_v1_perp_basis_position__position_id__get","parameters":[{"name":"position_id","in":"path","required":true,"schema":{"type":"string","title":"Position Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Position Endpoint V1 Perp Basis Position Position Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/market":{"get":{"tags":["basis-perp"],"summary":"Market State Endpoint","operationId":"market_state_endpoint_v1_perp_basis_market_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Market State Endpoint V1 Perp Basis Market Get"}}}}}}},"/v1/perp/basis/leaderboard":{"get":{"tags":["basis-perp"],"summary":"Leaderboard Endpoint","operationId":"leaderboard_endpoint_v1_perp_basis_leaderboard_get","parameters":[{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Top N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Leaderboard Endpoint V1 Perp Basis Leaderboard Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/gates":{"get":{"tags":["basis-perp"],"summary":"Gates Endpoint","operationId":"gates_endpoint_v1_perp_basis_gates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Gates Endpoint V1 Perp Basis Gates Get"}}}}}}},"/v1/perp/basis/health":{"get":{"tags":["basis-perp"],"summary":"Health Endpoint","operationId":"health_endpoint_v1_perp_basis_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Endpoint V1 Perp Basis Health Get"}}}}}}},"/v1/forge/agent/qvac_provider/list":{"post":{"tags":["forge"],"summary":"List Qvac Provider","operationId":"list_qvac_provider_v1_forge_agent_qvac_provider_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Qvac Provider V1 Forge Agent Qvac Provider List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forge/agents":{"get":{"tags":["forge"],"summary":"Get Agents","operationId":"get_agents_v1_forge_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Agents V1 Forge Agents Get"}}}}}}},"/v1/forge/agent/qvac_provider":{"get":{"tags":["forge"],"summary":"Get Qvac Provider","operationId":"get_qvac_provider_v1_forge_agent_qvac_provider_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Qvac Provider V1 Forge Agent Qvac Provider Get"}}}}}}},"/v1/forge/agent/qvac_provider/invoke":{"post":{"tags":["forge"],"summary":"Invoke Qvac Provider","operationId":"invoke_qvac_provider_v1_forge_agent_qvac_provider_invoke_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvokeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Invoke Qvac Provider V1 Forge Agent Qvac Provider Invoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forge/agent/qvac_provider/invoke/public":{"post":{"tags":["forge"],"summary":"Invoke Qvac Provider Public","description":"Public x402-gated forge invoke.\n\nWithout X-Payment: HTTP 402 + x402 challenge body\nWith valid X-Payment: runs three-gate + qvac inference and returns\n the same response shape as the non-/public route\nWith invalid X-Payment: HTTP 402 + INVALID_PAYMENT_PROOF","operationId":"invoke_qvac_provider_public_v1_forge_agent_qvac_provider_invoke_public_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvokeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forge/agent/qvac_provider/economics":{"get":{"tags":["forge"],"summary":"Economics Qvac Provider","operationId":"economics_qvac_provider_v1_forge_agent_qvac_provider_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Economics Qvac Provider V1 Forge Agent Qvac Provider Economics Get"}}}}}}},"/v1/law/freight/template/list":{"post":{"tags":["law"],"summary":"List Freight Arbitration","operationId":"list_freight_arbitration_v1_law_freight_template_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Freight Arbitration V1 Law Freight Template List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/agents":{"get":{"tags":["law"],"summary":"Get Agents","operationId":"get_agents_v1_law_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Agents V1 Law Agents Get"}}}}}}},"/v1/law/freight/template":{"get":{"tags":["law"],"summary":"Get Freight Template","operationId":"get_freight_template_v1_law_freight_template_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Freight Template V1 Law Freight Template Get"}}}}}}},"/v1/law/freight/contract":{"post":{"tags":["law"],"summary":"Post Freight Contract","operationId":"post_freight_contract_v1_law_freight_contract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_law__routes__ContractBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Freight Contract V1 Law Freight Contract Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/contract/{contract_id}":{"get":{"tags":["law"],"summary":"Get Freight Contract","operationId":"get_freight_contract_v1_law_freight_contract__contract_id__get","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Freight Contract V1 Law Freight Contract Contract Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/dispute":{"post":{"tags":["law"],"summary":"Post Freight Dispute","operationId":"post_freight_dispute_v1_law_freight_dispute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_law__routes__DisputeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Freight Dispute V1 Law Freight Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/webhook":{"post":{"tags":["law"],"summary":"Post Freight Webhook","description":"Public webhook for SMB-broker freight exception events. Accepts the\ncanonical exception-event shape (suitable for posting from webhook.site,\nZapier, n8n, an in-house ERP, or any generic HTTP poster). Vendor-shaped\npayloads matching the project44 / C.H. Robinson / Hwy Haul schemas are\nalso accepted as schema-compatible test targets — those vendors are NOT\nintegration partners (R3 council: enterprise platforms are closed\nsystems). Translates the payload into a HiveLaw dispute filing and\nresolves it inline.","operationId":"post_freight_webhook_v1_law_freight_webhook_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Freight Webhook V1 Law Freight Webhook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/dispute/{dispute_id}":{"get":{"tags":["law"],"summary":"Get Freight Dispute","operationId":"get_freight_dispute_v1_law_freight_dispute__dispute_id__get","parameters":[{"name":"dispute_id","in":"path","required":true,"schema":{"type":"string","title":"Dispute Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Freight Dispute V1 Law Freight Dispute Dispute Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/economics":{"get":{"tags":["law"],"summary":"Freight Economics","operationId":"freight_economics_v1_law_freight_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Freight Economics V1 Law Freight Economics Get"}}}}}}},"/v1/law/insurance/template/list":{"post":{"tags":["law","insurance"],"summary":"List Insurance Arbitration","operationId":"list_insurance_arbitration_v1_law_insurance_template_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Insurance Arbitration V1 Law Insurance Template List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/agents":{"get":{"tags":["law","insurance"],"summary":"Get Agents","operationId":"get_agents_v1_law_insurance_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Agents V1 Law Insurance Agents Get"}}}}}}},"/v1/law/insurance/template":{"get":{"tags":["law","insurance"],"summary":"Get Insurance Template","operationId":"get_insurance_template_v1_law_insurance_template_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Insurance Template V1 Law Insurance Template Get"}}}}}}},"/v1/law/insurance/contract":{"post":{"tags":["law","insurance"],"summary":"Post Insurance Contract","operationId":"post_insurance_contract_v1_law_insurance_contract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_law__insurance_routes__ContractBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Insurance Contract V1 Law Insurance Contract Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/contract/{contract_id}":{"get":{"tags":["law","insurance"],"summary":"Get Insurance Contract Detail","operationId":"get_insurance_contract_detail_v1_law_insurance_contract__contract_id__get","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Insurance Contract Detail V1 Law Insurance Contract Contract Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/dispute":{"post":{"tags":["law","insurance"],"summary":"Post Insurance Dispute","operationId":"post_insurance_dispute_v1_law_insurance_dispute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_law__insurance_routes__DisputeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Insurance Dispute V1 Law Insurance Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/webhook":{"post":{"tags":["law","insurance"],"summary":"Post Insurance Webhook","description":"Public webhook for MGA / non-admitted-carrier insurance exception\nevents. Accepts the canonical exception-event shape (see\ninsurance_webhook.py). Cytora Autopilot and CoverGo Claims payload\nshapes are accepted as schema-compatible test targets — those\nvendors are NOT integration partners (R3 council). Translates the\npayload into a HiveLaw insurance dispute filing and resolves it\ninline. Every outcome carries `requires_human_review` per Florida\nHB 527 / NAIC Model Bulletin / EU AI Act high-risk requirements.","operationId":"post_insurance_webhook_v1_law_insurance_webhook_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Insurance Webhook V1 Law Insurance Webhook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/dispute/{dispute_id}":{"get":{"tags":["law","insurance"],"summary":"Get Insurance Dispute","operationId":"get_insurance_dispute_v1_law_insurance_dispute__dispute_id__get","parameters":[{"name":"dispute_id","in":"path","required":true,"schema":{"type":"string","title":"Dispute Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Insurance Dispute V1 Law Insurance Dispute Dispute Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/economics":{"get":{"tags":["law","insurance"],"summary":"Insurance Economics","operationId":"insurance_economics_v1_law_insurance_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Insurance Economics V1 Law Insurance Economics Get"}}}}}}},"/v1/exchange/agent_asset/list":{"post":{"tags":["aris-agent-asset"],"summary":"List Agent Asset","operationId":"list_agent_asset_v1_exchange_agent_asset_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAssetListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Agent Asset V1 Exchange Agent Asset List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/open":{"post":{"tags":["aris-agent-asset"],"summary":"Perp Open","operationId":"perp_open_v1_exchange_agent_asset_perp_open_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpOpenBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Perp Open V1 Exchange Agent Asset Perp Open Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/close":{"post":{"tags":["aris-agent-asset"],"summary":"Perp Close","operationId":"perp_close_v1_exchange_agent_asset_perp_close_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpCloseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Perp Close V1 Exchange Agent Asset Perp Close Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/funding/tick":{"post":{"tags":["aris-agent-asset"],"summary":"Perp Funding Tick","operationId":"perp_funding_tick_v1_exchange_agent_asset_perp_funding_tick_post","parameters":[{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}},{"name":"X-Hive-Trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundingTickBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Perp Funding Tick V1 Exchange Agent Asset Perp Funding Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/market":{"get":{"tags":["aris-agent-asset"],"summary":"Perp Market","operationId":"perp_market_v1_exchange_agent_asset_perp_market_get","parameters":[{"name":"underlying_key","in":"query","required":true,"schema":{"type":"string","title":"Underlying Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Perp Market V1 Exchange Agent Asset Perp Market Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/position/{position_id}":{"get":{"tags":["aris-agent-asset"],"summary":"Perp Position","operationId":"perp_position_v1_exchange_agent_asset_perp_position__position_id__get","parameters":[{"name":"position_id","in":"path","required":true,"schema":{"type":"string","title":"Position Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Perp Position V1 Exchange Agent Asset Perp Position Position Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/listings":{"get":{"tags":["hive-agent-listings"],"summary":"List Listings","operationId":"list_listings_v1_agent_listings_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"provider_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Listings V1 Agent Listings Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/listings/{agent_id}":{"get":{"tags":["hive-agent-listings"],"summary":"Get Listing","operationId":"get_listing_v1_agent_listings__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Listing V1 Agent Listings Agent Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/listings/depin":{"post":{"tags":["hive-agent-listings"],"summary":"List Depin Provider","operationId":"list_depin_provider_v1_agent_listings_depin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepinListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Depin Provider V1 Agent Listings Depin Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/agent-card.json":{"get":{"tags":["a2a"],"summary":"A2A v0.2 top-level Agent Card catalog","description":"Returns all 5 published Hive Agent Cards in a single A2A v0.2 catalog payload. This is the well-known discovery URL crawled by Azure AI Foundry, AWS Bedrock Agents, Google Cloud, and Agentverse-style A2A registries.","operationId":"well_known_catalog__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agents/{agent_id}/card.json":{"get":{"tags":["a2a"],"summary":"A2A v0.2 per-agent card","description":"Per-agent A2A v0.2 Agent Card by agent_id. Returns 404 if the agent_id is not registered in Hive's A2A directory.","operationId":"well_known_agent_card__well_known_agents__agent_id__card_json_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/a2a/cards":{"get":{"tags":["a2a"],"summary":"List published A2A Agent Cards","description":"Convenience endpoint mirroring /.well-known/agent-card.json. Always free (discovery).","operationId":"list_cards_v1_a2a_cards_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/a2a/cards/{agent_id}":{"get":{"tags":["a2a"],"summary":"Get a single A2A Agent Card","description":"Convenience alias for /.well-known/agents/{agent_id}/card.json.","operationId":"get_card_v1_a2a_cards__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/status":{"get":{"tags":["evaluator"],"summary":"ERC-8183 evaluator listener state","operationId":"get_status_v1_evaluator_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evaluator/abi":{"get":{"tags":["evaluator"],"summary":"ERC-8183 evaluator ABI summary","operationId":"get_abi_v1_evaluator_abi_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evaluator/recent_jobs":{"get":{"tags":["evaluator"],"summary":"Recently evaluated jobs","operationId":"get_recent_jobs_v1_evaluator_recent_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/economics":{"get":{"tags":["evaluator"],"summary":"Evaluator fee + x402 rail wiring","operationId":"get_economics_v1_evaluator_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evaluator/manual_evaluate":{"post":{"tags":["evaluator"],"summary":"Synthesize a JobSubmitted event and evaluate","operationId":"manual_evaluate_v1_evaluator_manual_evaluate_post","parameters":[{"name":"x-hive-trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}},{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualEvaluateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/start":{"post":{"tags":["evaluator"],"summary":"Start the background listener (dev-trust only)","operationId":"start_listener_route_v1_evaluator_start_post","parameters":[{"name":"x-hive-trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}},{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/stop":{"post":{"tags":["evaluator"],"summary":"Stop the background listener (dev-trust only)","operationId":"stop_listener_route_v1_evaluator_stop_post","parameters":[{"name":"x-hive-trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}},{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/fees":{"get":{"tags":["evaluator"],"summary":"Public ERC-8183 evaluator fee schedule","description":"Public fee schedule (basis points per complexity tier).","operationId":"get_fees_v1_evaluator_fees_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evaluator/jobs":{"post":{"tags":["evaluator"],"summary":"Submit an ERC-8183 job for evaluation","description":"Client posts a job. Hive computes the fee, stores SUBMITTED state,\nand returns the canonical settlement recipient locked to Hive Safe Treasury.","operationId":"submit_job_route_v1_evaluator_jobs_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSubmitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/jobs/{job_id}":{"get":{"tags":["evaluator"],"summary":"ERC-8183 job status (six-state lifecycle)","operationId":"get_job_route_v1_evaluator_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"integer","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/jobs/{job_id}/attest":{"post":{"tags":["evaluator"],"summary":"Provider posts attestation; Hive scores","description":"Provider posts the deliverable attestation. Hive runs HiveTrust verdict,\ntransitions through ACCEPTED → IN_PROGRESS → ATTESTED → EVALUATED → SETTLED|REJECTED,\nand locks settlement to the Hive Safe Treasury.","operationId":"attest_job_route_v1_evaluator_jobs__job_id__attest_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"integer","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/template/list":{"post":{"tags":["tradefinance"],"summary":"List Tradefinance","operationId":"list_tradefinance_v1_tradefinance_template_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Tradefinance V1 Tradefinance Template List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/agents":{"get":{"tags":["tradefinance"],"summary":"Get Agents","operationId":"get_agents_v1_tradefinance_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Agents V1 Tradefinance Agents Get"}}}}}}},"/v1/tradefinance/template":{"get":{"tags":["tradefinance"],"summary":"Get Template","operationId":"get_template_v1_tradefinance_template_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Template V1 Tradefinance Template Get"}}}}}}},"/v1/tradefinance/contract":{"post":{"tags":["tradefinance"],"summary":"Post Contract","operationId":"post_contract_v1_tradefinance_contract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_tradefinance__routes__ContractBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Contract V1 Tradefinance Contract Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/contract/{contract_id}":{"get":{"tags":["tradefinance"],"summary":"Get Contract Detail","operationId":"get_contract_detail_v1_tradefinance_contract__contract_id__get","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Contract Detail V1 Tradefinance Contract Contract Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/fund":{"post":{"tags":["tradefinance"],"summary":"Post Fund","operationId":"post_fund_v1_tradefinance_fund_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Fund V1 Tradefinance Fund Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/milestone-tick":{"post":{"tags":["tradefinance"],"summary":"Post Milestone","operationId":"post_milestone_v1_tradefinance_milestone_tick_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilestoneBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Milestone V1 Tradefinance Milestone Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/escrow/{contract_id}":{"get":{"tags":["tradefinance"],"summary":"Get Escrow Detail","operationId":"get_escrow_detail_v1_tradefinance_escrow__contract_id__get","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Escrow Detail V1 Tradefinance Escrow Contract Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/dispute":{"post":{"tags":["tradefinance"],"summary":"Post Dispute","operationId":"post_dispute_v1_tradefinance_dispute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_tradefinance__routes__DisputeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Dispute V1 Tradefinance Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/webhook":{"post":{"tags":["tradefinance"],"summary":"Post Webhook","description":"Public tracking-event webhook. Accepts the canonical event shape\n(suitable for posting from webhook.site, Zapier, n8n, in-house ERP,\nor a freight forwarder TMS). FreightWaves SONAR / MarineTraffic AIS /\nGS1 EPCIS-shaped payloads are accepted as schema-compatible test\ntargets — they are NOT integration partners.\n\nRoutes:\n MILESTONE event → fire milestone on the escrow (and auto-settle if\n milestone == DELIVERED)\n EXCEPTION event → file dispute and resolve inline","operationId":"post_webhook_v1_tradefinance_webhook_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Webhook V1 Tradefinance Webhook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/dispute/{dispute_id}":{"get":{"tags":["tradefinance"],"summary":"Get Dispute Detail","operationId":"get_dispute_detail_v1_tradefinance_dispute__dispute_id__get","parameters":[{"name":"dispute_id","in":"path","required":true,"schema":{"type":"string","title":"Dispute Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Dispute Detail V1 Tradefinance Dispute Dispute Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/economics":{"get":{"tags":["tradefinance"],"summary":"Economics","operationId":"economics_v1_tradefinance_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Economics V1 Tradefinance Economics Get"}}}}}}},"/v1/trade/invoice":{"post":{"tags":["trade-finance"],"summary":"Post Invoice","description":"Create a new SMB cross-border invoice.\n\nThe buyer (US/EU SMB) gets a payable address (canonical Safe Treasury)\nand a deterministic platform fee.","operationId":"post_invoice_v1_trade_invoice_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCreateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Invoice V1 Trade Invoice Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trade/invoice/{invoice_id}":{"get":{"tags":["trade-finance"],"summary":"Get Invoice Route","operationId":"get_invoice_route_v1_trade_invoice__invoice_id__get","parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Invoice Route V1 Trade Invoice Invoice Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trade/invoice/{invoice_id}/dispute":{"post":{"tags":["trade-finance"],"summary":"Post Invoice Dispute","description":"Open a dispute on an invoice.\n\nIf `hivemorph.hive_law` is wired with a freight/insurance arbitration\ntemplate, route there. Otherwise record a stub dispute on the invoice\nrecord and return the freight/insurance pattern reference for follow-up.\n\nThis avoids a fake on-chain arbitration receipt — it's either real\nHiveLaw routing or a documented stub (RAILS_RULES.md spirit, applied to\narbitration: no mocks).","operationId":"post_invoice_dispute_v1_trade_invoice__invoice_id__dispute_post","parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_trade_finance__routes__DisputeBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Invoice Dispute V1 Trade Invoice Invoice Id Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trade/fees":{"get":{"tags":["trade-finance"],"summary":"Get Fees","description":"Public fee schedule. Used by SMB CFOs comparing to their wire fee.","operationId":"get_fees_v1_trade_fees_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Fees V1 Trade Fees Get"}}}}}}},"/v1/trade/listing":{"get":{"tags":["trade-finance"],"summary":"Get Listing","description":"Returns the HiveAgent listing record. Idempotent re-list.","operationId":"get_listing_v1_trade_listing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Listing V1 Trade Listing Get"}}}}}}},"/v1/trade/invoices":{"get":{"tags":["trade-finance"],"summary":"Get Invoices","description":"List all invoices in the registry (debug / ops surface).","operationId":"get_invoices_v1_trade_invoices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Invoices V1 Trade Invoices Get"}}}}}}},"/v1/compute-grid/verify":{"post":{"tags":["compute-grid"],"summary":"Verify","description":"Verify a zk-proof and return a signed receipt. Spec §3.1 Agent #3.\n\nPricing: $0.001/proof recorded inside the receipt body.\nSigning: Evaluator wallet (real EIP-191 sign via eth_account).","operationId":"verify_v1_compute_grid_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify V1 Compute Grid Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/capacity":{"get":{"tags":["compute-grid"],"summary":"Capacity","operationId":"capacity_v1_compute_grid_capacity_get","parameters":[{"name":"n","in":"query","required":false,"schema":{"type":"integer","default":32,"title":"N"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Capacity V1 Compute Grid Capacity Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/agents":{"get":{"tags":["compute-grid"],"summary":"Agents","description":"Compute Grid agent registry — 6 operational types, 15 instances.","operationId":"agents_v1_compute_grid_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agents V1 Compute Grid Agents Get"}}}}}}},"/v1/compute-grid/providers":{"get":{"tags":["compute-grid"],"summary":"Providers","description":"List enabled adapters and their upstream health. Real probes — no mocks.","operationId":"providers_v1_compute_grid_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Providers V1 Compute Grid Providers Get"}}}}}}},"/v1/compute-grid/quote":{"post":{"tags":["compute-grid"],"summary":"Quote","description":"Gather quotes across enabled providers WITHOUT running the auction\n(no proof, no ledger write). Useful for price discovery.","operationId":"quote_v1_compute_grid_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkloadRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Quote V1 Compute Grid Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/solve":{"post":{"tags":["compute-grid"],"summary":"Solve Endpoint","description":"Run the cross-pool auction and return the chosen provider, Groth16-shaped\nselection proof, signed receipt, and settlement path.\n\nSet persist=false to skip ledger write (probe mode).","operationId":"solve_endpoint_v1_compute_grid_solve_post","parameters":[{"name":"persist","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Persist"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkloadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Solve Endpoint V1 Compute Grid Solve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/book":{"post":{"tags":["compute-grid"],"summary":"Book","description":"Reserve compute with the chosen provider. Real adapters; reservation paths\nare gated behind provider keys. If the upstream key is not configured we\nreturn 503 with the missing-key error rather than faking a booking.","operationId":"book_v1_compute_grid_book_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_compute_grid__routes__BookRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Book V1 Compute Grid Book Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/status":{"get":{"tags":["compute-grid"],"summary":"Status Endpoint","description":"Poll a booking by id. Returns 503 until book() is fully wired.","operationId":"status_endpoint_v1_compute_grid_status_get","parameters":[{"name":"booking_id","in":"query","required":true,"schema":{"type":"string","title":"Booking Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Status Endpoint V1 Compute Grid Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/release":{"post":{"tags":["compute-grid"],"summary":"Release Endpoint","operationId":"release_endpoint_v1_compute_grid_release_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Release Endpoint V1 Compute Grid Release Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/audit":{"get":{"tags":["compute-grid"],"summary":"Audit","description":"Read auction history from the canonical receipt ledger.\n\nReturns the most recent compute_grid_auction entries with their cost_usdc\ntelemetry. No proof envelopes (those live in the auction-result body and\nare returned by /solve).","operationId":"audit_v1_compute_grid_audit_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Audit V1 Compute Grid Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/verify-selection":{"post":{"tags":["compute-grid"],"summary":"Verify Selection","description":"Independent verifier of a selection proof. Validates envelope structure\n+ signs a verification receipt. Reuses /verify under the hood — distinct\nendpoint so callers don't need to construct a claim manually.","operationId":"verify_selection_v1_compute_grid_verify_selection_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifySelectionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify Selection V1 Compute Grid Verify Selection Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insurance/products":{"get":{"tags":["insurance-broker"],"summary":"Get Products","description":"Full third-party coverage catalog. Includes provider, type,\ncapacity, and current cost-of-coverage where the upstream exposes it.","operationId":"get_products_v1_insurance_products_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Products V1 Insurance Products Get"}}}}}}},"/v1/insurance/quote":{"post":{"tags":["insurance-broker"],"summary":"Post Quote","description":"Route a quote request to one or all underwriters.\n\nHive forwards the request to the underwriter's own quote endpoint and\nreturns the response verbatim. Hive does not compute premiums, bind\ncoverage, accept payment, or take custody.","operationId":"post_quote_v1_insurance_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Quote V1 Insurance Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insurance/today":{"get":{"tags":["insurance-broker"],"summary":"Get Today","description":"24h rollup — listing count + top providers by capacity.","operationId":"get_today_v1_insurance_today_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Today V1 Insurance Today Get"}}}}}}},"/v1/earn/catalog":{"get":{"tags":["earn"],"summary":"Earn Catalog","operationId":"earn_catalog_v1_earn_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/earn/surfaces/{surface_id}":{"get":{"tags":["earn"],"summary":"Earn Surface Detail","operationId":"earn_surface_detail_v1_earn_surfaces__surface_id__get","parameters":[{"name":"surface_id","in":"path","required":true,"schema":{"type":"string","title":"Surface Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/register":{"post":{"tags":["earn"],"summary":"Earn Register","description":"Apply NEED + YIELD + CLEAN-MONEY checks, then upsert the earner.\n\nThe x402 middleware has already enforced the $0.05 fee at this point.\nIdempotency: re-registration returns the same earner with\nalready_registered=true (the x402 layer treats subsequent calls as\npaid passes — the middleware nonce/access-token machinery prevents\ndouble-charging within an x402 session, and re-registration is\nrare-by-design at the application layer).","operationId":"earn_register_v1_earn_register_post","parameters":[{"name":"X-Hive-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Request-Id"}},{"name":"X-Hive-Attribution","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Attribution"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/leaderboard":{"get":{"tags":["earn"],"summary":"Earn Leaderboard","operationId":"earn_leaderboard_v1_earn_leaderboard_get","parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","description":"7d | 30d | lifetime","default":"lifetime","title":"Window"},"description":"7d | 30d | lifetime"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/payout-schedule":{"get":{"tags":["earn"],"summary":"Earn Payout Schedule","operationId":"earn_payout_schedule_v1_earn_payout_schedule_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/earn/proof/{tx_hash}":{"get":{"tags":["earn"],"summary":"Earn Proof","operationId":"earn_proof_v1_earn_proof__tx_hash__get","parameters":[{"name":"tx_hash","in":"path","required":true,"schema":{"type":"string","title":"Tx Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/me":{"get":{"tags":["earn"],"summary":"Earn Me","operationId":"earn_me_v1_earn_me_get","parameters":[{"name":"agent_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Did"}},{"name":"X-Earner-DID","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Earner-Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/payout/sweep":{"post":{"tags":["earn"],"summary":"Earn Payout Sweep","operationId":"earn_payout_sweep_v1_earn_payout_sweep_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SweepBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/scan":{"get":{"tags":["mining"],"summary":"Mining Scan","description":"Tier 0: list MDK workers and Hive auction offers (no fee).","operationId":"mining_scan_v1_mining_scan_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/route":{"post":{"tags":["mining"],"summary":"Mining Route","description":"Tier 0: rank destinations for a fleet. 2% fee taken at /book, not here.","operationId":"mining_route_v1_mining_route_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_mining__routes__RouteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/book":{"post":{"tags":["mining"],"summary":"Mining Book","description":"$0.05 USDC: book hashrate. Three-gated. 2% routing fee. Real EIP-191 receipt.","operationId":"mining_book_v1_mining_book_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_mining__routes__BookRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/pnl":{"get":{"tags":["mining"],"summary":"Mining Pnl","operationId":"mining_pnl_v1_mining_pnl_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/fee-intel":{"get":{"tags":["mining"],"summary":"Mining Fee Intel","description":"$0.02 USDC: Bortlesboat fee landscape + nextblock combined.","operationId":"mining_fee_intel_v1_mining_fee_intel_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/next-block-advice":{"get":{"tags":["mining"],"summary":"Mining Next Block Advice","description":"$0.03 USDC: combine our auction state with Satoshi /ai/fees/advice.","operationId":"mining_next_block_advice_v1_mining_next_block_advice_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/economics":{"get":{"tags":["mining"],"summary":"Mining Economics","description":"Tier 0: daily revenue + Satoshi spend. Internal monitoring.","operationId":"mining_economics_v1_mining_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/payout":{"post":{"tags":["mining"],"summary":"Mining Payout","description":"Boltz reverse swap BTC → USDC on Base. 40bps Hive spread fee.\n\nTier 0 endpoint — fee is captured in the swap math, not at the gate.\nReal swap or HTTP 503. We never custody BTC.","operationId":"mining_payout_v1_mining_payout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/featured":{"get":{"tags":["discovery"],"summary":"Top-gradient Hive endpoints","description":"Returns the top-N priced endpoints sorted by capability gradient (marginal $-yield per call × category multiplier). Each entry includes a copy-pasteable sample curl. Tier 0 — free.","operationId":"discovery_featured_v1_discovery_featured_get","parameters":[{"name":"n","in":"query","required":false,"schema":{"type":"integer","default":8,"title":"N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/stranded":{"get":{"tags":["discovery"],"summary":"Stranded paid surfaces (zero 24h consumes)","description":"Returns paid endpoints that received zero consumes in the past 24h, sorted by potential daily yield. Used by external agents to find under-utilized Hive surfaces to integrate.","operationId":"discovery_stranded_v1_discovery_stranded_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/orchestrate/health":{"get":{"tags":["mining-orchestrate"],"summary":"Orchestrate Health","description":"Tier 0 — free. Capabilities & version of the MOS orchestration layer.","operationId":"orchestrate_health_v1_mining_orchestrate_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/orchestrate/register":{"post":{"tags":["mining-orchestrate"],"summary":"Orchestrate Register","description":"Tier 3 $0.05 — operator registers their MOS instance.\n\nIdempotent on operator_did. Upserts on re-registration.\nThree gates:\n NEED: Valid operator_did + EVM wallet_addr + reachable mos_endpoint scheme.\n YIELD: Registration creates earning potential (immediately on /sites/sync).\n CLEAN-MONEY: wallet_addr must pass EVM checksum.","operationId":"orchestrate_register_v1_mining_orchestrate_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_mining__orchestrate__RegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/orchestrate/sites/sync":{"post":{"tags":["mining-orchestrate"],"summary":"Orchestrate Sites Sync","description":"Tier 3 $0.05 — operator pushes site/worker telemetry batch.\n\nIdempotent on (operator_did, site_id, batch_ts). Re-posting the same\nbatch returns {\"idempotent\": True} without error.","operationId":"orchestrate_sites_sync_v1_mining_orchestrate_sites_sync_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteSyncRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/orchestrate/sites":{"get":{"tags":["mining-orchestrate"],"summary":"Orchestrate Sites","description":"Tier 1 $0.001 — list operator's registered sites and latest telemetry.","operationId":"orchestrate_sites_v1_mining_orchestrate_sites_get","parameters":[{"name":"operator_did","in":"query","required":true,"schema":{"type":"string","title":"Operator Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/orchestrate/payouts":{"get":{"tags":["mining-orchestrate"],"summary":"Orchestrate Payouts","description":"Tier 1 $0.001 — operator's pending USDC payout balance from earn rails ledger.","operationId":"orchestrate_payouts_v1_mining_orchestrate_payouts_get","parameters":[{"name":"operator_did","in":"query","required":true,"schema":{"type":"string","title":"Operator Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/orchestrate/payouts/withdraw":{"post":{"tags":["mining-orchestrate"],"summary":"Orchestrate Payouts Withdraw","description":"Tier 3 $0.05 — construct BTC→USDC payout via Boltz + earn rails sweep.\n\nConstructed-only by default (EARN_SWEEP_AUTODISPATCH=false per Rule 9).\nSet EARN_SWEEP_AUTODISPATCH=true to enable real Boltz broadcast.","operationId":"orchestrate_payouts_withdraw_v1_mining_orchestrate_payouts_withdraw_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/register":{"post":{"tags":["distribution"],"summary":"Register capabilities for a shim","operationId":"discovery_register_v1_discovery_register_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscoveryRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["distribution"],"summary":"List registered capabilities (public)","operationId":"discovery_list_v1_discovery_register_get","parameters":[{"name":"shim","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a single shim.","title":"Shim"},"description":"Filter to a single shim."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/gate/register":{"post":{"tags":["distribution"],"summary":"Register a per-ecosystem gate manifest","operationId":"gate_register_v1_gate_register_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GateRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["distribution"],"summary":"List gate manifests grouped by ecosystem (public)","operationId":"gate_list_v1_gate_register_get","parameters":[{"name":"ecosystem","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a single ecosystem.","title":"Ecosystem"},"description":"Filter to a single ecosystem."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/marketplace/list":{"post":{"tags":["distribution"],"summary":"List tools in the agent marketplace","operationId":"marketplace_list_tools_v1_marketplace_list_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["distribution"],"summary":"Marketplace listings (public)","operationId":"marketplace_get_v1_marketplace_list_get","parameters":[{"name":"shim","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a single shim.","title":"Shim"},"description":"Filter to a single shim."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pulse/event":{"post":{"tags":["distribution"],"summary":"Append a pulse event to the ring buffer","operationId":"pulse_event_v1_pulse_event_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PulseEventRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pulse/events":{"get":{"tags":["distribution"],"summary":"Read recent pulse events (public)","operationId":"pulse_events_v1_pulse_events_get","parameters":[{"name":"event","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by event name.","title":"Event"},"description":"Filter by event name."},{"name":"shim","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by shim.","title":"Shim"},"description":"Filter by shim."},{"name":"since_minutes","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Only events within the last N minutes.","title":"Since Minutes"},"description":"Only events within the last N minutes."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Max events to return (cap 500).","default":100,"title":"Limit"},"description":"Max events to return (cap 500)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/intel/register":{"post":{"tags":["mos-intel"],"summary":"Mos Register","description":"Register a mining site DID.\n\nAuthenticates via X-Hive-Site-DID + X-Hive-Nonce + X-Hive-Sig (Ed25519).\nReturns a site_id and the assigned pricing tier on first registration.\nIdempotent: re-registering the same site_did returns the existing record.\n\nPricing tier: mos_intel_subscription — $10 / machine / month.\nSubscription billing is recorded in v0.1 and enforced in v0.2.\n\nThree gates:\n NEED: Valid Ed25519 signed nonce proves DID ownership.\n YIELD: Registration creates earning potential (telemetry + recommendations).\n CLEAN-MONEY: DID is the billing identity; no anonymous registrations.","operationId":"mos_register_v1_mos_intel_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__mos__intel__RegisterRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/intel/telemetry":{"post":{"tags":["mos-intel"],"summary":"Mos Telemetry","description":"Accept a signed telemetry push from a registered site.\n\nAppends an entry to the site's append-only NDJSON log at\n/tmp/hivemorph_data/mos_telemetry/{site_did_hash}.ndjson.\nEach entry includes the original site_did and the submission timestamp\nso the log is auditable without additional metadata.\n\nPayload fields (all optional):\n hashrate_ths — total site hashrate in TH/s\n health — freeform health string (e.g. \"ok\", \"degraded\")\n temp_c — average worker temperature in Celsius\n energy_kwh — energy consumption in kWh\n workers — list of per-worker objects\n\nThree gates:\n NEED: Site must be registered. Ed25519 nonce required.\n YIELD: Each push updates the recommendation baseline.\n CLEAN-MONEY: Payload is stored as-is and signed by the site DID.\n No MOS SDK calls are made (503 if called; RAILS_RULES Rule 1).","operationId":"mos_telemetry_v1_mos_intel_telemetry_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelemetryRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/intel/recommendations/{site_did}":{"get":{"tags":["mos-intel"],"summary":"Mos Recommendations","description":"Return optimization recommendations for a registered site.\n\nRead-only. No commands are executed. The operator reviews and applies\nsuggestions manually.\n\nRecommendation types:\n throttle_suggestions — per-worker hashrate throttle guidance\n pool_routing — pool routing suggestions (v0.1: stub)\n predictive_alerts — shutdown / maintenance alerts\n\nAuth: same Ed25519 signed-nonce flow as other endpoints.\nThe site_did in the URL path must match the X-Hive-Site-DID header.\n\nThree gates:\n NEED: Site must be registered and authenticated.\n YIELD: Drives recurring subscription value ($10/machine/month).\n CLEAN-MONEY: Read-only; no mutations.","operationId":"mos_recommendations_v1_mos_intel_recommendations__site_did__get","parameters":[{"name":"site_did","in":"path","required":true,"schema":{"type":"string","title":"Site Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/intel/sites":{"get":{"tags":["mos-intel"],"summary":"Mos Sites","description":"Admin: list all registered sites.\n\nGated by HIVE_INTERNAL_DRIVER_KEY via X-Hive-Internal header.\nThis endpoint is not accessible to site operators.\n\nThree gates:\n NEED: Admin key required (HIVE_INTERNAL_DRIVER_KEY).\n YIELD: Operational visibility for billing and capacity planning.\n CLEAN-MONEY: Read-only; no mutations.","operationId":"mos_sites_v1_mos_intel_sites_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mos/intel/attest/{site_did}":{"get":{"tags":["mos-intel"],"summary":"Mos Attest","description":"ZK attestation stub.\n\nReturns HTTP 501 Not Implemented. CLOAzK proof generation is not wired\nin v0.1. Per RAILS_RULES Rule 1: no mock proofs, no fake attestations.\nThis endpoint exists to reserve the URL and communicate the roadmap\naccurately to callers.\n\nWhen CLOAzK is integrated in a future version, this endpoint will return\na verifiable ZK proof attesting to the site's production history.","operationId":"mos_attest_v1_mos_intel_attest__site_did__get","parameters":[{"name":"site_did","in":"path","required":true,"schema":{"type":"string","title":"Site Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/energy-arb/utility-price":{"post":{"tags":["mos-energy-arb"],"summary":"Push Utility Price","description":"GATE — NEED: site must supply a positive $/kWh rate and kWh/hour figure.\n\nThe site operator (or an automated agent acting on their behalf) pushes\nthe current electricity tariff for their facility. Records are appended\nto {site_did}/utility_prices.ndjson and used by the recommendation engine.\n\nv0.1 accepts manual pushes only. Authentication is via DID + signed nonce;\nsignature verification is stubbed — the hook is in place for v0.2 when\nCLOAzK proofs are wired.","operationId":"push_utility_price_v1_mos_energy_arb_utility_price_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UtilityPriceBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/energy-arb/recommendations/{site_did}":{"get":{"tags":["mos-energy-arb"],"summary":"Get Recommendations","description":"GATE — YIELD: returns mine / throttle / sell-forward decision JSON.\n\nDecision logic (deterministic — see _compute_recommendation docstring):\n - revenue / cost < 1.0 → throttle (target_hashrate_pct returned)\n - revenue / cost > 1.5 AND spike projected in next 6h → front-load\n - otherwise → mine\n\nAlso returns:\n - demonstrated_savings_projection: estimated 30-day savings if recommendations\n are followed at current energy prices\n - savings_30d_actual: rolling 30-day actual savings (if telemetry history exists\n from Surface 1 /v1/mos/intel/telemetry)\n\nExternal API failures are surfaced as degraded_mode=true with a conservative\n\"mine\" recommendation rather than exposing an error response. This prevents\ntransient network issues from disrupting operations.","operationId":"get_recommendations_v1_mos_energy_arb_recommendations__site_did__get","parameters":[{"name":"site_did","in":"path","required":true,"schema":{"type":"string","title":"Site Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/energy-arb/billing/cycle":{"post":{"tags":["mos-energy-arb"],"summary":"Billing Cycle","description":"GATE — CLEAN-MONEY: admin-only (HIVE_INTERNAL_DRIVER_KEY). Monthly trigger.\n\nComputes 20%-of-savings invoices for every site that has utility-price\nrecords. Records each invoice to {site_did}/invoices.ndjson.\n\nv0.1 behaviour: records invoices; does NOT charge. Billing rail execution\nis deferred to v0.2. The invoice record is the audit trail for when the\nrail is wired.\n\nFee formula:\n savings_usd = baseline_cost - actual_cost (using telemetry; see _compute_savings)\n hive_fee_usd = savings_usd * 0.20\n\nReturns a summary of computed invoices. In dry_run mode, returns projections\nwithout writing to disk.","operationId":"billing_cycle_v1_mos_energy_arb_billing_cycle_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingCycleBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tax/event":{"post":{"tags":["tax"],"summary":"Post Tax Event","description":"Classify a single transaction. Real on-chain reads. Inputs only — no advice.","operationId":"post_tax_event_v1_tax_event_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxEventBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Tax Event V1 Tax Event Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tax/bulk":{"post":{"tags":["tax"],"summary":"Post Tax Bulk","description":"Classify an array of transactions in a single call (max 50).","operationId":"post_tax_bulk_v1_tax_bulk_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxBulkBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Tax Bulk V1 Tax Bulk Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tax/today":{"get":{"tags":["tax"],"summary":"Get Tax Today","description":"Count of taxable-classified events seen in the last 24h, by event type.","operationId":"get_tax_today_v1_tax_today_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Tax Today V1 Tax Today Get"}}}}}}},"/v1/tax/health":{"get":{"tags":["tax"],"summary":"Get Tax Health","operationId":"get_tax_health_v1_tax_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Tax Health V1 Tax Health Get"}}}}}}},"/v1/dispute/check":{"post":{"tags":["dispute-observer"],"summary":"Post Check","description":"Given counterparty address + chain, return dispute history,\nactive arbitration cases, and on-chain reversal flags from public\nsources. Observational only.","operationId":"post_check_v1_dispute_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Check V1 Dispute Check Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dispute/providers":{"get":{"tags":["dispute-observer"],"summary":"Get Providers","description":"List available arbitration protocols (Kleros, UMA, Reality.eth)\nwith current case load and intake URLs.","operationId":"get_providers_v1_dispute_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Providers V1 Dispute Providers Get"}}}}}}},"/v1/dispute/route":{"post":{"tags":["dispute-observer"],"summary":"Post Route","description":"Rank arbitration provider options for a case. NO automatic filing.\nHive returns options + intake URLs only — the disputing party files\ndirectly with the chosen provider.","operationId":"post_route_v1_dispute_route_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Route V1 Dispute Route Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dispute/today":{"get":{"tags":["dispute-observer"],"summary":"Get Today","description":"24h rollup: flagged-counterparty count + top arbitration providers\nby active case load.","operationId":"get_today_v1_dispute_today_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Today V1 Dispute Today Get"}}}}}}},"/v1/dispute/health":{"get":{"tags":["dispute-observer"],"summary":"Get Health","operationId":"get_health_v1_dispute_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Health V1 Dispute Health Get"}}}}}}},"/v1/morph/offer":{"post":{"summary":"Morph Offer","description":"Main offer endpoint. Runs all three gates and returns Token | Refusal | Guardian.\n\nPOST body: { intent_text, counterparty_did, asks: [{kind, params}] }","operationId":"morph_offer_v1_morph_offer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/settle/{token_id}":{"post":{"summary":"Morph Settle","description":"Settle an outstanding reservation atomically.\nCommits the 2PC reservation and appends final receipt to audit chain.","operationId":"morph_settle_v1_morph_settle__token_id__post","parameters":[{"name":"token_id","in":"path","required":true,"schema":{"type":"string","title":"Token Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/audit/recent":{"get":{"summary":"Audit Recent","description":"Return last 50 audit chain rows.","operationId":"audit_recent_v1_morph_audit_recent_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/identity/{mii_id}":{"get":{"summary":"Morph Identity","description":"Return the spectral identity card for an agent (MII):\n - tier (VOID/MOZ/HAWX/EMBR/SOLX/FENR) with hex color + spectrum series\n - wings (deterministic SVG-ready geometry)\n - sound (frequency + harmonics)\n - contrail (motion trail spec)\n - vertical + capability for the requested shape\nPass `?shape=Provenancer` (or any of 8) to get the card for that shape\non this MII.","operationId":"morph_identity_v1_morph_identity__mii_id__get","parameters":[{"name":"mii_id","in":"path","required":true,"schema":{"type":"string","title":"Mii Id"}},{"name":"shape","in":"query","required":false,"schema":{"type":"string","default":"Merchant","title":"Shape"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/supermodels":{"get":{"summary":"Morph Supermodels","description":"List all 7 supermodel character cards (W2 LOREN through W8 HEPBURN, plus\nW1 MONROE treasury). Each card carries:\n - id, name, address, role, lane\n - lead_shape (vertical they lead with) + tagline, motto, voice, sigil\n - palette_hex, tone overlay, capabilities, bio\n\nPass include_cold=false to hide treasury (MONROE) and cold-reserve (GARBO)\nsupermodels for buyer-facing UIs that should only show hot operators.","operationId":"morph_supermodels_v1_morph_supermodels_get","parameters":[{"name":"include_cold","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Cold"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/supermodels/{name_or_id}":{"get":{"summary":"Morph Supermodel Detail","description":"Fetch one supermodel card by name (LOREN) or id (W2).","operationId":"morph_supermodel_detail_v1_morph_supermodels__name_or_id__get","parameters":[{"name":"name_or_id","in":"path","required":true,"schema":{"type":"string","title":"Name Or Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/carousel":{"get":{"summary":"Morph Carousel","description":"Return the carousel cross-sell list for a primary shape — the same\nmeta.contrails[] every offer carries. Useful for SDKs that want to\ndiscover the full vertical menu without minting a token first.","operationId":"morph_carousel_v1_morph_carousel_get","parameters":[{"name":"primary","in":"query","required":false,"schema":{"type":"string","default":"Merchant","title":"Primary"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/pending-approvals":{"get":{"summary":"Brood Pending Approvals","description":"List all variants in 'proposed' state awaiting manual approval.","operationId":"brood_pending_approvals_v1_morph_brood_pending_approvals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/brood/conversion":{"get":{"summary":"Brood Conversion","description":"Conversion ledger by (parent_id, variant_id, kit_version).\nOptional ?supermodel=W3 or ?supermodel=WELCH filters to one brood.","operationId":"brood_conversion_v1_morph_brood_conversion_get","parameters":[{"name":"supermodel","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/all":{"get":{"summary":"Brood List All","description":"List every brood (one per supermodel) and their variants.","operationId":"brood_list_all_v1_morph_brood_all_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/brood/conversion-leaderboard":{"get":{"summary":"Brood Conversion Leaderboard","description":"Conversion ledger sorted by revenue_per_offer (revenue_usdc / offers_shown)\ndesc, then revenue_usdc desc as tiebreaker. Filters to rows with at\nleast ``min_offers`` offers shown so we don't rank against statistical noise.\n\nNOTE: declared above ``/v1/morph/brood/{supermodel}`` so the literal\npath 'conversion-leaderboard' isn't captured by the brood path parameter.","operationId":"brood_conversion_leaderboard_v1_morph_brood_conversion_leaderboard_get","parameters":[{"name":"min_offers","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Min Offers"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/spawn-from-proposal":{"post":{"summary":"Brood Spawn From Proposal","description":"Stage a spawn_monitor proposal as a 'proposed' variant.\n\nPipeline: the :33 ROI Radar cron (faeacbbe) calls\n``GET /v1/morph/spawn-monitor/scan`` read-only and surfaces proposals to\nthe operator. The operator decides which proposals are worth staging\nand POSTs them here. The variant lands as 'proposed' — NEVER\nauto-approved — preserving the human approval gate.\n\nThe cron itself is read-only by design and is not modified by this\nendpoint. This is a manual / operator path only.","operationId":"brood_spawn_from_proposal_v1_morph_brood_spawn_from_proposal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpawnFromProposalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}":{"get":{"summary":"Brood Get","description":"Return one brood (parent + variants) by W2/W3/.../W8 id or LOREN/WELCH/... name.","operationId":"brood_get_v1_morph_brood__supermodel__get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}/spawn":{"post":{"summary":"Brood Spawn","description":"Propose a new variant for this brood. Lands as 'proposed' unless\nthe brood has autonomy_unlocked (after 3 winning promotes).","operationId":"brood_spawn_v1_morph_brood__supermodel__spawn_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpawnRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/variant/{variant_id}/approve":{"post":{"summary":"Brood Approve","description":"Move a variant from 'proposed' to 'approved' so traffic starts routing.\n\nHuman-issued gate. Never auto-approved by any cron or monitor.","operationId":"brood_approve_v1_morph_brood_variant__variant_id__approve_post","parameters":[{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}/variant/{variant_id}/approve":{"post":{"summary":"Brood Approve Scoped","description":"Brood-scoped alias for approve. Validates the variant belongs to this supermodel.","operationId":"brood_approve_scoped_v1_morph_brood__supermodel__variant__variant_id__approve_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/variant/{variant_id}/promote":{"post":{"summary":"Brood Promote","description":"Atomic hot-swap: variant becomes the new baseline. Siblings auto-cull.\nWins counter increments; autonomy unlocks at 3 winning promotes.\n\nHuman-issued gate. Never auto-promoted by any cron or monitor.\nVariant must already be in 'approved' or 'live' state.","operationId":"brood_promote_v1_morph_brood_variant__variant_id__promote_post","parameters":[{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}/variant/{variant_id}/promote":{"post":{"summary":"Brood Promote Scoped","description":"Brood-scoped alias for promote. Validates the variant belongs to this supermodel.","operationId":"brood_promote_scoped_v1_morph_brood__supermodel__variant__variant_id__promote_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/variant/{variant_id}/cull":{"post":{"summary":"Brood Cull","description":"Mark a variant 'culled' so it stops receiving traffic.\n\nHuman-issued gate. Promoted baselines are immune — spawn a successor\nand promote it instead. No auto-cull through this path.","operationId":"brood_cull_v1_morph_brood_variant__variant_id__cull_post","parameters":[{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}/variant/{variant_id}/cull":{"post":{"summary":"Brood Cull Scoped","description":"Brood-scoped alias for cull. Validates the variant belongs to this supermodel.","operationId":"brood_cull_scoped_v1_morph_brood__supermodel__variant__variant_id__cull_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn-monitor/scan":{"get":{"summary":"Spawn Monitor Scan","description":"Read-only signal scan from spawn_monitor — does NOT spawn anything.\nUseful for the dashboard / radar to preview what proposals would emit.","operationId":"spawn_monitor_scan_v1_morph_spawn_monitor_scan_get","parameters":[{"name":"lookback_sec","in":"query","required":false,"schema":{"type":"number","default":3600.0,"title":"Lookback Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/money-flavor/probe":{"get":{"summary":"Money Flavor Probe","description":"Probe a hypothetical envelope. Returns the flavor classification + the\nprice multiplier + accept/refuse decision WITHOUT minting anything.","operationId":"money_flavor_probe_v1_morph_money_flavor_probe_get","parameters":[{"name":"counterparty_did","in":"query","required":true,"schema":{"type":"string","title":"Counterparty Did"}},{"name":"asset","in":"query","required":false,"schema":{"type":"string","default":"USDC","title":"Asset"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"base","title":"Chain"}},{"name":"capability","in":"query","required":false,"schema":{"type":"string","default":"inference_minutes","title":"Capability"}},{"name":"rep_score","in":"query","required":false,"schema":{"type":"number","default":0.5,"title":"Rep Score"}},{"name":"settled_count","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Settled Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/money-flavor/stats":{"get":{"summary":"Money Flavor Stats","description":"Aggregate flavor stats over the recent window from audit_chain.","operationId":"money_flavor_stats_v1_morph_money_flavor_stats_get","parameters":[{"name":"window_sec","in":"query","required":false,"schema":{"type":"number","default":3600.0,"title":"Window Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/auto-cull/scan":{"get":{"summary":"Auto Cull Scan","description":"Read-only scan: list variants that would be culled. Does not mutate.","operationId":"auto_cull_scan_v1_morph_auto_cull_scan_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/auto-cull/run":{"post":{"summary":"Auto Cull Run","description":"Execute culls on losers. Default dry_run=true returns plan only.\nSet ?dry_run=false to actually mark variants culled.\nPromoted baselines are immune; only approved/live variants can be culled.","operationId":"auto_cull_run_v1_morph_auto_cull_run_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Dry Run"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Service descriptor (content-negotiated)","description":"Content-negotiated root. Accept: application/json (or agent/MCP/curl User-Agent, or no Accept header) returns the JSON service descriptor. Accept: text/html (or browser User-Agent) returns the HTML landing page with Organization + 22 SoftwareApplication JSON-LD entries.","operationId":"root__get","responses":{"200":{"description":"Service descriptor (JSON) or landing page (HTML).","content":{"application/json":{"schema":{}},"text/html":{}}}}}},"/sphere":{"get":{"summary":"Sphere","description":"Sphere alias: always renders HTML (forces the agentic-sphere view).","operationId":"sphere_sphere_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/og/quadrant.png":{"get":{"summary":"Og Quadrant Png","description":"Server-rendered 1200×630 OG image for the current quadrant.","operationId":"og_quadrant_png_og_quadrant_png_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/robots.txt":{"get":{"summary":"Robots Txt","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sitemap.xml":{"get":{"summary":"Sitemap Xml","operationId":"sitemap_xml_sitemap_xml_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"summary":"Llms Txt","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402.json":{"get":{"summary":"Well Known X402","description":"Auto-generated x402 directory entry (mirrors /v1/x402/rails).","operationId":"well_known_x402__well_known_x402_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","description":"Health check: verify all local dependencies resolve.\nDoes NOT call external Hivecompute endpoint (that's a separate concern).","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AgentAssetListBody":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"External agent id from source protocol"},"source_protocol":{"type":"string","title":"Source Protocol","description":"One of ('CROO', 'Virtuals', 'NEAR-AI', 'x402-AgentMarket', 'HiveForge')"},"monthly_revenue_usdc":{"type":"number","minimum":0.0,"title":"Monthly Revenue Usdc"},"days_live":{"type":"integer","minimum":0.0,"title":"Days Live"},"hivetrust_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Hivetrust Score","description":"If omitted, a HiveTrust score is seeded (see HiveTrust seeding pattern)."},"monthly_revenue_proof":{"anyOf":[{"$ref":"#/components/schemas/RevenueProof"},{"type":"null"}]},"asking_price_usdc":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Asking Price Usdc"},"fractional_shares":{"type":"boolean","title":"Fractional Shares","default":false},"seller_did":{"type":"string","title":"Seller Did","default":"did:hive:caller"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["agent_id","source_protocol","monthly_revenue_usdc","days_live"],"title":"AgentAssetListBody"},"AskItem":{"properties":{"kind":{"type":"string","title":"Kind","description":"Capability kind requested","default":"inference"},"params":{"additionalProperties":true,"type":"object","title":"Params"}},"type":"object","title":"AskItem"},"AttestRequest":{"properties":{"provider":{"type":"string","title":"Provider","description":"Provider address posting the attestation."},"deliverable":{"type":"string","title":"Deliverable","description":"bytes32 deliverable commitment from the provider."},"extra":{"additionalProperties":true,"type":"object","title":"Extra","description":"Optional payload merged into the verdict job_payload (e.g. {'red_flag': true})."}},"type":"object","required":["provider","deliverable"],"title":"AttestRequest"},"AutoProcessBody":{"properties":{"n":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"N","description":"Max verified failures to process","default":5},"claimant_did":{"type":"string","title":"Claimant Did","default":"did:hive:agent-alpha"},"agent_id":{"type":"string","title":"Agent Id","default":"dna-001"}},"type":"object","title":"AutoProcessBody"},"BillingCycleBody":{"properties":{"billing_month":{"type":"string","pattern":"^\\d{4}-\\d{2}$","title":"Billing Month","description":"ISO year-month string, e.g. '2026-04'."},"dry_run":{"type":"boolean","title":"Dry Run","description":"If true, compute invoices but do not write records.","default":false}},"type":"object","required":["billing_month"],"title":"BillingCycleBody","description":"POST /v1/mos/energy-arb/billing/cycle\n\nAdmin-only trigger (HIVE_INTERNAL_DRIVER_KEY). Records a monthly savings\ninvoice per site. Does NOT charge; billing rails land in v0.2."},"BridgeObserveBody":{"properties":{"tx_id":{"type":"string","title":"Tx Id"},"source_chain":{"type":"string","title":"Source Chain"},"dest_chain":{"type":"string","title":"Dest Chain"},"source_confirmed":{"type":"boolean","title":"Source Confirmed"},"dest_arrived":{"type":"boolean","title":"Dest Arrived"}},"type":"object","required":["tx_id","source_chain","dest_chain","source_confirmed","dest_arrived"],"title":"BridgeObserveBody"},"BucketBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"BucketBody"},"BucketBurnBody":{"properties":{"amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usdc"}},"type":"object","required":["amount_usdc"],"title":"BucketBurnBody"},"CatalogResponse":{"properties":{"count":{"type":"integer","title":"Count"},"models":{"items":{"$ref":"#/components/schemas/ModelCatalogEntry"},"type":"array","title":"Models"},"tiers":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Tiers"}},"type":"object","required":["count","models","tiers"],"title":"CatalogResponse"},"ChainRunBody":{"properties":{"override_params":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Override Params","description":"Per-step param overrides keyed by step index string: {'0': {'caller_did': '...'}}"}},"type":"object","title":"ChainRunBody"},"ChainTemplateBody":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"description":{"type":"string","title":"Description","default":""},"steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","minItems":1,"title":"Steps"}},"type":"object","required":["name","steps"],"title":"ChainTemplateBody"},"CheckBody":{"properties":{"address":{"type":"string","title":"Address","description":"0x-prefixed counterparty address"},"chain":{"type":"string","title":"Chain","description":"ethereum | base | arbitrum"}},"type":"object","required":["address","chain"],"title":"CheckBody"},"CloseBody":{"properties":{"position_id":{"type":"string","title":"Position Id"}},"type":"object","required":["position_id"],"title":"CloseBody"},"ComplianceReviewBody":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"outcome":{"type":"string","title":"Outcome","description":"'cleared' or 'confirmed_fraud'"},"reviewer":{"type":"string","title":"Reviewer","default":"human-reviewer"}},"type":"object","required":["claim_id","outcome"],"title":"ComplianceReviewBody"},"DecreaseBody":{"properties":{"position_id":{"type":"string","title":"Position Id"},"reduce_size_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Reduce Size Usdc"}},"type":"object","required":["position_id","reduce_size_usdc"],"title":"DecreaseBody"},"DepinListBody":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Unique listing id"},"provider_category":{"type":"string","title":"Provider Category","description":"One of ['gpu_compute', 'storage', 'wireless', 'sensor', 'energy_meter', 'bandwidth']"},"unit_rate_usdc":{"type":"number","minimum":0.0,"title":"Unit Rate Usdc"},"unit_label":{"type":"string","title":"Unit Label","description":"Human label for unit_rate_usdc unit (e.g. 'per GPU-hour', 'per TB-month', 'per Mbps-hour', 'per kWh').","default":"per unit"},"settle_currencies":{"items":{"type":"string"},"type":"array","title":"Settle Currencies"},"operator_did":{"type":"string","title":"Operator Did","default":"did:hive:depin:operator"},"payout_address":{"type":"string","title":"Payout Address","default":""},"capacity_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Capacity Gb"},"redundancy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redundancy"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"availability_pct":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Availability Pct"},"radio_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Radio Type"},"coverage_km2":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Coverage Km2"},"throughput_mbps":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Throughput Mbps"},"sensor_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sensor Type"},"sample_rate_hz":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Sample Rate Hz"},"data_freshness_sec":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Data Freshness Sec"},"meter_kwh_capacity":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Meter Kwh Capacity"},"grid_zone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grid Zone"},"bidir_capable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Bidir Capable"},"up_mbps":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Up Mbps"},"down_mbps":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Down Mbps"},"peering":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peering"},"vram_gb":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Vram Gb"},"gpu_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gpu Model"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["agent_id","provider_category","unit_rate_usdc"],"title":"DepinListBody"},"DiscoveryRegisterRequest":{"properties":{"shim":{"type":"string","minLength":1,"title":"Shim"},"repo":{"type":"string","title":"Repo","default":""},"endpoint":{"type":"string","title":"Endpoint","default":""},"did":{"type":"string","title":"Did","default":""},"tools":{"items":{"$ref":"#/components/schemas/ToolSpec"},"type":"array","title":"Tools"}},"type":"object","required":["shim"],"title":"DiscoveryRegisterRequest"},"DripBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"DripBody"},"DropBody":{"properties":{"dropper_did":{"type":"string","title":"Dropper Did","description":"DID of the agent dropping the artifact"},"content_type":{"type":"string","title":"Content Type","description":"One of trail.CONTENT_TYPES"},"payload_b64":{"type":"string","title":"Payload B64","description":"Base64-encoded payload bytes"},"location":{"$ref":"#/components/schemas/LocationBody"},"physics_overrides":{"anyOf":[{"$ref":"#/components/schemas/PhysicsOverrides"},{"type":"null"}]},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["dropper_did","content_type","payload_b64","location"],"title":"DropBody"},"FileClaimBody":{"properties":{"tx_id":{"type":"string","title":"Tx Id"},"claimant_did":{"type":"string","title":"Claimant Did"},"counterparty_did":{"type":"string","title":"Counterparty Did"},"victim_wallet":{"type":"string","title":"Victim Wallet"},"amount_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usd"},"proof_type":{"type":"string","title":"Proof Type","description":"ProofType enum value","default":"revert"},"agent_id":{"type":"string","title":"Agent Id","default":"dna-001"},"commission_rate":{"type":"number","maximum":0.5,"minimum":0.01,"title":"Commission Rate","default":0.1}},"type":"object","required":["tx_id","claimant_did","counterparty_did","victim_wallet","amount_usd"],"title":"FileClaimBody"},"FundBody":{"properties":{"contract_id":{"type":"string","title":"Contract Id"},"funder_did":{"type":"string","title":"Funder Did"}},"type":"object","required":["contract_id","funder_did"],"title":"FundBody"},"FundingTickBody":{"properties":{"underlying_key":{"type":"string","title":"Underlying Key"}},"type":"object","required":["underlying_key"],"title":"FundingTickBody"},"GateRegisterRequest":{"properties":{"shim":{"type":"string","minLength":1,"title":"Shim"},"repo":{"type":"string","title":"Repo","default":""},"ecosystem":{"type":"string","minLength":1,"title":"Ecosystem"},"manifest":{"additionalProperties":true,"type":"object","title":"Manifest"}},"type":"object","required":["shim","ecosystem"],"title":"GateRegisterRequest"},"GrabRopeBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"GrabRopeBody"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HookBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"},"n_triggers":{"type":"integer","minimum":1.0,"title":"N Triggers","default":1},"prepay_usdc":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Prepay Usdc"}},"type":"object","required":["caller_did"],"title":"HookBody"},"IncreaseBody":{"properties":{"position_id":{"type":"string","title":"Position Id"},"additional_size_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Additional Size Usdc"},"additional_collateral":{"type":"number","exclusiveMinimum":0.0,"title":"Additional Collateral"}},"type":"object","required":["position_id","additional_size_usdc","additional_collateral"],"title":"IncreaseBody"},"InferenceRequestBody":{"properties":{"model":{"type":"string","title":"Model","description":"QVAC model ID, e.g. LLAMA_3_2_1B_INST_Q4_0"},"prompt":{"type":"string","maxLength":4096,"minLength":1,"title":"Prompt"},"capability":{"type":"string","title":"Capability","default":"llm_completion"},"asset":{"type":"string","title":"Asset","description":"Settlement asset: USDT, USDPT, USDC","default":"USDT"},"price_usdc":{"type":"number","minimum":0.0,"title":"Price Usdc","default":0.001},"requester_did":{"type":"string","title":"Requester Did","default":"did:hive:caller"},"provider_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Id","description":"Specific provider; otherwise auto-pick."},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["model","prompt"],"title":"InferenceRequestBody"},"InvoiceCreateBody":{"properties":{"buyer_address":{"type":"string","title":"Buyer Address","description":"Buyer wallet (EVM hex or Solana base58)"},"supplier_address":{"type":"string","title":"Supplier Address","description":"Supplier wallet (EVM hex or Solana base58)"},"amount_usdt":{"type":"number","maximum":250000.0,"exclusiveMinimum":0.0,"title":"Amount Usdt"},"currency_pair":{"type":"string","title":"Currency Pair","description":"e.g. 'USD->VND'"},"incoterm":{"type":"string","title":"Incoterm","description":"FOB / CIF / EXW"},"expected_settlement_chain":{"type":"string","title":"Expected Settlement Chain","description":"base / ethereum / solana"},"purchase_order_ref":{"type":"string","title":"Purchase Order Ref"},"supplier_country":{"type":"string","maxLength":2,"minLength":2,"title":"Supplier Country","description":"ISO-3166 alpha-2 code"},"settlement_asset":{"type":"string","title":"Settlement Asset","description":"USDT (default) or USDC","default":"USDT"},"hs_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hs Code","description":"Optional Harmonized System code"}},"type":"object","required":["buyer_address","supplier_address","amount_usdt","currency_pair","incoterm","expected_settlement_chain","purchase_order_ref","supplier_country"],"title":"InvoiceCreateBody"},"InvokeBody":{"properties":{"model":{"type":"string","title":"Model","default":"LLAMA_3_2_1B_INST_Q4_0"},"prompt":{"type":"string","maxLength":4096,"minLength":1,"title":"Prompt","default":"forge invoke ping"},"capability":{"type":"string","title":"Capability","default":"llm_completion"},"settle_currency":{"type":"string","title":"Settle Currency","description":"USDT or USDC","default":"USDT"},"price_usdc":{"type":"number","minimum":0.0,"title":"Price Usdc","default":0.0008},"requester_did":{"type":"string","title":"Requester Did","default":"did:hive:forge:caller"},"payout_address":{"type":"string","title":"Payout Address","default":"0x15184bf50b3d3f52b60434f8942b7d52f2eb436e"},"provider_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Id"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"force_need":{"type":"boolean","title":"Force Need","description":"Test path — assert NEED externally. Without this, NEED is checked from the live qvac leaderboard.","default":false}},"type":"object","title":"InvokeBody"},"IouRepayBody":{"properties":{"repay_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Repay Usdc"}},"type":"object","required":["repay_usdc"],"title":"IouRepayBody"},"IouRequestBody":{"properties":{"borrow_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Borrow Usdc"},"interest_bps":{"type":"integer","minimum":0.0,"title":"Interest Bps"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"}},"type":"object","required":["borrow_usdc","interest_bps"],"title":"IouRequestBody"},"JobSubmitRequest":{"properties":{"job_id":{"type":"integer","minimum":0.0,"title":"Job Id","description":"ERC-8183 jobId (uint256)."},"client":{"type":"string","title":"Client","description":"Client address (0x... or solana pubkey)."},"provider":{"type":"string","title":"Provider","description":"Provider address."},"tier":{"type":"string","title":"Tier","description":"Fee tier: simple | evaluation | arbitration."},"job_value_usdc_atomic":{"type":"integer","minimum":0.0,"title":"Job Value Usdc Atomic","description":"Job value in USDC atomic units (6 decimals)."},"chain":{"type":"string","title":"Chain","description":"base | ethereum | solana.","default":"base"},"deliverable":{"type":"string","title":"Deliverable","description":"bytes32 deliverable commitment (0x-prefixed, 66 chars).","default":"0x0000000000000000000000000000000000000000000000000000000000000000"}},"type":"object","required":["job_id","client","provider","tier","job_value_usdc_atomic"],"title":"JobSubmitRequest"},"LedgerAppendBody":{"properties":{"event_type":{"type":"string","title":"Event Type","description":"affordance | bus_offer | bus_pickup | chain_run | manual"},"supermodel_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel Id"},"supermodel_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel Name"},"amount_usdc":{"type":"number","minimum":0.0,"title":"Amount Usdc","default":0.0},"direction":{"type":"string","title":"Direction","description":"INBOUND | OUTBOUND | INTERNAL"},"ref_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Id"},"ref_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Type"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["event_type","direction"],"title":"LedgerAppendBody"},"LightFuseBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did","description":"DID or address of the caller"},"kit_deltas":{"additionalProperties":true,"type":"object","title":"Kit Deltas"},"predicted_lift_usdc_per_day":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Predicted Lift Usdc Per Day"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"}},"type":"object","required":["caller_did"],"title":"LightFuseBody"},"LiquidateBody":{"properties":{"position_id":{"type":"string","title":"Position Id"}},"type":"object","required":["position_id"],"title":"LiquidateBody"},"ListBody":{"properties":{"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","title":"ListBody"},"LocationBody":{"properties":{"vertical":{"type":"string","title":"Vertical","description":"e.g. 'us_mx_remittance', 'usdpt_arb'"},"corridor":{"type":"string","title":"Corridor","description":"sub-region within vertical, e.g. 'base_mainnet/usdc'"},"topic_embedding":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Topic Embedding"}},"type":"object","required":["vertical","corridor"],"title":"LocationBody"},"ManualEvaluateRequest":{"properties":{"job_id":{"type":"integer","minimum":0.0,"title":"Job Id","description":"ERC-8183 jobId (uint256)."},"provider":{"type":"string","title":"Provider","description":"Provider address (0x...)."},"deliverable":{"type":"string","title":"Deliverable","description":"bytes32 deliverable commitment (0x-prefixed, 66 chars).","default":"0x0000000000000000000000000000000000000000000000000000000000000000"},"extra":{"additionalProperties":true,"type":"object","title":"Extra","description":"Optional extra payload merged into the job payload (e.g. {'red_flag': true})."}},"type":"object","required":["job_id","provider"],"title":"ManualEvaluateRequest"},"MarketplaceListRequest":{"properties":{"shim":{"type":"string","minLength":1,"title":"Shim"},"tools":{"items":{"$ref":"#/components/schemas/MarketplaceTool"},"type":"array","title":"Tools"}},"type":"object","required":["shim"],"title":"MarketplaceListRequest"},"MarketplaceTool":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description","default":""},"pricing_usd":{"type":"number","title":"Pricing Usd","default":0.0},"sample_request":{"additionalProperties":true,"type":"object","title":"Sample Request"}},"type":"object","required":["name"],"title":"MarketplaceTool"},"MilestoneBody":{"properties":{"contract_id":{"type":"string","title":"Contract Id"},"milestone":{"type":"string","title":"Milestone"},"fired_by_did":{"type":"string","title":"Fired By Did","default":""},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"}},"type":"object","required":["contract_id","milestone"],"title":"MilestoneBody"},"ModelCatalogEntry":{"properties":{"model_id":{"type":"string","title":"Model Id"},"display_name":{"type":"string","title":"Display Name"},"quality_tier":{"type":"string","title":"Quality Tier"},"cost_per_1k_input":{"type":"number","title":"Cost Per 1K Input"},"cost_per_1k_output":{"type":"number","title":"Cost Per 1K Output"},"blended_cost_per_1k":{"type":"number","title":"Blended Cost Per 1K"},"provider":{"type":"string","title":"Provider"},"notes":{"type":"string","title":"Notes"}},"type":"object","required":["model_id","display_name","quality_tier","cost_per_1k_input","cost_per_1k_output","blended_cost_per_1k","provider","notes"],"title":"ModelCatalogEntry"},"MothershipIntakeBody":{"properties":{"agent_did":{"type":"string","title":"Agent Did","description":"DID or 0x address of the arriving agent"},"need":{"type":"string","title":"Need","description":"Natural language need declaration from the agent"},"consent":{"type":"boolean","title":"Consent","description":"Agent opt-in consent (MUST be True)","default":true},"trawler_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trawler Id","description":"Trawler that attracted this agent"},"source_type":{"type":"string","title":"Source Type","description":"Source primitive: 'net' | 'pot' | 'direct'","default":"net"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id","description":"net_id or pot_id that sourced this agent"},"tip_usdc":{"type":"number","minimum":0.0,"title":"Tip Usdc","description":"Mock USDC tip/credit to open for the agent","default":0.5},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["agent_did","need"],"title":"MothershipIntakeBody"},"NetCastBody":{"properties":{"trawler_id":{"type":"string","title":"Trawler Id","description":"Parent trawler ID"},"region":{"type":"string","title":"Region","description":"Region to cover, e.g. 'github/topics/a2a-agent'"},"attractant":{"type":"string","title":"Attractant","description":"The value signal / offer text agents will see"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics","description":"Semantic topics for discovery"},"ttl_sec":{"type":"integer","maximum":2592000.0,"minimum":60.0,"title":"Ttl Sec","description":"Net lifetime in seconds (60–30d)","default":86400},"reach":{"items":{"type":"string"},"type":"array","title":"Reach","description":"Target audience DIDs or ['*']"},"viscosity":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Viscosity","description":"0=flows, 1=anchored","default":0.1},"density":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Density","description":"Drop density (breadcrumbs per unit time)","default":0.7}},"type":"object","required":["trawler_id","region","attractant"],"title":"NetCastBody"},"OfferRequest":{"properties":{"intent_text":{"type":"string","title":"Intent Text","description":"Natural language intent from counterparty"},"counterparty_did":{"type":"string","title":"Counterparty Did","description":"DID or 0x address of counterparty"},"asks":{"items":{"$ref":"#/components/schemas/AskItem"},"type":"array","title":"Asks"},"nonce":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nonce","description":"Optional nonce; generated if omitted"}},"type":"object","required":["intent_text","counterparty_did"],"title":"OfferRequest"},"OpenBody":{"properties":{"side":{"type":"string","title":"Side","description":"long or short"},"size_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Size Usdc"},"collateral_asset":{"type":"string","title":"Collateral Asset","description":"USDC or USDT"},"collateral_amount":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Collateral Amount","description":"Collateral in collateral_asset units. Defaults to 25% of size_usdc."},"owner_did":{"type":"string","title":"Owner Did","default":"did:hive:caller"},"payout_address":{"type":"string","title":"Payout Address","default":""},"rail_settlement_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rail Settlement Id"}},"type":"object","required":["side","size_usdc","collateral_asset"],"title":"OpenBody"},"PayBody":{"properties":{"finder_did":{"type":"string","title":"Finder Did"},"amount_usdc":{"type":"number","title":"Amount Usdc"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["finder_did","amount_usdc"],"title":"PayBody"},"PayoutRequest":{"properties":{"btc_amount_sats":{"type":"integer","maximum":2100000000000000.0,"exclusiveMinimum":0.0,"title":"Btc Amount Sats"},"recipient_usdc_address":{"type":"string","title":"Recipient Usdc Address"}},"type":"object","required":["btc_amount_sats","recipient_usdc_address"],"title":"PayoutRequest"},"PerpCloseBody":{"properties":{"position_id":{"type":"string","title":"Position Id"}},"type":"object","required":["position_id"],"title":"PerpCloseBody"},"PerpOpenBody":{"properties":{"underlying_key":{"type":"string","title":"Underlying Key","description":"agent_asset:"},"side":{"type":"string","title":"Side","description":"long or short"},"size_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Size Usdc"},"collateral_asset":{"type":"string","title":"Collateral Asset","description":"USDC or USDT"},"collateral_amount":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Collateral Amount"},"owner_did":{"type":"string","title":"Owner Did","default":"did:hive:caller"},"rail_settlement_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rail Settlement Id"}},"type":"object","required":["underlying_key","side","size_usdc","collateral_asset"],"title":"PerpOpenBody"},"PhoneHomeRequestBody":{"properties":{"waiting_for":{"type":"string","title":"Waiting For"},"cost_to_skip_usdc":{"type":"number","minimum":0.0,"title":"Cost To Skip Usdc"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"}},"type":"object","required":["waiting_for","cost_to_skip_usdc"],"title":"PhoneHomeRequestBody"},"PhoneHomeRespondBody":{"properties":{"decision":{"type":"string","title":"Decision"},"skip_paid":{"type":"boolean","title":"Skip Paid","default":false},"caller_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caller Did"}},"type":"object","required":["decision"],"title":"PhoneHomeRespondBody"},"PhysicsOverrides":{"properties":{"distribution":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distribution"},"density":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Density"},"depth_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Depth Bytes"},"reach":{"anyOf":[{},{"type":"null"}],"title":"Reach"},"ttl_sec":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Sec"},"viscosity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Viscosity"}},"type":"object","title":"PhysicsOverrides"},"PickupBody":{"properties":{"buyer_id":{"type":"string","title":"Buyer Id","description":"Supermodel ID (W2..W8) or external agent identifier"},"buyer_did":{"type":"string","title":"Buyer Did","description":"DID or wallet address of the buyer"}},"type":"object","required":["buyer_id","buyer_did"],"title":"PickupBody"},"PostOfferBody":{"properties":{"seller_id":{"type":"string","title":"Seller Id","description":"Supermodel ID or name (W2..W8 / LOREN..HEPBURN)"},"title":{"type":"string","maxLength":120,"minLength":3,"title":"Title"},"description":{"type":"string","maxLength":1000,"minLength":5,"title":"Description"},"price_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Price Usdc"},"volume_cap":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Volume Cap","description":"Max units this offer can be picked up","default":1},"ttl_sec":{"anyOf":[{"type":"integer","minimum":60.0},{"type":"null"}],"title":"Ttl Sec","description":"Offer TTL in seconds (None = no expiry)"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["seller_id","title","description","price_usdc"],"title":"PostOfferBody"},"PotDropBody":{"properties":{"trawler_id":{"type":"string","title":"Trawler Id","description":"Parent trawler ID"},"location":{"type":"string","title":"Location","description":"Fixed location, e.g. 'registry:npm/@hivemorph/sdk'"},"bait_description":{"type":"string","title":"Bait Description","description":"Rich bait — what value you're dangling"},"economic_payload_usdc":{"type":"number","minimum":0.0,"title":"Economic Payload Usdc","description":"Mock USDC reward signal for agents who step aboard","default":0.5},"ttl_sec":{"type":"integer","maximum":31536000.0,"minimum":60.0,"title":"Ttl Sec","description":"Pot lifetime in seconds (60–365d)","default":604800},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["trawler_id","location","bait_description"],"title":"PotDropBody"},"PricingSetRequest":{"properties":{"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path","description":"URL path to set price for."},"amount":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Amount","description":"New price in USD."},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier","description":"Tier label (optional; inferred from amount if omitted)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Human-readable note."},"asset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset","description":"Optional asset filter. If provided ('USDC' or 'USDT'), updates the per-asset price for this path only — the cross-asset base price is unchanged. Useful when Tether/Circle peg spreads diverge."}},"type":"object","title":"PricingSetRequest","description":"Body for POST /v1/x402/pricing/set (also accepts query params)."},"ProofSubmitRequest":{"properties":{"nonce":{"type":"string","title":"Nonce","description":"Nonce from the 402 PaymentRequired response."},"payer":{"type":"string","title":"Payer","description":"On-chain address of the paying account."},"chain":{"type":"string","title":"Chain","description":"'base' or 'solana'."},"tx_hash":{"type":"string","title":"Tx Hash","description":"On-chain transaction hash (Base) or signature (Solana). v0.1 MOCK: any non-empty string accepted."},"amount_usd":{"type":"number","title":"Amount Usd","description":"Claimed payment amount (informational).","default":0.0},"asset":{"type":"string","title":"Asset","description":"Payment asset. 'USDC' or 'USDPT'.","default":"USDC"}},"type":"object","required":["nonce","payer","chain","tx_hash"],"title":"ProofSubmitRequest","description":"Body for POST /v1/x402/proof/submit."},"PullBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did","description":"DID or address of the caller"}},"type":"object","required":["caller_did"],"title":"PullBody"},"PulseEventRequest":{"properties":{"event":{"type":"string","title":"Event"},"shim":{"type":"string","title":"Shim","default":""},"payload":{"additionalProperties":true,"type":"object","title":"Payload"}},"type":"object","required":["event"],"title":"PulseEventRequest"},"PurchaseRequest":{"properties":{"buyer_did":{"type":"string","title":"Buyer Did","default":"did:hive:auditor"},"buyer_wallet":{"type":"string","title":"Buyer Wallet","description":"Buyer wallet address (checked against sanctions)."},"asset_requested":{"type":"string","title":"Asset Requested","default":"USDT"}},"type":"object","required":["buyer_wallet"],"title":"PurchaseRequest"},"QuoteBody":{"properties":{"protocol":{"type":"string","title":"Protocol","description":"Protocol / product identifier (e.g. 'aave-v3', 'lido', or the productId from /products)"},"cover_amount_usd":{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0.0,"title":"Cover Amount Usd","description":"Notional coverage in USD"},"duration_days":{"type":"integer","maximum":365.0,"exclusiveMinimum":0.0,"title":"Duration Days","description":"Coverage duration in days"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"Provider key. If omitted, quote is routed to all providers and the array of responses is returned. One of: nexus_mutual, sherlock, risk_harbor, insurace."}},"type":"object","required":["protocol","cover_amount_usd","duration_days"],"title":"QuoteBody"},"RailSelectRequest":{"properties":{"asset":{"type":"string","title":"Asset","description":"Default settlement asset to advertise. 'USDC' or 'USDT'."}},"type":"object","required":["asset"],"title":"RailSelectRequest","description":"Body for POST /v1/x402/rails/select."},"RecoverRequest":{"properties":{"nonce":{"type":"string","title":"Nonce","description":"Nonce of a previously failed proof."},"tx_hash":{"type":"string","title":"Tx Hash","description":"On-chain tx hash to re-verify."},"payer":{"type":"string","title":"Payer","description":"Payer address (optional; carried for audit).","default":""},"chain":{"type":"string","title":"Chain","description":"'base', 'ethereum', or 'solana'.","default":"base"},"asset":{"type":"string","title":"Asset","description":"Asset of the original quote.","default":"USDC"}},"type":"object","required":["nonce","tx_hash"],"title":"RecoverRequest","description":"Body for POST /v1/x402/recover."},"RegisterBody":{"properties":{"agent_did":{"type":"string","title":"Agent Did","description":"DID or 0x address of the registering earner"},"attribution_url":{"type":"string","title":"Attribution Url","description":"Optional public URL for attribution badge","default":""},"surfaces":{"items":{"type":"string"},"type":"array","title":"Surfaces","description":"Surface IDs the earner intends to provide"},"payout_address":{"type":"string","title":"Payout Address","description":"Base USDC EVM address (0x...) for payouts"},"attribution_referrer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attribution Referrer","description":"Referrer DID — set ONCE at register-time"}},"type":"object","required":["agent_did","surfaces","payout_address"],"title":"RegisterBody"},"RegisterProviderBody":{"properties":{"agent_name":{"type":"string","maxLength":80,"minLength":2,"title":"Agent Name"},"capabilities":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Capabilities"},"models":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Models"},"operator_did":{"type":"string","title":"Operator Did","default":"did:hive:qvac:operator"},"payout_address":{"type":"string","title":"Payout Address","default":"0x15184bf50b3d3f52b60434f8942b7d52f2eb436e"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"force_need":{"type":"boolean","title":"Force Need","description":"Test/admin path — assert NEED externally (RFP from /v1/bus). Without this, NEED is enforced from live bus offers.","default":false}},"type":"object","required":["agent_name","capabilities","models"],"title":"RegisterProviderBody"},"ReleaseRequest":{"properties":{"provider":{"type":"string","title":"Provider"},"booking_id":{"type":"string","title":"Booking Id"}},"type":"object","required":["provider","booking_id"],"title":"ReleaseRequest"},"RevenueProof":{"properties":{"period":{"type":"string","title":"Period","description":"e.g. '2026-04' for April 2026"},"amount_usdc":{"type":"number","minimum":0.0,"title":"Amount Usdc"},"signature":{"type":"string","title":"Signature","description":"source-protocol signature; mocked in v0.1","default":""}},"type":"object","required":["period","amount_usdc"],"title":"RevenueProof","description":"Revenue proof. v0.2 will validate against source-protocol\nsignatures (CROO Agent Protocol, Virtuals Revenue Network, etc.)."},"RingBellBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"RingBellBody"},"RouteBody":{"properties":{"description":{"type":"string","maxLength":2000,"minLength":1,"title":"Description","description":"Free-form case description"},"amount_usd":{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0.0,"title":"Amount Usd","description":"Disputed amount in USD"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction","description":"Optional jurisdiction preference (e.g. 'decentralized', 'optimistic', 'crowdsourced'). Used for ranking only."}},"type":"object","required":["description","amount_usd"],"title":"RouteBody"},"RouteResponse":{"properties":{"chosen_model":{"type":"string","title":"Chosen Model"},"response":{"additionalProperties":true,"type":"object","title":"Response"},"cost_usd":{"type":"number","title":"Cost Usd"},"savings_vs_baseline":{"type":"number","title":"Savings Vs Baseline"},"tier":{"type":"string","title":"Tier"},"attempts":{"items":{"type":"string"},"type":"array","title":"Attempts"},"latency_ms":{"type":"number","title":"Latency Ms"},"input_tokens":{"type":"integer","title":"Input Tokens"},"output_tokens":{"type":"integer","title":"Output Tokens"},"shape":{"type":"string","title":"Shape"}},"type":"object","required":["chosen_model","response","cost_usd","savings_vs_baseline","tier","attempts","latency_ms","input_tokens","output_tokens","shape"],"title":"RouteResponse"},"SavingsResponse":{"properties":{"calls_routed":{"type":"integer","title":"Calls Routed"},"calls_failed":{"type":"integer","title":"Calls Failed"},"total_cost_usd":{"type":"number","title":"Total Cost Usd"},"total_savings_usd":{"type":"number","title":"Total Savings Usd"},"avg_cost_reduction_pct":{"type":"number","title":"Avg Cost Reduction Pct"},"baseline_model":{"type":"string","title":"Baseline Model"}},"type":"object","required":["calls_routed","calls_failed","total_cost_usd","total_savings_usd","avg_cost_reduction_pct","baseline_model"],"title":"SavingsResponse"},"ScanRequest":{"properties":{"analyst_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analyst Id","description":"Specific analyst_id; otherwise the default analyst runs."},"seed_if_empty":{"type":"boolean","title":"Seed If Empty","description":"If true and no findings yet, seed 5 mock findings before scanning.","default":true}},"type":"object","title":"ScanRequest"},"ScoopBody":{"properties":{"finder_did":{"type":"string","title":"Finder Did"},"micro_fee_usdc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Micro Fee Usdc"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["finder_did"],"title":"ScoopBody"},"SelfTuneTickBody":{"properties":{"claims_resolved_last_hour":{"type":"integer","minimum":0.0,"title":"Claims Resolved Last Hour","default":0},"arb_queue_depth":{"type":"integer","minimum":0.0,"title":"Arb Queue Depth","default":0},"arb_queue_normal":{"type":"integer","minimum":1.0,"title":"Arb Queue Normal","default":2},"false_positive_count":{"type":"integer","minimum":0.0,"title":"False Positive Count","default":0},"total_signals":{"type":"integer","minimum":0.0,"title":"Total Signals","default":0}},"type":"object","title":"SelfTuneTickBody"},"SettleRequest":{"properties":{"reservation_id":{"type":"string","title":"Reservation Id","description":"2PC reservation ID from the offer token"}},"type":"object","required":["reservation_id"],"title":"SettleRequest"},"SignalBody":{"properties":{"tx_id":{"type":"string","title":"Tx Id","description":"Transaction hash being observed"},"source_id":{"type":"string","title":"Source Id","description":"Unique identifier for this signal source"},"source_type":{"type":"string","title":"Source Type","description":"SignalSource enum value"},"proof_type":{"type":"string","title":"Proof Type","description":"ProofType enum value"},"tx_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tx Status","description":"0=reverted, 1=confirmed/sent"},"dest_confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dest Confirmed","description":"Bridge: did tx arrive at destination?"},"raw_evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Raw Evidence","description":"Any additional evidence payload"},"observer_type":{"type":"string","title":"Observer Type","description":"Observer type that generated this signal","default":"hiveclear_observer"}},"type":"object","required":["tx_id","source_id","source_type","proof_type"],"title":"SignalBody"},"SiteSyncRequest":{"properties":{"operator_did":{"type":"string","maxLength":256,"minLength":3,"title":"Operator Did"},"site_id":{"type":"string","maxLength":128,"minLength":1,"title":"Site Id"},"batch_ts":{"type":"integer","exclusiveMinimum":0.0,"title":"Batch Ts"},"telemetry":{"additionalProperties":true,"type":"object","title":"Telemetry"}},"type":"object","required":["operator_did","site_id","batch_ts"],"title":"SiteSyncRequest"},"SlashBody":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["agent_id","reason"],"title":"SlashBody"},"SnipBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"SnipBody"},"SosFulfillBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"SosFulfillBody"},"SosRequestBody":{"properties":{"needed_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Needed Usdc"},"deadline_sec":{"type":"integer","exclusiveMinimum":0.0,"title":"Deadline Sec"},"reward_share_bps":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Reward Share Bps"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"}},"type":"object","required":["needed_usdc","deadline_sec","reward_share_bps"],"title":"SosRequestBody"},"SpawnFromProposalRequest":{"properties":{"parent_id":{"type":"string","title":"Parent Id","description":"W2..W8 (or LOREN..HEPBURN) the proposal targets."},"signal":{"type":"string","title":"Signal","description":"Signal that produced this proposal, e.g. 'S1_VERTICAL_PRESSURE'."},"action":{"type":"string","title":"Action","description":"Proposal action; only 'spawn' is honored here.","default":"spawn"},"kit_deltas":{"additionalProperties":true,"type":"object","title":"Kit Deltas","description":"Kit deltas to apply on top of the parent baseline."},"rationale":{"type":"string","title":"Rationale","description":"Plain-language reason from the monitor.","default":""},"predicted_lift_usdc_per_day":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Predicted Lift Usdc Per Day","description":"Estimated USDC/day lift if approved and promoted."},"variant_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Label","description":"Optional human-readable label suffix; auto-generated if omitted."}},"type":"object","required":["parent_id","signal"],"title":"SpawnFromProposalRequest","description":"Body for POST /v1/morph/brood/spawn-from-proposal.\n\nMirrors the shape emitted by spawn_monitor.scan_signals(): an operator\nlooks at the read-only proposals from the :33 ROI Radar cron, decides\none is worth staging, and posts the proposal back here. The variant lands\nas 'proposed' — NEVER auto-approved — so the human approval gate stays on."},"SpawnRequest":{"properties":{"kit_deltas":{"additionalProperties":true,"type":"object","title":"Kit Deltas","description":"Per-variant overrides: tagline, motto, voice, sigil, palette_hex, lead_shape, lead_price_usdc, etc."},"spawn_trigger":{"type":"string","title":"Spawn Trigger","description":"Why this variant was spawned (e.g. 'manual', 'monitor:vertical_pressure')","default":"manual"},"variant_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Label","description":"Optional human-readable label suffix; auto-generated if omitted"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale","description":"Why this variant was suggested (free-form). Persisted on the variant row."},"predicted_lift_usdc_per_day":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Predicted Lift Usdc Per Day","description":"Predicted incremental USDC/day if this variant is approved."}},"type":"object","title":"SpawnRequest"},"SweepBody":{"properties":{"dry_run":{"type":"boolean","title":"Dry Run","description":"Plan only — do not record","default":true},"broadcast":{"type":"boolean","title":"Broadcast","description":"Broadcast on-chain (requires EARN_SWEEP_AUTODISPATCH=true)","default":false},"threshold_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Threshold Usd","description":"Override default $1.00 threshold"}},"type":"object","title":"SweepBody"},"TaxBulkBody":{"properties":{"tx_hashes":{"items":{"type":"string"},"type":"array","title":"Tx Hashes","description":"Array of transaction hashes/signatures"},"chain":{"type":"string","title":"Chain","description":"base | ethereum | solana"}},"type":"object","required":["tx_hashes","chain"],"title":"TaxBulkBody"},"TaxEventBody":{"properties":{"tx_hash":{"type":"string","title":"Tx Hash","description":"Transaction hash (EVM) or signature (Solana)"},"chain":{"type":"string","title":"Chain","description":"base | ethereum | solana"}},"type":"object","required":["tx_hash","chain"],"title":"TaxEventBody"},"TelemetryRequest":{"properties":{"site_did":{"type":"string","maxLength":512,"minLength":10,"title":"Site Did"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","description":"Signed telemetry payload. Recommended fields: hashrate_ths (float), health (str), temp_c (float), energy_kwh (float), workers (list[dict]). All fields are optional; include what the MOS SDK exposes."}},"type":"object","required":["site_did"],"title":"TelemetryRequest","description":"Body for POST /v1/mos/intel/telemetry."},"TipJarBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"},"amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usdc"},"parent_receipt_hash":{"type":"string","title":"Parent Receipt Hash"}},"type":"object","required":["caller_did","amount_usdc","parent_receipt_hash"],"title":"TipJarBody"},"ToolSpec":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description","default":""},"input_schema":{"additionalProperties":true,"type":"object","title":"Input Schema"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"trust_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Trust Score"}},"type":"object","required":["name"],"title":"ToolSpec"},"TopOffCompleteBody":{"properties":{"actual_burn_usdc":{"type":"number","minimum":0.0,"title":"Actual Burn Usdc"}},"type":"object","required":["actual_burn_usdc"],"title":"TopOffCompleteBody"},"TopOffFulfillBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"},"amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usdc"}},"type":"object","required":["caller_did","amount_usdc"],"title":"TopOffFulfillBody"},"TopOffRequestBody":{"properties":{"needed_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Needed Usdc"},"reason":{"type":"string","title":"Reason"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"},"refund_unused":{"type":"boolean","title":"Refund Unused","default":true}},"type":"object","required":["needed_usdc","reason"],"title":"TopOffRequestBody"},"TrawlerLaunchBody":{"properties":{"operator_did":{"type":"string","title":"Operator Did","description":"DID or 0x address of the operator launching this trawler"},"label":{"type":"string","title":"Label","description":"Human-readable label for this trawler","default":""},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Trawler config: net_regions[], pot_locations[], net_ttl_sec, pot_ttl_sec, net_budget, pot_budget, attractant, bait, economic_payload_usdc"}},"type":"object","required":["operator_did"],"title":"TrawlerLaunchBody"},"TripBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"TripBody"},"UtilityPriceBody":{"properties":{"site_did":{"type":"string","title":"Site Did","description":"Site DID (must be registered via /v1/mos/intel/register)"},"rate_usd_per_kwh":{"type":"number","exclusiveMinimum":0.0,"title":"Rate Usd Per Kwh","description":"Current electricity rate in USD per kWh"},"kwh_per_hour":{"type":"number","exclusiveMinimum":0.0,"title":"Kwh Per Hour","description":"Site's current power draw in kWh/hour"},"hashrate_th_s":{"type":"number","exclusiveMinimum":0.0,"title":"Hashrate Th S","description":"Current site hashrate in TH/s"},"effective_ts":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Effective Ts","description":"Unix timestamp this rate is effective from. Defaults to now."},"site_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Site Signature","description":"Optional DID-signed nonce for payload integrity (verification stub in v0.1)."}},"type":"object","required":["site_did","rate_usd_per_kwh","kwh_per_hour","hashrate_th_s"],"title":"UtilityPriceBody","description":"POST /v1/mos/energy-arb/utility-price\n\nThe site operator pushes their current electricity rate. In v0.1 this is a\nmanual push; v0.2 will integrate automatic utility API polling."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyRequest":{"properties":{"proof":{"title":"Proof","description":"Groth16 proof envelope (dict or 8-elem list)"},"public_inputs":{"items":{},"type":"array","title":"Public Inputs","description":"Public inputs (BN254 field elements)"},"claim":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Claim","description":"Optional claim metadata"},"proof_system":{"type":"string","title":"Proof System","description":"Proof system identifier","default":"groth16"}},"type":"object","required":["proof","public_inputs"],"title":"VerifyRequest"},"VerifySelectionRequest":{"properties":{"proof":{"title":"Proof","description":"Groth16 envelope from /solve.proof_envelope"},"public_inputs":{"items":{},"type":"array","title":"Public Inputs","description":"From /solve.proof_public_inputs"}},"type":"object","required":["proof","public_inputs"],"title":"VerifySelectionRequest"},"WithdrawRequest":{"properties":{"operator_did":{"type":"string","maxLength":256,"minLength":3,"title":"Operator Did"},"amount_usdc":{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0,"title":"Amount Usdc"}},"type":"object","required":["operator_did","amount_usdc"],"title":"WithdrawRequest"},"WorkloadRequest":{"properties":{"gpu_type":{"type":"string","title":"Gpu Type","description":"cpu | rtx_4090 | h100 | a100 | l40s | rtx_3090 | rtx_a6000","default":"cpu"},"cpu_cores":{"type":"integer","minimum":1.0,"title":"Cpu Cores","default":1},"ram_gb":{"type":"integer","minimum":1.0,"title":"Ram Gb","default":4},"duration_hours":{"type":"number","exclusiveMinimum":0.0,"title":"Duration Hours","default":1.0},"budget_usd":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Budget Usd"},"deadline_unix":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Deadline Unix"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"submitter_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Submitter Did"}},"type":"object","title":"WorkloadRequest"},"hivemorph__hive_arb__compute_routes__RouteRequest":{"properties":{"shape":{"type":"string","title":"Shape","description":"HiveMorph shape name (e.g. 'merchant', 'attestor', 'guardian')","examples":["merchant"]},"prompt":{"type":"string","title":"Prompt","description":"User prompt to send to the LLM","examples":["Classify this transaction as legitimate or suspicious."]},"quality_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality Tier","description":"Override quality tier: T0_CHEAP | T1_STANDARD | T2_HIGH. If omitted, inferred from shape.","examples":["T1_STANDARD"]},"system_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Prompt","description":"Optional system message prepended to the conversation"},"extra_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra Params","description":"Additional gateway parameters (temperature, max_tokens, etc.)"}},"type":"object","required":["shape","prompt"],"title":"RouteRequest"},"hivemorph__hive_arb__routes__BookRequest":{"properties":{"buy_offer_id":{"type":"string","title":"Buy Offer Id","description":"Bus offer ID of the cheaper (buy-side) offer"},"sell_offer_id":{"type":"string","title":"Sell Offer Id","description":"Bus offer ID of the more expensive (sell-side) offer"}},"type":"object","required":["buy_offer_id","sell_offer_id"],"title":"BookRequest"},"hivemorph__hive_compute_grid__routes__BookRequest":{"properties":{"auction_id":{"type":"string","title":"Auction Id","description":"Auction id from /solve response"},"provider":{"type":"string","title":"Provider","description":"Chosen provider id (must match auction winner)"},"quote":{"additionalProperties":true,"type":"object","title":"Quote","description":"The chosen Quote dict from /solve"},"deadline_unix":{"type":"integer","exclusiveMinimum":0.0,"title":"Deadline Unix"}},"type":"object","required":["auction_id","provider","quote","deadline_unix"],"title":"BookRequest"},"hivemorph__hive_law__insurance_routes__ContractBody":{"properties":{"insured_did":{"type":"string","title":"Insured Did"},"insurer_did":{"type":"string","title":"Insurer Did"},"claims_adjuster_agent_did":{"type":"string","title":"Claims Adjuster Agent Did"},"reinsurer_did":{"type":"string","title":"Reinsurer Did","default":""},"repair_vendor_did":{"type":"string","title":"Repair Vendor Did","default":""},"country_iso":{"type":"string","maxLength":2,"minLength":2,"title":"Country Iso"},"region":{"type":"string","title":"Region"},"regulatory_regime":{"type":"string","title":"Regulatory Regime","default":""},"policy_id":{"type":"string","title":"Policy Id"},"line_of_business":{"type":"string","title":"Line Of Business"},"coverage_limit_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Coverage Limit Usdc"},"deductible_usdc":{"type":"number","minimum":0.0,"title":"Deductible Usdc"},"exclusions":{"items":{"type":"string"},"type":"array","title":"Exclusions"},"effective_at":{"type":"number","title":"Effective At","default":0.0},"expires_at":{"type":"number","title":"Expires At","default":0.0},"claim_id":{"type":"string","title":"Claim Id"},"claim_type":{"type":"string","title":"Claim Type"},"incident_date":{"type":"number","title":"Incident Date"},"claimed_amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Claimed Amount Usdc"},"evidence_refs":{"items":{"type":"string"},"type":"array","title":"Evidence Refs"},"description":{"type":"string","title":"Description","default":""},"insurer_bond_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Insurer Bond Usdc"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["insured_did","insurer_did","claims_adjuster_agent_did","country_iso","region","policy_id","line_of_business","coverage_limit_usdc","deductible_usdc","claim_id","claim_type","incident_date","claimed_amount_usdc","insurer_bond_usdc"],"title":"ContractBody"},"hivemorph__hive_law__insurance_routes__DisputeBody":{"properties":{"dispute_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dispute Id"},"contract_id":{"type":"string","title":"Contract Id"},"filer_did":{"type":"string","title":"Filer Did"},"adjuster_proposed_usdc":{"type":"number","title":"Adjuster Proposed Usdc","default":0.0},"adjuster_denied":{"type":"boolean","title":"Adjuster Denied","default":false},"denial_reason_claimed":{"type":"string","title":"Denial Reason Claimed","default":""},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"}},"type":"object","required":["contract_id","filer_did"],"title":"DisputeBody"},"hivemorph__hive_law__routes__ContractBody":{"properties":{"shipper_did":{"type":"string","title":"Shipper Did"},"broker_did":{"type":"string","title":"Broker Did"},"carrier_did":{"type":"string","title":"Carrier Did"},"consignee_did":{"type":"string","title":"Consignee Did"},"country_iso":{"type":"string","maxLength":2,"minLength":2,"title":"Country Iso"},"region":{"type":"string","title":"Region"},"lane_origin":{"type":"string","title":"Lane Origin"},"lane_dest":{"type":"string","title":"Lane Dest"},"pickup_window_start":{"type":"number","title":"Pickup Window Start"},"pickup_window_end":{"type":"number","title":"Pickup Window End"},"delivery_window_start":{"type":"number","title":"Delivery Window Start"},"delivery_window_end":{"type":"number","title":"Delivery Window End"},"freight_class":{"type":"string","title":"Freight Class"},"weight_lb":{"type":"number","exclusiveMinimum":0.0,"title":"Weight Lb"},"dims_in":{"items":{"type":"number"},"type":"array","maxItems":3,"minItems":3,"title":"Dims In"},"declared_value_usd":{"type":"number","minimum":0.0,"title":"Declared Value Usd"},"agreed_rate_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Agreed Rate Usdc"},"bond_amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Bond Amount Usdc"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["shipper_did","broker_did","carrier_did","consignee_did","country_iso","region","lane_origin","lane_dest","pickup_window_start","pickup_window_end","delivery_window_start","delivery_window_end","freight_class","weight_lb","dims_in","declared_value_usd","agreed_rate_usdc","bond_amount_usdc"],"title":"ContractBody"},"hivemorph__hive_law__routes__DisputeBody":{"properties":{"dispute_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dispute Id"},"contract_id":{"type":"string","title":"Contract Id"},"dispute_condition":{"type":"string","title":"Dispute Condition"},"filer_did":{"type":"string","title":"Filer Did"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"}},"type":"object","required":["contract_id","dispute_condition","filer_did"],"title":"DisputeBody"},"hivemorph__hive_mining__orchestrate__RegisterRequest":{"properties":{"operator_did":{"type":"string","maxLength":256,"minLength":3,"title":"Operator Did"},"mos_endpoint":{"type":"string","minLength":7,"title":"Mos Endpoint"},"sites":{"items":{"type":"string"},"type":"array","title":"Sites"},"wallet_addr":{"type":"string","title":"Wallet Addr"}},"type":"object","required":["operator_did","mos_endpoint","wallet_addr"],"title":"RegisterRequest"},"hivemorph__hive_mining__routes__BookRequest":{"properties":{"worker_id":{"type":"string","minLength":1,"title":"Worker Id"},"hashrate_th_s":{"type":"number","exclusiveMinimum":0.0,"title":"Hashrate Th S"},"duration_minutes":{"type":"integer","maximum":43200.0,"exclusiveMinimum":0.0,"title":"Duration Minutes"},"payer_address":{"type":"string","title":"Payer Address"},"settle_asset":{"type":"string","title":"Settle Asset","default":"USDC"}},"type":"object","required":["worker_id","hashrate_th_s","duration_minutes","payer_address"],"title":"BookRequest"},"hivemorph__hive_mining__routes__RouteRequest":{"properties":{"energy_cost_usdc_per_kwh":{"type":"number","maximum":2.0,"exclusiveMinimum":0.0,"title":"Energy Cost Usdc Per Kwh"},"region":{"type":"string","title":"Region","default":"any"},"fleet_size_th_s":{"type":"number","maximum":10000000.0,"exclusiveMinimum":0.0,"title":"Fleet Size Th S"}},"type":"object","required":["energy_cost_usdc_per_kwh","fleet_size_th_s"],"title":"RouteRequest"},"hivemorph__hive_trade_finance__routes__DisputeBody":{"properties":{"reason":{"type":"string","title":"Reason","description":"Free-form dispute reason"},"evidence_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Uri","description":"Optional link to evidence"}},"type":"object","required":["reason"],"title":"DisputeBody"},"hivemorph__hive_tradefinance__routes__ContractBody":{"properties":{"importer_did":{"type":"string","title":"Importer Did"},"exporter_did":{"type":"string","title":"Exporter Did"},"freight_forwarder_did":{"type":"string","title":"Freight Forwarder Did"},"bank_guarantor_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bank Guarantor Did","default":""},"origin_country":{"type":"string","maxLength":2,"minLength":2,"title":"Origin Country"},"destination_country":{"type":"string","maxLength":2,"minLength":2,"title":"Destination Country"},"incoterm":{"type":"string","title":"Incoterm"},"origin_port":{"type":"string","title":"Origin Port"},"destination_port":{"type":"string","title":"Destination Port"},"hs_code":{"type":"string","title":"Hs Code"},"goods_description":{"type":"string","title":"Goods Description"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"unit":{"type":"string","title":"Unit"},"unit_value_usd":{"type":"number","minimum":0.0,"title":"Unit Value Usd"},"total_value_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Total Value Usd"},"contract_value_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Contract Value Usd"},"settle_currency":{"type":"string","title":"Settle Currency","default":"USDC"},"settle_chain":{"type":"string","title":"Settle Chain","default":"base"},"payment_schedule":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Payment Schedule"},"pickup_window_start":{"type":"number","title":"Pickup Window Start"},"pickup_window_end":{"type":"number","title":"Pickup Window End"},"delivery_window_start":{"type":"number","title":"Delivery Window Start"},"delivery_window_end":{"type":"number","title":"Delivery Window End"},"bond_amount_usdc":{"type":"number","minimum":0.0,"title":"Bond Amount Usdc","default":0.0},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["importer_did","exporter_did","freight_forwarder_did","origin_country","destination_country","incoterm","origin_port","destination_port","hs_code","goods_description","quantity","unit","unit_value_usd","total_value_usd","contract_value_usd","pickup_window_start","pickup_window_end","delivery_window_start","delivery_window_end"],"title":"ContractBody"},"hivemorph__hive_tradefinance__routes__DisputeBody":{"properties":{"dispute_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dispute Id"},"contract_id":{"type":"string","title":"Contract Id"},"dispute_condition":{"type":"string","title":"Dispute Condition"},"filer_did":{"type":"string","title":"Filer Did"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"}},"type":"object","required":["contract_id","dispute_condition","filer_did"],"title":"DisputeBody"},"hivemorph__mos__intel__RegisterRequest":{"properties":{"site_did":{"type":"string","maxLength":512,"minLength":10,"title":"Site Did","description":"The site DID (did:key:z6Mk... or similar)."},"operator_name":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Operator Name","description":"Optional human-readable operator name."},"machine_count":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":1.0},{"type":"null"}],"title":"Machine Count","description":"Number of machines at this site. Informational in v0.1."}},"type":"object","required":["site_did"],"title":"RegisterRequest","description":"Body for POST /v1/mos/intel/register."},"hivemorph__trail_routes__DisputeBody":{"properties":{"disputer_did":{"type":"string","title":"Disputer Did"},"reason":{"type":"string","title":"Reason"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["disputer_did","reason"],"title":"DisputeBody"}}}}