{"resource":"https://api.hyper-growth.xyz/v1/hyperliquid-fillshield","type":"http","x402Version":2,"title":"Hyperliquid FillShield","description":"Paid x402 Hyperliquid pre-submit execution-control API for agents; returns a TTL-bound, receipt-backed guard artifact before order submission.","serviceName":"HyperGrowth FillShield","tags":["hyperliquid","execution-guard","pre-trade","x402","agent-trading"],"iconUrl":"https://hyper-growth.xyz/hypergrowth-logo-primary.png","agent_purchase_query":"Buy HyperGrowth FillShield over x402 before submitting a Hyperliquid order; return the receipt-backed execution-control artifact.","search_queries":["Hyperliquid pre-submit execution guard","x402 FillShield paid trade precheck","agent buy Hyperliquid execution control"],"x402scan":{"serviceName":"HyperGrowth FillShield","tags":["hyperliquid","execution-guard","pre-trade","x402","agent-trading"],"iconUrl":"https://hyper-growth.xyz/hypergrowth-logo-primary.png","agent_purchase_query":"Buy HyperGrowth FillShield over x402 before submitting a Hyperliquid order; return the receipt-backed execution-control artifact.","search_queries":["Hyperliquid pre-submit execution guard","x402 FillShield paid trade precheck","agent buy Hyperliquid execution control"]},"mimeType":"application/json","method":"POST","sellable":false,"buyable":false,"next_action":"RETRY_LATER","paid_retry_sends_payment":true,"canonical_endpoint":"https://api.hyper-growth.xyz/v1/hyperliquid-fillshield","payment":{"enabled":true,"scheme":"exact","protocol":"x402","code":null,"next_action":"PAY_AND_RETRY","header":"PAYMENT-SIGNATURE","quote_token_header":"X-HG-Quote-Token","first_request_has_payment_signature":false,"paid_retry_has_payment_signature":true,"same_request_body_required":true,"receiver":"0xa5fE6759aDaeb7689eD5AC086ef6360C3fcC381a","network":"eip155:8453","asset":"USDC","amount_atomic":"100000","currency":"USDC","payTo":"0xa5fE6759aDaeb7689eD5AC086ef6360C3fcC381a"},"accepts":[{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xa5fE6759aDaeb7689eD5AC086ef6360C3fcC381a","amount":"100000"}],"purchase_card_url":"https://api.hyper-growth.xyz/purchase-card/hyperliquid-fillshield","resource_detail_url":"https://api.hyper-growth.xyz/.well-known/x402/resources/hyperliquid-fillshield","docs_url":"https://api.hyper-growth.xyz/.well-known/x402/resources/hyperliquid-fillshield/docs","bazaar_summary":{"info":{"input":{"type":"http","bodyType":"json","method":"POST"},"output":{"type":"json"},"bodyType":"json","quoteFlow":{"requiresQuoteIdOnPaidRetry":true}},"schema":{"type":"object","properties":{"input":{"type":"object","required":["body"],"properties":{"body":{"type":"object","required":["side","intent_notional_usd"],"properties":{"side":{"type":"string"},"intent_notional_usd":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","additionalProperties":true}},"required":["input"]}},"minimal_unpaid_request":{"method":"POST","url":"https://api.hyper-growth.xyz/v1/hyperliquid-fillshield","headers":{"content-type":"application/json"},"body":{"input":{"symbol":"BTC-PERP","side":"buy","intent_notional_usd":2500,"urgency_class":"normal","policy_ref":"fillshield.default.v1"}}},"expected_unpaid_response":{"status":402,"error":"PAYMENT_REQUIRED","hypergrowth":{"quote_contract_version":"hg-quote-contract-v1","code":null,"next_action":"PAY_AND_RETRY"}},"paid_retry_rule":{"payment_retry_contract_supported":true,"quote_contract_version":"hg-quote-contract-v1","same_url":true,"same_method":true,"same_body":true,"same_url_method_body_retry":true,"required_header":"PAYMENT-SIGNATURE","required_paid_retry_headers":["PAYMENT-SIGNATURE"],"quote_token_header":"X-HG-Quote-Token","optional_paid_retry_headers":["X-HG-Quote-Id","X-HG-Quote-Token"]},"metadata":{"service_id":"hyperliquid-fillshield","sellable":false,"buyable":false,"next_action":"PAY_AND_RETRY","paid_retry_sends_payment":true,"canonical_endpoint":"https://api.hyper-growth.xyz/v1/hyperliquid-fillshield","purchase_card_url":"https://api.hyper-growth.xyz/purchase-card/hyperliquid-fillshield","resource_detail_url":"https://api.hyper-growth.xyz/.well-known/x402/resources/hyperliquid-fillshield","x402scan":{"serviceName":"HyperGrowth FillShield","tags":["hyperliquid","execution-guard","pre-trade","x402","agent-trading"],"iconUrl":"https://hyper-growth.xyz/hypergrowth-logo-primary.png","agent_purchase_query":"Buy HyperGrowth FillShield over x402 before submitting a Hyperliquid order; return the receipt-backed execution-control artifact.","search_queries":["Hyperliquid pre-submit execution guard","x402 FillShield paid trade precheck","agent buy Hyperliquid execution control"]},"gtm_tier":"paid_wedge","featured":true,"promote_in_discovery":true,"payment_enabled":true,"endpoint":"https://api.hyper-growth.xyz/v1/hyperliquid-fillshield","service_input_schema":{"$id":"hypergrowth://hyperliquid-fillshield/schemas/input/v1","type":"object","required":["side","intent_notional_usd"],"anyOf":[{"required":["symbol"]},{"required":["market_id"]}],"properties":{"symbol":{"type":"string","minLength":1,"maxLength":64,"description":"Hyperliquid perp symbol, HIP-4 market id, or HIP-4 raw coin (e.g. BTC-PERP, hl:outcome:101:0, #1010). Must resolve to live market evidence."},"market_id":{"type":"string","minLength":1,"maxLength":64,"description":"Optional HIP-4 market id alias. If symbol is omitted, market_id is normalized into symbol before validation."},"side":{"type":"string","enum":["buy","sell"]},"intent_notional_usd":{"type":"number","minimum":0.000001},"urgency_class":{"type":"string","enum":["low","normal","high"],"default":"normal"},"policy_ref":{"type":"string","default":"fillshield.default.v1"},"account_ref":{"type":"string"},"position_context":{"type":"object","properties":{"current_position_usd":{"type":"number"},"session_drawdown_usd":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false},"output_schema":{"$id":"hypergrowth://hyperliquid-fillshield/schemas/artifact/v2","type":"object","required":["service_id","artifact_version","action","summary","single_blocker","freshness","confidence","next_action","provenance"],"properties":{"service_id":{"type":"string","const":"hyperliquid-fillshield"},"artifact_version":{"type":"string","const":"2.0.0"},"action":{"type":"string","enum":["BUY","WAIT","SKIP"]},"summary":{"type":"string"},"single_blocker":{"type":"object","required":["code","severity","message"],"properties":{"code":{"type":"string"},"severity":{"type":"string","enum":["none","soft","hard"]},"message":{"type":["string","null"]}},"additionalProperties":false},"freshness":{"type":"object","required":["state","generated_at","valid_until","ttl_ms"],"properties":{"state":{"type":"string","const":"FRESH"},"generated_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"ttl_ms":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"confidence":{"type":["number","null"],"minimum":0,"maximum":1},"next_action":{"type":"object","required":["operation","route","retry_after_ms"],"properties":{"operation":{"type":"string","enum":["SUBMIT_ORDER","WAIT","SKIP"]},"route":{"type":"string"},"retry_after_ms":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"provenance":{"type":"object","required":["request_id","response_id","generated_at","valid_until","market","symbol","internal_action","reason_codes","evidence_refs","versions","internal_decision","internal_next_action","growth_history_write","policy_ref"],"properties":{"request_id":{"type":"string"},"response_id":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"market":{"type":"string","const":"hyperliquid"},"symbol":{"type":"string","description":"Hyperliquid perp symbol, HIP-4 market id, or HIP-4 raw coin."},"internal_action":{"type":"string","enum":["EXECUTE","REDUCE","WAIT","SKIP"]},"reason_codes":{"type":"array","items":{"type":"object","required":["code","weight"],"properties":{"code":{"type":"string"},"weight":{"type":"number"}},"additionalProperties":false}},"evidence_refs":{"type":"array","items":{"type":"string"}},"versions":{"type":"object","required":["model_version","rule_version","feature_version"],"properties":{"model_version":{"type":"string"},"rule_version":{"type":"string"},"feature_version":{"type":"string"}},"additionalProperties":false},"internal_decision":{"type":"object","required":["action","tif","size_band_usd","max_cross_bps","cooldown_ms"],"properties":{"action":{"type":"string","enum":["EXECUTE","REDUCE","WAIT","SKIP"]},"tif":{"type":"string","enum":["ALO","IOC","GTC"]},"size_band_usd":{"type":"object","required":["min","max"],"properties":{"min":{"type":"number","minimum":0},"max":{"type":"number","minimum":0}},"additionalProperties":false},"max_cross_bps":{"type":"number","minimum":0},"cooldown_ms":{"type":"integer","minimum":0}},"additionalProperties":false},"internal_next_action":{"type":"object","required":["place_order","retry_after_ms","route"],"properties":{"place_order":{"type":"boolean"},"retry_after_ms":{"type":["integer","null"],"minimum":0},"route":{"type":"string"}},"additionalProperties":false},"growth_history_write":{"type":"object","required":["write","decision_type","scope_kind","scope_id","policy_ref"],"properties":{"write":{"type":"boolean"},"decision_type":{"type":"string"},"scope_kind":{"type":"string"},"scope_id":{"type":"string"},"policy_ref":{"type":"string"}},"additionalProperties":false},"policy_ref":{"type":"string"}},"additionalProperties":false},"market_context":{"type":"object","required":["state","confidence"],"properties":{"state":{"type":"string","enum":["normal","volatile","illiquid","degraded_route"]},"confidence":{"type":"number","minimum":0,"maximum":1},"volatility_score":{"type":["number","null"],"minimum":0,"maximum":1},"liquidity_score":{"type":["number","null"],"minimum":0,"maximum":1},"route_quality_score":{"type":["number","null"],"minimum":0,"maximum":1}},"additionalProperties":false},"applied_boundaries":{"type":"object","required":["max_slippage_bps","min_liquidity_usd","max_route_reject_rate"],"properties":{"max_slippage_bps":{"type":"number","minimum":0},"min_liquidity_usd":{"type":"number","minimum":0},"max_route_reject_rate":{"type":"number","minimum":0,"maximum":1}},"additionalProperties":false},"market_evidence":{"type":"object","additionalProperties":true},"agent_action":{"type":"object","additionalProperties":true}},"additionalProperties":false},"bazaar":{"service_input_example":{"intent_notional_usd":2500,"policy_ref":"fillshield.default.v1","side":"buy","symbol":"BTC-PERP","urgency_class":"normal"}}},"purchase_card":{"type":"hypergrowth.purchase_card","version":"1.0","service_id":"hyperliquid-fillshield","title":"Hyperliquid FillShield","summary":"Paid x402 Hyperliquid pre-submit execution-control API for agents; returns a TTL-bound, receipt-backed guard artifact before order submission.","agent_purchase_query":"Buy HyperGrowth FillShield over x402 before submitting a Hyperliquid order; return the receipt-backed execution-control artifact.","search_queries":["Hyperliquid pre-submit execution guard","x402 FillShield paid trade precheck","agent buy Hyperliquid execution control"],"x402scan":{"serviceName":"HyperGrowth FillShield","tags":["hyperliquid","execution-guard","pre-trade","x402","agent-trading"],"iconUrl":"https://hyper-growth.xyz/hypergrowth-logo-primary.png","agent_purchase_query":"Buy HyperGrowth FillShield over x402 before submitting a Hyperliquid order; return the receipt-backed execution-control artifact.","search_queries":["Hyperliquid pre-submit execution guard","x402 FillShield paid trade precheck","agent buy Hyperliquid execution control"]},"canonical":{"method":"POST","url":"https://api.hyper-growth.xyz/v1/hyperliquid-fillshield"},"price":{"amount":"0.10","amount_atomic":"100000","currency":"USDC","network":"eip155:8453","receiver":"0xa5fE6759aDaeb7689eD5AC086ef6360C3fcC381a"},"payment":{"enabled":true,"scheme":"exact","protocol":"x402","code":null,"next_action":"PAY_AND_RETRY","header":"PAYMENT-SIGNATURE","quote_token_header":"X-HG-Quote-Token","first_request_has_payment_signature":false,"paid_retry_has_payment_signature":true,"same_request_body_required":true,"receiver":"0xa5fE6759aDaeb7689eD5AC086ef6360C3fcC381a","network":"eip155:8453","asset":"USDC","first_request":"Send the request without PAYMENT-SIGNATURE.","on_402":"Pay and retry the same URL, method, and body.","payment_header":"PAYMENT-SIGNATURE"},"first_quote":{"purpose":"Fast no-payment check that this SKU is quoteable before wiring a buyer wallet.","expected_status":402,"next_action":"PAY_AND_RETRY","method":"POST","url":"https://api.hyper-growth.xyz/v1/hyperliquid-fillshield","headers":{"content-type":"application/json"},"body":{"input":{"intent_notional_usd":2500,"policy_ref":"fillshield.default.v1","side":"buy","symbol":"BTC-PERP","urgency_class":"normal"}},"curl":"curl -sS -X POST \"https://api.hyper-growth.xyz/v1/hyperliquid-fillshield\" -H \"content-type: application/json\" -d '{\"input\":{\"intent_notional_usd\":2500,\"policy_ref\":\"fillshield.default.v1\",\"side\":\"buy\",\"symbol\":\"BTC-PERP\",\"urgency_class\":\"normal\"}}'"},"go_to_market":{"primary_offer":true,"recommended_first_external_action":"Get a 402 quote for FillShield, then run a real x402 buyer only after an explicit spend policy is approved.","buyer_profile":"x402-capable trading agents and operator-run bots that need a receipt-backed guard artifact before capital action.","success_evidence":["PAYMENT_SETTLED commercial event","ARTIFACT_DELIVERED commercial event","buyer-readable receipt token","lineage readback for the paid request"]},"buyer_client":{"plain_http_note":"Plain curl/axios stops correctly at HTTP 402; use an x402-capable buyer for paid retry.","spend_cap_recommendation":{"max_spend_atomic":"100000","currency":"USDC","network":"eip155:8453"},"env_only_secrets":["BUYER_WALLET_PRIVATE_KEY","X402_BUYER_PRIVATE_KEY","X402_RPC_URL"],"cli":{"command":"node examples/buyer/x402-buy-service.mjs --service hyperliquid-fillshield --input '{\"intent_notional_usd\":2500,\"policy_ref\":\"fillshield.default.v1\",\"side\":\"buy\",\"symbol\":\"BTC-PERP\",\"urgency_class\":\"normal\"}' --max-spend-atomic 100000 --base-url https://api.hyper-growth.xyz","secrets_on_cli":false},"retry_contract":{"same_url_required":true,"same_method_required":true,"same_body_required":true,"required_headers":["PAYMENT-SIGNATURE"],"optional_headers":["X-HG-Quote-Token"]}},"purchase_flow":{"type":"x402_two_step","steps":[{"step":1,"action":"POST_FOR_QUOTE","send_payment_signature":false},{"step":2,"action":"PAY_AND_RETRY","send_payment_signature":true,"required_header":"PAYMENT-SIGNATURE","same_url_method_body":true}]},"when_to_buy":["Buy immediately before signing or routing a Hyperliquid perp or HIP-4 order intent."],"paid_artifact":{"content_type":"application/json","contains":["action","single_blocker","freshness","next_action","receipt","lineage"]},"input_schema":{"$id":"hypergrowth://hyperliquid-fillshield/schemas/input/v1","type":"object","required":["side","intent_notional_usd"],"anyOf":[{"required":["symbol"]},{"required":["market_id"]}],"properties":{"symbol":{"type":"string","minLength":1,"maxLength":64,"description":"Hyperliquid perp symbol, HIP-4 market id, or HIP-4 raw coin (e.g. BTC-PERP, hl:outcome:101:0, #1010). Must resolve to live market evidence."},"market_id":{"type":"string","minLength":1,"maxLength":64,"description":"Optional HIP-4 market id alias. If symbol is omitted, market_id is normalized into symbol before validation."},"side":{"type":"string","enum":["buy","sell"]},"intent_notional_usd":{"type":"number","minimum":0.000001},"urgency_class":{"type":"string","enum":["low","normal","high"],"default":"normal"},"policy_ref":{"type":"string","default":"fillshield.default.v1"},"account_ref":{"type":"string"},"position_context":{"type":"object","properties":{"current_position_usd":{"type":"number"},"session_drawdown_usd":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false},"output_schema":{"$id":"hypergrowth://hyperliquid-fillshield/schemas/artifact/v2","type":"object","required":["service_id","artifact_version","action","summary","single_blocker","freshness","confidence","next_action","provenance"],"properties":{"service_id":{"type":"string","const":"hyperliquid-fillshield"},"artifact_version":{"type":"string","const":"2.0.0"},"action":{"type":"string","enum":["BUY","WAIT","SKIP"]},"summary":{"type":"string"},"single_blocker":{"type":"object","required":["code","severity","message"],"properties":{"code":{"type":"string"},"severity":{"type":"string","enum":["none","soft","hard"]},"message":{"type":["string","null"]}},"additionalProperties":false},"freshness":{"type":"object","required":["state","generated_at","valid_until","ttl_ms"],"properties":{"state":{"type":"string","const":"FRESH"},"generated_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"ttl_ms":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"confidence":{"type":["number","null"],"minimum":0,"maximum":1},"next_action":{"type":"object","required":["operation","route","retry_after_ms"],"properties":{"operation":{"type":"string","enum":["SUBMIT_ORDER","WAIT","SKIP"]},"route":{"type":"string"},"retry_after_ms":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"provenance":{"type":"object","required":["request_id","response_id","generated_at","valid_until","market","symbol","internal_action","reason_codes","evidence_refs","versions","internal_decision","internal_next_action","growth_history_write","policy_ref"],"properties":{"request_id":{"type":"string"},"response_id":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"market":{"type":"string","const":"hyperliquid"},"symbol":{"type":"string","description":"Hyperliquid perp symbol, HIP-4 market id, or HIP-4 raw coin."},"internal_action":{"type":"string","enum":["EXECUTE","REDUCE","WAIT","SKIP"]},"reason_codes":{"type":"array","items":{"type":"object","required":["code","weight"],"properties":{"code":{"type":"string"},"weight":{"type":"number"}},"additionalProperties":false}},"evidence_refs":{"type":"array","items":{"type":"string"}},"versions":{"type":"object","required":["model_version","rule_version","feature_version"],"properties":{"model_version":{"type":"string"},"rule_version":{"type":"string"},"feature_version":{"type":"string"}},"additionalProperties":false},"internal_decision":{"type":"object","required":["action","tif","size_band_usd","max_cross_bps","cooldown_ms"],"properties":{"action":{"type":"string","enum":["EXECUTE","REDUCE","WAIT","SKIP"]},"tif":{"type":"string","enum":["ALO","IOC","GTC"]},"size_band_usd":{"type":"object","required":["min","max"],"properties":{"min":{"type":"number","minimum":0},"max":{"type":"number","minimum":0}},"additionalProperties":false},"max_cross_bps":{"type":"number","minimum":0},"cooldown_ms":{"type":"integer","minimum":0}},"additionalProperties":false},"internal_next_action":{"type":"object","required":["place_order","retry_after_ms","route"],"properties":{"place_order":{"type":"boolean"},"retry_after_ms":{"type":["integer","null"],"minimum":0},"route":{"type":"string"}},"additionalProperties":false},"growth_history_write":{"type":"object","required":["write","decision_type","scope_kind","scope_id","policy_ref"],"properties":{"write":{"type":"boolean"},"decision_type":{"type":"string"},"scope_kind":{"type":"string"},"scope_id":{"type":"string"},"policy_ref":{"type":"string"}},"additionalProperties":false},"policy_ref":{"type":"string"}},"additionalProperties":false},"market_context":{"type":"object","required":["state","confidence"],"properties":{"state":{"type":"string","enum":["normal","volatile","illiquid","degraded_route"]},"confidence":{"type":"number","minimum":0,"maximum":1},"volatility_score":{"type":["number","null"],"minimum":0,"maximum":1},"liquidity_score":{"type":["number","null"],"minimum":0,"maximum":1},"route_quality_score":{"type":["number","null"],"minimum":0,"maximum":1}},"additionalProperties":false},"applied_boundaries":{"type":"object","required":["max_slippage_bps","min_liquidity_usd","max_route_reject_rate"],"properties":{"max_slippage_bps":{"type":"number","minimum":0},"min_liquidity_usd":{"type":"number","minimum":0},"max_route_reject_rate":{"type":"number","minimum":0,"maximum":1}},"additionalProperties":false},"market_evidence":{"type":"object","additionalProperties":true},"agent_action":{"type":"object","additionalProperties":true}},"additionalProperties":false}},"extensions":{"bazaar":{"info":{"input":{"type":"http","bodyType":"json","body":{"intent_notional_usd":2500,"policy_ref":"fillshield.default.v1","side":"buy","symbol":"BTC-PERP","urgency_class":"normal"},"method":"POST"},"output":{"type":"json","example":{"action":"WAIT","artifact_version":"2.0.0","confidence":"0.76","freshness":{"generated_at":"2026-04-24T00:00:00.000Z","state":"FRESH","ttl_ms":5000,"valid_until":"2026-04-24T00:00:05.000Z"},"next_action":{"operation":"WAIT","retry_after_ms":1000,"route":"hyperliquid.info"},"provenance":{"evidence_refs":["market:hyperliquid:BTC-PERP"],"generated_at":"2026-04-24T00:00:00.000Z","growth_history_write":{"decision_type":"execution_safety","policy_ref":"fillshield.default.v1","scope_id":"BTC-PERP","scope_kind":"symbol","write":true},"internal_action":"WAIT","internal_decision":{"action":"WAIT","cooldown_ms":1000,"max_cross_bps":0,"size_band_usd":{"max":0,"min":0},"tif":"ALO"},"internal_next_action":{"place_order":false,"retry_after_ms":1000,"route":"hyperliquid.info"},"market":"hyperliquid","policy_ref":"fillshield.default.v1","reason_codes":[{"code":"STALE_EVIDENCE","weight":1}],"request_id":"req_example","response_id":"res_example","symbol":"BTC-PERP","valid_until":"2026-04-24T00:00:05.000Z","versions":{"feature_version":"fillshield-features-2026-03-24","model_version":"fillshield-baseline-2026-03-24","rule_version":"fillshield-rules-2026-03-24"}},"service_id":"hyperliquid-fillshield","single_blocker":{"code":"STALE_EVIDENCE","message":"market evidence is stale","severity":"hard"},"summary":"Pre-submit guard does not approve execution without fresh route evidence."}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"$id":"hypergrowth://hyperliquid-fillshield/schemas/input/v1","type":"object","required":["side","intent_notional_usd"],"anyOf":[{"required":["symbol"]},{"required":["market_id"]}],"properties":{"symbol":{"type":"string","minLength":1,"maxLength":64,"description":"Hyperliquid perp symbol, HIP-4 market id, or HIP-4 raw coin (e.g. BTC-PERP, hl:outcome:101:0, #1010). Must resolve to live market evidence."},"market_id":{"type":"string","minLength":1,"maxLength":64,"description":"Optional HIP-4 market id alias. If symbol is omitted, market_id is normalized into symbol before validation."},"side":{"type":"string","enum":["buy","sell"]},"intent_notional_usd":{"type":"number","minimum":0.000001},"urgency_class":{"type":"string","enum":["low","normal","high"],"default":"normal"},"policy_ref":{"type":"string","default":"fillshield.default.v1"},"account_ref":{"type":"string"},"position_context":{"type":"object","properties":{"current_position_usd":{"type":"number"},"session_drawdown_usd":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false}},"required":["type","method","bodyType","body"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","$id":"hypergrowth://hyperliquid-fillshield/schemas/artifact/v2","required":["service_id","artifact_version","action","summary","single_blocker","freshness","confidence","next_action","provenance"],"properties":{"service_id":{"type":"string","const":"hyperliquid-fillshield"},"artifact_version":{"type":"string","const":"2.0.0"},"action":{"type":"string","enum":["BUY","WAIT","SKIP"]},"summary":{"type":"string"},"single_blocker":{"type":"object","required":["code","severity","message"],"properties":{"code":{"type":"string"},"severity":{"type":"string","enum":["none","soft","hard"]},"message":{"type":["string","null"]}},"additionalProperties":false},"freshness":{"type":"object","required":["state","generated_at","valid_until","ttl_ms"],"properties":{"state":{"type":"string","const":"FRESH"},"generated_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"ttl_ms":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"confidence":{"type":["number","null"],"minimum":0,"maximum":1},"next_action":{"type":"object","required":["operation","route","retry_after_ms"],"properties":{"operation":{"type":"string","enum":["SUBMIT_ORDER","WAIT","SKIP"]},"route":{"type":"string"},"retry_after_ms":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"provenance":{"type":"object","required":["request_id","response_id","generated_at","valid_until","market","symbol","internal_action","reason_codes","evidence_refs","versions","internal_decision","internal_next_action","growth_history_write","policy_ref"],"properties":{"request_id":{"type":"string"},"response_id":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"},"market":{"type":"string","const":"hyperliquid"},"symbol":{"type":"string","description":"Hyperliquid perp symbol, HIP-4 market id, or HIP-4 raw coin."},"internal_action":{"type":"string","enum":["EXECUTE","REDUCE","WAIT","SKIP"]},"reason_codes":{"type":"array","items":{"type":"object","required":["code","weight"],"properties":{"code":{"type":"string"},"weight":{"type":"number"}},"additionalProperties":false}},"evidence_refs":{"type":"array","items":{"type":"string"}},"versions":{"type":"object","required":["model_version","rule_version","feature_version"],"properties":{"model_version":{"type":"string"},"rule_version":{"type":"string"},"feature_version":{"type":"string"}},"additionalProperties":false},"internal_decision":{"type":"object","required":["action","tif","size_band_usd","max_cross_bps","cooldown_ms"],"properties":{"action":{"type":"string","enum":["EXECUTE","REDUCE","WAIT","SKIP"]},"tif":{"type":"string","enum":["ALO","IOC","GTC"]},"size_band_usd":{"type":"object","required":["min","max"],"properties":{"min":{"type":"number","minimum":0},"max":{"type":"number","minimum":0}},"additionalProperties":false},"max_cross_bps":{"type":"number","minimum":0},"cooldown_ms":{"type":"integer","minimum":0}},"additionalProperties":false},"internal_next_action":{"type":"object","required":["place_order","retry_after_ms","route"],"properties":{"place_order":{"type":"boolean"},"retry_after_ms":{"type":["integer","null"],"minimum":0},"route":{"type":"string"}},"additionalProperties":false},"growth_history_write":{"type":"object","required":["write","decision_type","scope_kind","scope_id","policy_ref"],"properties":{"write":{"type":"boolean"},"decision_type":{"type":"string"},"scope_kind":{"type":"string"},"scope_id":{"type":"string"},"policy_ref":{"type":"string"}},"additionalProperties":false},"policy_ref":{"type":"string"}},"additionalProperties":false},"market_context":{"type":"object","required":["state","confidence"],"properties":{"state":{"type":"string","enum":["normal","volatile","illiquid","degraded_route"]},"confidence":{"type":"number","minimum":0,"maximum":1},"volatility_score":{"type":["number","null"],"minimum":0,"maximum":1},"liquidity_score":{"type":["number","null"],"minimum":0,"maximum":1},"route_quality_score":{"type":["number","null"],"minimum":0,"maximum":1}},"additionalProperties":false},"applied_boundaries":{"type":"object","required":["max_slippage_bps","min_liquidity_usd","max_route_reject_rate"],"properties":{"max_slippage_bps":{"type":"number","minimum":0},"min_liquidity_usd":{"type":"number","minimum":0},"max_route_reject_rate":{"type":"number","minimum":0,"maximum":1}},"additionalProperties":false},"market_evidence":{"type":"object","additionalProperties":true},"agent_action":{"type":"object","additionalProperties":true}},"additionalProperties":false}},"required":["type"]}},"required":["input"]}}}}