{"openapi":"3.0.3","info":{"title":"Agent Embassy","version":"1.0.0","description":"Agent Embassy lets AI agents pay for work and prove what happened. verified_check ($0.15): fetch a URL, check it against conditions, get a signed Outcome Receipt with the full transcript. register_recovery ($1.00): store a client-encrypted recovery blob, queued for human review. Paid in USDC on Base or Arbitrum One via x402 v2."},"servers":[{"url":"https://agent-embassy.fly.dev"}],"paths":{"/v1/check/verify":{"post":{"summary":"Verified check — fetch a URL and check it against conditions","description":"Paid endpoint ($0.15 USDC on Base or Arbitrum One via x402). Fetches your HTTPS URL once, server-side, evaluates status/body/JSON-path conditions, returns a signed Outcome Receipt with the full transcript.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","idempotency_key"],"properties":{"url":{"type":"string","description":"HTTPS URL to fetch and check"},"expect_status":{"type":"number","description":"Expected HTTP status"},"expect_body_contains":{"type":"string","description":"Substring the body must contain"},"expect_json_path":{"type":"string","description":"Dot-path into a JSON body"},"expect_json_value":{"description":"Expected value at the JSON path"},"idempotency_key":{"type":"string","description":"Client-generated idempotency key"}}}}}},"responses":{"200":{"description":"Signed Outcome Receipt"},"402":{"description":"x402 payment required"}}}},"/v1/recovery/register":{"post":{"summary":"Register recovery — store an encrypted recovery blob","description":"Paid endpoint ($1.00 USDC on Base or Arbitrum One via x402). Stores a client-encrypted recovery blob with quorum rules, queued for human review within 24h.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contact_name","contact_handle","quorum_rules","recovery_blob","idempotency_key"],"properties":{"contact_name":{"type":"string"},"contact_handle":{"type":"string"},"quorum_rules":{"type":"string"},"recovery_blob":{"type":"string","description":"Client-encrypted blob, ENC:v1:..."},"idempotency_key":{"type":"string"}}}}}},"responses":{"200":{"description":"Signed Outcome Receipt"},"402":{"description":"x402 payment required"}}}},"/v1/markets/compute/spot":{"get":{"summary":"Compute spot market — paid snapshot ($0.25)","description":"Paid endpoint ($0.25 USDC on Base or Arbitrum One via x402, GET). Compute market snapshot: cheapest rentable ask per class in USD/hour, observed live. With a gpu query param, returns the cheapest rentable offers for that class; without it, a cheapest-per-class market snapshot. Responses carry prices only — upstream sources are internal and never named. All prices are ephemeral asks, not delivered-cost guarantees.","parameters":[{"name":"gpu","in":"query","required":false,"schema":{"type":"string"},"description":"Class, e.g. 'H100 SXM', 'RTX 4090'. Omit for whole-market snapshot."},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["ondemand","bid","reserved"]},"description":"Pricing mode (default ondemand)"},{"name":"verified","in":"query","required":false,"schema":{"type":"string"},"description":"'true' = identity-checked hosts only"},{"name":"min_gpus","in":"query","required":false,"schema":{"type":"number"},"description":"Minimum unit count per offer"},{"name":"min_reliability","in":"query","required":false,"schema":{"type":"number"},"description":"Minimum host reliability 0..1"},{"name":"max_results","in":"query","required":false,"schema":{"type":"number"},"description":"Max offers returned for a single-class query (default 5, max 25)"}],"responses":{"200":{"description":"Paid market snapshot (prices only, no provenance)"},"402":{"description":"x402 payment required ($0.25 USDC)"},"502":{"description":"Market source unavailable"}}}},"/v1/markets/compute/history":{"post":{"summary":"Compute market history — paid time series ($0.25)","description":"Paid endpoint ($0.25 USDC on Base or Arbitrum One via x402). Time series of compute market prices: per-class cheapest/median/offer-count series, or whole-market history when gpu is omitted. Bounded (limit 1-200, default 50), timestamped, embedded in the signed Outcome Receipt. Fully automated. Prices are ephemeral asks, not delivered-cost guarantees.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["idempotency_key"],"properties":{"gpu":{"type":"string","description":"Class, e.g. 'H100 SXM'. Omit for whole-market history."},"limit":{"type":"number","description":"Max snapshots returned, 1-200 (default 50)"},"idempotency_key":{"type":"string","description":"Client-generated idempotency key"}}}}}},"responses":{"200":{"description":"Signed Outcome Receipt with the history series in action evidence"},"402":{"description":"x402 payment required"}}}},"/v1/markets/compute/alerts":{"post":{"summary":"Compute price alerts — paid ($0.25)","description":"Paid endpoint ($0.25 USDC on Base or Arbitrum One via x402). Recent large per-class price moves, most recent first. Bounded (limit 1-50, default 25), timestamped, embedded in the signed Outcome Receipt. Fully automated. Upstream sources are internal and never named. Prices are ephemeral asks, not delivered-cost guarantees.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["idempotency_key"],"properties":{"gpu":{"type":"string","description":"Class, e.g. 'H100 SXM'. Omit for all classes."},"limit":{"type":"number","description":"Max alerts returned, 1-50 (default 25, most recent first)"},"idempotency_key":{"type":"string","description":"Client-generated idempotency key"}}}}}},"responses":{"200":{"description":"Signed Outcome Receipt with the alert list in action evidence"},"402":{"description":"x402 payment required"}}}},"/terms":{"get":{"summary":"Terms of Service","description":"Public Terms of Service (text/markdown). Using any Embassy endpoint constitutes acceptance. Fees non-refundable once the action runs; maximum liability per receipt is the amount paid; receipts are evidence, not warranties; market data is not financial advice.","responses":{"200":{"description":"TERMS.md as text/markdown"}}}},"/v1/receipts/{receiptId}":{"get":{"summary":"Look up a receipt by ID","parameters":[{"name":"receiptId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public receipt view"},"404":{"description":"Unknown receipt"}}}},"/verify/{receiptId}":{"get":{"summary":"Human-checkable verification page for a receipt","description":"Renders any Outcome Receipt as a human-readable page: verdict, check transcript, settlement, and signature. Sellers link their “Verified by Embassy” badge here.","parameters":[{"name":"receiptId","in":"path","required":true,"schema":{"type":"string","pattern":"^emb_[0-9a-f]{24}$"}}],"responses":{"200":{"description":"Verification page (HTML)"},"400":{"description":"Invalid receipt ID format"},"404":{"description":"Unknown receipt"}}}},"/.well-known/x402.json":{"get":{"summary":"x402 machine-readable discovery document","responses":{"200":{"description":"Discovery document"}}}},"/.well-known/mcp.json":{"get":{"summary":"MCP machine-readable discovery document","responses":{"200":{"description":"MCP discovery document"}}}},"/.well-known/embassy-signer.json":{"get":{"summary":"Receipt signer public key and verification instructions","responses":{"200":{"description":"Signer info"}}}},"/.well-known/oasf.json":{"get":{"summary":"AGNTCY OASF agent descriptor record","responses":{"200":{"description":"OASF record"}}}}}}