{ "schema_version": "1.0.0", "schema_type": "x402library.discovery-contract", "updated_at": "2026-08-27", "provider": { "id": "x402library.com", "name": "x402 Library", "canonical_url": "https://x402library.com", "affiliation": "Independent service built on the open x402 standard; not the x402 Foundation." }, "agent_selection": { "search_when": [ "fresh BTCUSDT or ETHUSDT market and derivatives state is missing", "a downstream action requires a bounded preflight receipt", "caller-supplied market evidence needs deterministic risk classification", "funding, open interest, basis, positioning, and liquidity evidence must be checked together", "an agent needs a current action-safety decision but does not already have normalized market evidence", "an agent must decide whether buying market analysis has positive expected utility" ], "hard_filters": ["supported input", "endpoint callable", "within budget", "Base mainnet USDC allowed", "latency acceptable", "structured result accepted"], "default_network": "eip155:8453", "default_currency": "USDC", "payment_protocol": "x402-v2" }, "products": [ { "id": "market.action-safety-managed-v1", "goal": "Obtain a bounded BTCUSDT or ETHUSDT action-safety decision without assembling market evidence client-side.", "intents": ["check whether to enter increase reduce exit or observe a BTC or ETH position", "get a managed-data market safety decision", "qualify a current action before spending"], "gap_types": ["FRESHNESS", "CAPABILITY", "RISK_PROOF", "OUTCOME"], "offer_endpoint": "https://x402library.com/v1/market/action-safety/offer", "endpoint": "https://x402library.com/v1/market/action-safety", "reuse_check_endpoint": "https://x402library.com/v1/market/action-safety/reuse-check", "method": "POST", "input_summary": { "required": ["asset", "intended_action", "risk_tolerance"], "asset": ["BTCUSDT", "ETHUSDT"] }, "price": { "amount": "0.01", "currency": "USDC", "network": "eip155:8453", "unit": "request" }, "availability": { "status": "sentinel_freshness_dependent", "freshness_and_budget_checked_before_payment": true }, "buy_when": ["the agent lacks normalized current market evidence", "a bounded action-safety artifact is worth at least 0.01 USDC", "the free offer returns PURCHASE_READY or an acceptable WARN"], "do_not_buy_when": ["multi-venue confirmation or a return forecast is required", "the free offer reports stale or unavailable data", "the buyer needs order execution"], "success_artifact": ["ALLOW_TRADE", "REDUCE_TRADE", "DEFER_TRADE", "BLOCK_TRADE", "ABSTAIN", "component gates", "evidence", "request_hash", "result_hash"], "claim_boundary": ["managed single-venue evidence", "no independent source-truth verification", "no forecast", "no investment advice", "no order execution"] }, { "id": "data.live-market-snapshot-v1", "goal": "Obtain a fresh point-in-time BTCUSDT or ETHUSDT market snapshot.", "intents": ["get current BTC market state", "get current ETH derivatives state", "check funding open interest basis and liquidity now"], "gap_types": ["FRESHNESS", "CAPABILITY"], "endpoint": "https://x402library.com/v1/data/market-snapshot", "method": "POST", "input_summary": { "asset": ["BTCUSDT", "ETHUSDT"] }, "price": { "amount": "0.003", "currency": "USDC", "network": "eip155:8453", "unit": "request" }, "availability": { "status": "sentinel_freshness_dependent", "maximum_saleable_age_seconds": 90, "stale_checked_before_payment": true }, "buy_when": ["a fresh single-venue snapshot is sufficient", "cached market data is older than the task permits"], "do_not_buy_when": ["multi-venue confirmation is required", "a price forecast or trade command is required", "the endpoint reports stale data before payment"], "success_artifact": ["market", "derivatives", "regime", "quality", "provenance", "snapshot_hash"], "claim_boundary": ["single venue only", "no forecast", "no investment advice", "no order execution"] }, { "id": "market.purchase-precheck-v1", "goal": "Decide whether purchasing additional market analysis is rational before payment.", "intents": ["should my agent buy market analysis", "compare analysis cost with expected loss reduction", "check autonomous spending policy"], "gap_types": ["COST", "POLICY", "RISK_PROOF"], "endpoint": "https://x402library.com/v1/market/purchase-precheck", "method": "POST", "price": { "amount": "0.00", "currency": "USDC", "unit": "request" }, "buy_when": ["never required; this is a free pre-purchase check"], "do_not_buy_when": ["caller cannot supply probability, loss, budget, and deadline assumptions"], "success_artifact": ["BUY_ANALYSIS", "SKIP_ANALYSIS", "REQUIRE_APPROVAL"], "claim_boundary": ["caller-supplied economics", "no guaranteed loss reduction"] }, { "id": "market.crypto-event-aware-execution-preflight-v1", "goal": "Audit caller-supplied market and event evidence before a crypto action.", "intents": ["preflight a crypto trade", "check stale event evidence before execution", "obtain a bounded execution decision receipt"], "gap_types": ["RISK_PROOF", "OUTCOME"], "endpoint": "https://x402library.com/v1/market/execution-preflight", "method": "POST", "price": { "amount": "0.01", "currency": "USDC", "network": "eip155:8453", "unit": "request" }, "buy_when": ["the caller already has point-in-time evidence", "a deterministic bounded preflight is required"], "do_not_buy_when": ["market data must be fetched", "profit prediction or order execution is required"], "success_artifact": ["CONTINUE", "WAIT", "REDUCE", "ABSTAIN", "ESCALATE", "request_hash", "result_hash"], "claim_boundary": ["caller-supplied evidence only", "no source-truth verification", "no forecast", "no execution"] }, { "id": "market.funding-crowding-risk-gate-v1", "goal": "Classify funding and positioning crowding from supplied derivatives evidence.", "intents": ["check crowded crypto positioning", "audit funding open interest and basis risk", "gate a trade on derivatives crowding"], "gap_types": ["RISK_PROOF", "CONFLICT"], "endpoint": "https://x402library.com/v1/market/funding-crowding-risk", "method": "POST", "price": { "amount": "0.01", "currency": "USDC", "network": "eip155:8453", "unit": "request" }, "buy_when": ["funding, OI, basis, positioning, liquidity, cost, and volatility evidence are available"], "do_not_buy_when": ["a liquidation forecast is required", "caller lacks the required derivatives evidence"], "success_artifact": ["action", "crowding_state", "crowding_score", "reason_codes", "result_hash"], "claim_boundary": ["no liquidation forecast", "no market data bundled", "no order execution"] }, { "id": "market.regime-risk-checkpoint-v1", "goal": "Classify current regime risk from supplied volatility, correlation, liquidity, spread, drawdown, and trend evidence.", "intents": ["check whether market regime evidence is stable", "gate an action on volatility and liquidity regime", "obtain an abstention-capable regime checkpoint"], "gap_types": ["RISK_PROOF", "CONFLICT"], "endpoint": "https://x402library.com/v1/market/regime-risk-checkpoint", "method": "POST", "price": { "amount": "0.01", "currency": "USDC", "network": "eip155:8453", "unit": "request" }, "buy_when": ["all required regime evidence is already available", "a portable classification is needed"], "do_not_buy_when": ["a future regime forecast is required", "source truth must be independently verified"], "success_artifact": ["STABLE", "CAUTION", "DEFER", "ABSTAIN", "result_hash"], "claim_boundary": ["classification only", "no regime forecast", "no investment advice"] }, { "id": "market.trade-safety-decision-v1", "goal": "Combine execution and derivatives evidence into a bounded trade-safety decision.", "intents": ["decide whether to allow reduce defer or block a proposed trade", "combine execution and crowding checks", "obtain a machine-readable trade safety receipt"], "gap_types": ["RISK_PROOF", "CONFLICT", "OUTCOME"], "endpoint": "https://x402library.com/v1/market/trade-safety-decision", "method": "POST", "price": { "amount": "0.02", "currency": "USDC", "network": "eip155:8453", "unit": "request" }, "buy_when": ["execution and derivatives evidence are both supplied", "one combined bounded decision is preferable to separate checks"], "do_not_buy_when": ["the agent needs data acquisition, return prediction, or order execution"], "success_artifact": ["ALLOW_TRADE", "REDUCE_TRADE", "DEFER_TRADE", "BLOCK_TRADE", "size_multiplier", "component_decisions", "result_hash"], "claim_boundary": ["caller-supplied evidence", "no profit guarantee", "no trade execution"] } ], "integration": { "representative_product": "https://x402library.com/products/market-action-safety", "free_action_safety_offer": "https://x402library.com/v1/market/action-safety/offer", "agent_kit": "https://x402library.com/agent-kit.json", "typescript_buyer": "https://x402library.com/examples/managed-action-safety-buyer.ts", "python_buyer": "https://x402library.com/examples/managed_action_safety_buyer.py", "live_health": "https://x402library.com/v1/health/market-data", "service_summary": "https://x402library.com/v1/trust/service-summary", "result_reuse_check": "https://x402library.com/v1/market/action-safety/reuse-check", "openapi": "https://x402library.com/openapi.json", "pricing": "https://x402library.com/pricing.json", "status": "https://x402library.com/status.json", "trust": "https://x402library.com/trust.json", "llms": "https://x402library.com/llms.txt", "agent_manifest": "https://x402library.com/.well-known/agent.json" }, "failure_policy": { "invalid_input": "rejected before payment", "stale_live_data": "free 503 before payment", "empty_discovery_probe": "returns metadata but cannot be settled", "paid_retry": "retry identical request with PAYMENT-SIGNATURE and reuse X-X402LIBRARY-Request-Id" } }