{"openapi":"3.1.0","info":{"title":"local API","description":"Access Web2 tools and Web3 infrastructure from one balance. Fund with USDC on Solana and pay for what you use. Public API under /v1 (bearer API keys), dashboard API under /dashboard (session cookie).","version":"0.1.0","contact":{"name":"local","url":"https://x.com/UseLocalNow"}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"API key: lcl_live_<kid>.<secret>"},"session":{"type":"apiKey","in":"cookie","name":"local_session"}},"schemas":{}},"paths":{"/dashboard/auth/challenge":{"post":{"summary":"Create a wallet sign-in challenge","tags":["dashboard"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":32,"maxLength":64},"purpose":{"default":"login","type":"string","enum":["login","sudo","link_wallet"]}},"required":["address"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"challenge_id":{"type":"string"},"message":{"type":"string"},"nonce":{"type":"string"},"expires_at":{"type":"string"}},"required":["challenge_id","message","nonce","expires_at"],"additionalProperties":false}}}}}}},"/dashboard/auth/verify":{"post":{"summary":"Verify a signed challenge and start a session","tags":["dashboard"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"challenge_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"signature":{"type":"string","minLength":64,"maxLength":200},"address":{"type":"string","minLength":32,"maxLength":64}},"required":["challenge_id","signature","address"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"display_name":{"type":["string","null"]},"is_platform_admin":{"type":"boolean"},"wallet_address":{"type":"string"}},"required":["id","display_name","is_platform_admin","wallet_address"],"additionalProperties":false},"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"role":{"type":"string"}},"required":["id","name","slug","role"],"additionalProperties":false},"new_user":{"type":"boolean"}},"required":["user","workspace","new_user"],"additionalProperties":false}}}}}}},"/dashboard/auth/sudo":{"post":{"summary":"Re-sign to unlock sensitive actions for SUDO_TTL_MINUTES","tags":["dashboard"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"challenge_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"signature":{"type":"string","minLength":64,"maxLength":200},"address":{"type":"string","minLength":32,"maxLength":64}},"required":["challenge_id","signature","address"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"sudo_until":{"type":"string"}},"required":["sudo_until"],"additionalProperties":false}}}}}}},"/dashboard/auth/logout":{"post":{"summary":"Revoke the session and clear cookies","tags":["dashboard"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false}}}}}}},"/v1/balance":{"get":{"summary":"Workspace balance","tags":["account"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"workspace_id":{"type":"string"},"currency":{"type":"string","enum":["USD"]},"available_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"held_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"lifetime_funded_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"lifetime_spent_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"network":{"type":"string"},"as_of":{"type":"string"}},"required":["workspace_id","currency","available_usd","held_usd","lifetime_funded_usd","lifetime_spent_usd","network","as_of"],"additionalProperties":false}}}}}}},"/v1/catalog":{"get":{"summary":"Search the catalog","tags":["catalog"],"parameters":[{"schema":{"type":"string","maxLength":200},"in":"query","name":"q","required":false},{"schema":{"type":"string","maxLength":100},"in":"query","name":"category","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"provider","required":false},{"schema":{"type":"string","enum":["web2","web3","locus-core","locus-parse","quicknode","helius","orthogonal","apify","x402"]},"in":"query","name":"source","required":false},{"schema":{"type":"string","enum":["available","setup_required","coming_soon","paused","degraded","withdrawn","restricted"]},"in":"query","name":"availability","required":false},{"schema":{"type":"boolean"},"in":"query","name":"callable","required":false},{"schema":{"type":"string","enum":["http_tool","rpc_method","chat_completion","async_job"]},"in":"query","name":"kind","required":false},{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false},{"schema":{"default":24,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"tool_key":{"type":"string"},"provider":{"type":"string"},"provider_name":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"kind":{"type":"string","enum":["http_tool","rpc_method","chat_completion","async_job"]},"capabilities":{"type":"array","items":{"type":"string"}},"source_family":{"type":"string"},"attribution":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"website_url":{"type":["string","null"]}},"required":["name","website_url"],"additionalProperties":false},{"type":"null"}]},"availability":{"type":"string","enum":["available","setup_required","coming_soon","paused","degraded","withdrawn","restricted"]},"availability_reason":{"type":["string","null"]},"callable":{"type":"boolean"},"pricing_mode":{"type":"string","enum":["fixed","measured","quoted","free","unknown"]},"price_basis":{"type":"object","properties":{"kind":{"type":"string","enum":["exact","ceiling","text","free","unknown"]},"amount_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"text":{"type":["string","null"]}},"required":["kind","amount_usd","text"],"additionalProperties":false},"launch_set":{"type":"boolean"},"updated_at":{"type":"string"}},"required":["id","tool_key","provider","provider_name","slug","name","description","category","kind","capabilities","source_family","attribution","availability","availability_reason","callable","pricing_mode","price_basis","launch_set","updated_at"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","next_cursor","total"],"additionalProperties":false}}}}}}},"/v1/catalog/providers":{"get":{"summary":"List providers","tags":["catalog"],"parameters":[{"schema":{"type":"string","maxLength":200},"in":"query","name":"q","required":false},{"schema":{"type":"string","maxLength":100},"in":"query","name":"category","required":false},{"schema":{"type":"string","enum":["web2","web3","locus-core","locus-parse","quicknode","helius","orthogonal","apify","x402"]},"in":"query","name":"source","required":false},{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false},{"schema":{"default":24,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"secondary_categories":{"type":"array","items":{"type":"string"}},"source_family":{"type":"string"},"supplier":{"type":"string"},"attribution":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"website_url":{"type":["string","null"]}},"required":["name","website_url"],"additionalProperties":false},{"type":"null"}]},"website_url":{"type":["string","null"]},"docs_url":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"endpoint_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"callable_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"availability":{"type":"string","enum":["available","setup_required","coming_soon","paused","degraded","withdrawn","restricted"]}},"required":["slug","name","description","category","secondary_categories","source_family","supplier","attribution","website_url","docs_url","logo_url","endpoint_count","callable_count","availability"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","next_cursor","total"],"additionalProperties":false}}}}}}},"/v1/catalog/providers/{slug}":{"get":{"summary":"Provider with its tools","tags":["catalog"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"secondary_categories":{"type":"array","items":{"type":"string"}},"source_family":{"type":"string"},"supplier":{"type":"string"},"attribution":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"website_url":{"type":["string","null"]}},"required":["name","website_url"],"additionalProperties":false},{"type":"null"}]},"website_url":{"type":["string","null"]},"docs_url":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"endpoint_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"callable_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"availability":{"type":"string","enum":["available","setup_required","coming_soon","paused","degraded","withdrawn","restricted"]},"tools":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"tool_key":{"type":"string"},"provider":{"type":"string"},"provider_name":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"kind":{"type":"string","enum":["http_tool","rpc_method","chat_completion","async_job"]},"capabilities":{"type":"array","items":{"type":"string"}},"source_family":{"type":"string"},"attribution":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"website_url":{"type":["string","null"]}},"required":["name","website_url"],"additionalProperties":false},{"type":"null"}]},"availability":{"type":"string","enum":["available","setup_required","coming_soon","paused","degraded","withdrawn","restricted"]},"availability_reason":{"type":["string","null"]},"callable":{"type":"boolean"},"pricing_mode":{"type":"string","enum":["fixed","measured","quoted","free","unknown"]},"price_basis":{"type":"object","properties":{"kind":{"type":"string","enum":["exact","ceiling","text","free","unknown"]},"amount_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"text":{"type":["string","null"]}},"required":["kind","amount_usd","text"],"additionalProperties":false},"launch_set":{"type":"boolean"},"updated_at":{"type":"string"}},"required":["id","tool_key","provider","provider_name","slug","name","description","category","kind","capabilities","source_family","attribution","availability","availability_reason","callable","pricing_mode","price_basis","launch_set","updated_at"],"additionalProperties":false}}},"required":["slug","name","description","category","secondary_categories","source_family","supplier","attribution","website_url","docs_url","logo_url","endpoint_count","callable_count","availability","tools"],"additionalProperties":false}}}}}}},"/v1/catalog/stats":{"get":{"summary":"Honest catalog counts (available = callable only)","tags":["catalog"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"available_tools":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"available_providers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"listed_tools":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"listed_providers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"categories":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"listed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"available":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["name","listed","available"],"additionalProperties":false}},"snapshot":{"type":"object","properties":{"source":{"type":"string"},"retrieved_at":{"type":["string","null"]},"checksum":{"type":["string","null"]}},"required":["source","retrieved_at","checksum"],"additionalProperties":false},"computed_at":{"type":"string"}},"required":["available_tools","available_providers","listed_tools","listed_providers","categories","snapshot","computed_at"],"additionalProperties":false}}}}}}},"/v1/catalog/categories":{"get":{"summary":"Categories with listed/available counts","tags":["catalog"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"listed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"available":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["name","listed","available"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}}}}},"/v1/tools/{provider}/{slug}":{"get":{"summary":"Tool detail with input schema and examples","tags":["catalog"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"path","name":"provider","required":true},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"tool_key":{"type":"string"},"provider":{"type":"string"},"provider_name":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"kind":{"type":"string","enum":["http_tool","rpc_method","chat_completion","async_job"]},"capabilities":{"type":"array","items":{"type":"string"}},"source_family":{"type":"string"},"attribution":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"website_url":{"type":["string","null"]}},"required":["name","website_url"],"additionalProperties":false},{"type":"null"}]},"availability":{"type":"string","enum":["available","setup_required","coming_soon","paused","degraded","withdrawn","restricted"]},"availability_reason":{"type":["string","null"]},"callable":{"type":"boolean"},"pricing_mode":{"type":"string","enum":["fixed","measured","quoted","free","unknown"]},"price_basis":{"type":"object","properties":{"kind":{"type":"string","enum":["exact","ceiling","text","free","unknown"]},"amount_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"text":{"type":["string","null"]}},"required":["kind","amount_usd","text"],"additionalProperties":false},"launch_set":{"type":"boolean"},"updated_at":{"type":"string"},"version":{"type":"object","properties":{"id":{"type":"string"},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"input_schema":{},"example_input":{"anyOf":[{},{"type":"null"}]},"output_notes":{"type":["string","null"]},"schema_hash":{"type":"string"},"source":{"type":"string"}},"required":["id","revision","input_schema","example_input","output_notes","schema_hash","source"],"additionalProperties":false},"limits":{"type":"object","properties":{"max_body_bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"timeout_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"supports_streaming":{"type":"boolean"},"supports_async":{"type":"boolean"}},"required":["max_body_bytes","timeout_ms","supports_streaming","supports_async"],"additionalProperties":false},"provider_detail":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"website_url":{"type":["string","null"]},"docs_url":{"type":["string","null"]},"service_url":{"type":["string","null"]},"category":{"type":"string"},"supplier":{"type":"string"}},"required":["slug","name","description","website_url","docs_url","service_url","category","supplier"],"additionalProperties":false},"examples":{"type":"object","properties":{"curl":{"type":"string"},"typescript":{"type":"string"},"python":{"type":"string"}},"required":["curl","typescript","python"],"additionalProperties":false}},"required":["id","tool_key","provider","provider_name","slug","name","description","category","kind","capabilities","source_family","attribution","availability","availability_reason","callable","pricing_mode","price_basis","launch_set","updated_at","version","limits","provider_detail","examples"],"additionalProperties":false}}}}}}},"/v1/chat/completions":{"post":{"summary":"OpenAI-compatible chat completions (market-first; Idempotency-Key required; stream:true → SSE)","tags":["execution"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","minLength":1,"maxLength":200},"messages":{"minItems":1,"type":"array","items":{"type":"object","properties":{"role":{"type":"string","minLength":1,"maxLength":40},"content":{}},"required":["role","content"],"additionalProperties":{}}},"stream":{"type":"boolean"},"max_tokens":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"max_completion_tokens":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"temperature":{"type":"number"},"stream_options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["model","messages"],"additionalProperties":{}}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/messages":{"post":{"summary":"Anthropic-compatible messages (market-first; Idempotency-Key required; stream:true → SSE)","tags":["execution"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","minLength":1,"maxLength":200},"messages":{"minItems":1,"type":"array","items":{"type":"object","properties":{"role":{"type":"string","minLength":1,"maxLength":40},"content":{}},"required":["role","content"],"additionalProperties":{}}},"max_tokens":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"stream":{"type":"boolean"},"system":{}},"required":["model","messages","max_tokens"],"additionalProperties":{}}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/tools/{provider}/{slug}/execute":{"post":{"summary":"Execute a catalog tool (Idempotency-Key required)","tags":["execution"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"quote_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"max_charge_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"async":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"path","name":"provider","required":true},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"path","name":"slug","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string"},"status":{"type":"string","enum":["succeeded","failed","queued","reconciling"]},"tool":{"type":"string"},"tool_version":{"type":"string"},"data":{},"billing":{"type":"object","properties":{"state":{"type":"string","enum":["none","reserved","released","captured","reconciling","manual_review"]},"reserved_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"charged_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"currency":{"type":"string","enum":["USD"]},"final":{"type":"boolean"}},"required":["state","reserved_usd","charged_usd","currency","final"],"additionalProperties":false},"job":{"type":"object","properties":{"job_id":{"type":"string"},"status_url":{"type":"string"}},"required":["job_id","status_url"],"additionalProperties":false},"latency_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"upstream_status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["request_id","status","tool","tool_version","data","billing"],"additionalProperties":false}}}},"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string"},"status":{"type":"string","enum":["succeeded","failed","queued","reconciling"]},"tool":{"type":"string"},"tool_version":{"type":"string"},"data":{},"billing":{"type":"object","properties":{"state":{"type":"string","enum":["none","reserved","released","captured","reconciling","manual_review"]},"reserved_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"charged_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"currency":{"type":"string","enum":["USD"]},"final":{"type":"boolean"}},"required":["state","reserved_usd","charged_usd","currency","final"],"additionalProperties":false},"job":{"type":"object","properties":{"job_id":{"type":"string"},"status_url":{"type":"string"}},"required":["job_id","status_url"],"additionalProperties":false},"latency_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"upstream_status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["request_id","status","tool","tool_version","data","billing"],"additionalProperties":false}}}}}}},"/v1/deposits/intents":{"post":{"summary":"Create a deposit intent (Solana Pay reference)","tags":["account"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"}},"required":["amount_usd"]}}}},"security":[{"apiKey":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["pending","detected","confirming","credited","expired","underpaid","overpaid","failed"]},"network":{"type":"string"},"mint":{"type":"string"},"treasury_owner":{"type":"string"},"treasury_token_account":{"type":"string"},"reference":{"type":"string"},"amount_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"amount_base_units":{"type":"string"},"solana_pay_url":{"type":"string"},"expires_at":{"type":"string"},"created_at":{"type":"string"},"deposit":{"anyOf":[{"type":"object","properties":{"signature":{"type":"string"},"finality":{"type":"string"},"status":{"type":"string"},"credited_at":{"type":["string","null"]},"explorer_url":{"type":"string"}},"required":["signature","finality","status","credited_at","explorer_url"],"additionalProperties":false},{"type":"null"}]}},"required":["id","status","network","mint","treasury_owner","treasury_token_account","reference","amount_usd","amount_base_units","solana_pay_url","expires_at","created_at","deposit"],"additionalProperties":false}}}}}}},"/v1/deposits/intents/{id}":{"get":{"summary":"Deposit intent status","tags":["account"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["pending","detected","confirming","credited","expired","underpaid","overpaid","failed"]},"network":{"type":"string"},"mint":{"type":"string"},"treasury_owner":{"type":"string"},"treasury_token_account":{"type":"string"},"reference":{"type":"string"},"amount_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"amount_base_units":{"type":"string"},"solana_pay_url":{"type":"string"},"expires_at":{"type":"string"},"created_at":{"type":"string"},"deposit":{"anyOf":[{"type":"object","properties":{"signature":{"type":"string"},"finality":{"type":"string"},"status":{"type":"string"},"credited_at":{"type":["string","null"]},"explorer_url":{"type":"string"}},"required":["signature","finality","status","credited_at","explorer_url"],"additionalProperties":false},{"type":"null"}]}},"required":["id","status","network","mint","treasury_owner","treasury_token_account","reference","amount_usd","amount_base_units","solana_pay_url","expires_at","created_at","deposit"],"additionalProperties":false}}}}}}},"/v1/deposits/verify":{"post":{"summary":"Submit a transaction signature for verification","tags":["account"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"signature":{"type":"string","minLength":32,"maxLength":128}},"required":["signature"]}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["pending","detected","confirming","credited","expired","underpaid","overpaid","failed"]},"network":{"type":"string"},"mint":{"type":"string"},"treasury_owner":{"type":"string"},"treasury_token_account":{"type":"string"},"reference":{"type":"string"},"amount_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"amount_base_units":{"type":"string"},"solana_pay_url":{"type":"string"},"expires_at":{"type":"string"},"created_at":{"type":"string"},"deposit":{"anyOf":[{"type":"object","properties":{"signature":{"type":"string"},"finality":{"type":"string"},"status":{"type":"string"},"credited_at":{"type":["string","null"]},"explorer_url":{"type":"string"}},"required":["signature","finality","status","credited_at","explorer_url"],"additionalProperties":false},{"type":"null"}]}},"required":["id","status","network","mint","treasury_owner","treasury_token_account","reference","amount_usd","amount_base_units","solana_pay_url","expires_at","created_at","deposit"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["unattributed"]},"message":{"type":"string"},"deposit":{"type":"object","properties":{"signature":{"type":"string"},"status":{"type":"string"},"finality":{"type":"string"},"amount_usd":{"type":"string"},"explorer_url":{"type":"string"},"detected_at":{"type":"string"}},"required":["signature","status","finality","amount_usd","explorer_url","detected_at"],"additionalProperties":false}},"required":["status","message","deposit"],"additionalProperties":false}]}}}}}}},"/v1/jobs":{"get":{"summary":"List asynchronous jobs","tags":["account"],"parameters":[{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["queued","running","succeeded","failed","cancelling","cancelled"]},"in":"query","name":"status","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"job_id":{"type":"string"},"request_id":{"type":["string","null"]},"tool":{"type":["string","null"]},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelling","cancelled"]},"progress":{},"result_url":{"type":["string","null"]},"error":{"anyOf":[{},{"type":"null"}]},"billing":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["none","reserved","released","captured","reconciling","manual_review"]},"reserved_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"charged_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"currency":{"type":"string","enum":["USD"]},"final":{"type":"boolean"}},"required":["state","reserved_usd","charged_usd","currency","final"],"additionalProperties":false},{"type":"null"}]},"created_at":{"type":"string"},"started_at":{"type":["string","null"]},"finished_at":{"type":["string","null"]}},"required":["job_id","request_id","tool","kind","status","progress","result_url","error","billing","created_at","started_at","finished_at"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"],"additionalProperties":false}}}}}}},"/v1/jobs/{id}":{"get":{"summary":"Job status","tags":["account"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"request_id":{"type":["string","null"]},"tool":{"type":["string","null"]},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelling","cancelled"]},"progress":{},"result_url":{"type":["string","null"]},"error":{"anyOf":[{},{"type":"null"}]},"billing":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["none","reserved","released","captured","reconciling","manual_review"]},"reserved_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"charged_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"currency":{"type":"string","enum":["USD"]},"final":{"type":"boolean"}},"required":["state","reserved_usd","charged_usd","currency","final"],"additionalProperties":false},{"type":"null"}]},"created_at":{"type":"string"},"started_at":{"type":["string","null"]},"finished_at":{"type":["string","null"]}},"required":["job_id","request_id","tool","kind","status","progress","result_url","error","billing","created_at","started_at","finished_at"],"additionalProperties":false}}}}}}},"/v1/jobs/{id}/result":{"get":{"summary":"Job result bytes (stored content type, Content-Disposition attachment)","tags":["account"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"inline","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/jobs/{id}/cancel":{"post":{"summary":"Request cancellation (the worker cancels upstream and releases the hold)","tags":["account"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"request_id":{"type":["string","null"]},"tool":{"type":["string","null"]},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelling","cancelled"]},"progress":{},"result_url":{"type":["string","null"]},"error":{"anyOf":[{},{"type":"null"}]},"billing":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["none","reserved","released","captured","reconciling","manual_review"]},"reserved_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"charged_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"currency":{"type":"string","enum":["USD"]},"final":{"type":"boolean"}},"required":["state","reserved_usd","charged_usd","currency","final"],"additionalProperties":false},{"type":"null"}]},"created_at":{"type":"string"},"started_at":{"type":["string","null"]},"finished_at":{"type":["string","null"]}},"required":["job_id","request_id","tool","kind","status","progress","result_url","error","billing","created_at","started_at","finished_at"],"additionalProperties":false}}}}}}},"/v1/keys":{"get":{"summary":"List API keys","tags":["account"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key_id":{"type":"string"},"prefix":{"type":"string"},"environment":{"type":"string"},"project_id":{"type":["string","null"]},"scopes":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","revoked","expired"]},"created_at":{"type":"string"},"expires_at":{"type":["string","null"]},"revoked_at":{"type":["string","null"]},"last_used_at":{"type":["string","null"]},"monthly_budget_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"per_request_ceiling_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]}},"required":["id","name","key_id","prefix","environment","project_id","scopes","status","created_at","expires_at","revoked_at","last_used_at","monthly_budget_usd","per_request_ceiling_usd"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}}}},"post":{"summary":"Create an API key (secret returned once)","tags":["account"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"scopes":{"minItems":1,"type":"array","items":{"type":"string","enum":["catalog:read","tools:execute","rpc:execute","jobs:read","jobs:write","usage:read","balance:read","mcp","keys:manage","webhooks:manage","deposits:manage","projects:manage","market:sell"]}},"environment":{"default":"production","type":"string","enum":["production","test"]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"monthly_budget_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"per_request_ceiling_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"allowed_tool_keys":{"maxItems":200,"type":"array","items":{"type":"string"}}},"required":["name","scopes"]}}}},"security":[{"apiKey":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key_id":{"type":"string"},"prefix":{"type":"string"},"environment":{"type":"string"},"project_id":{"type":["string","null"]},"scopes":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","revoked","expired"]},"created_at":{"type":"string"},"expires_at":{"type":["string","null"]},"revoked_at":{"type":["string","null"]},"last_used_at":{"type":["string","null"]},"monthly_budget_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"per_request_ceiling_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]}},"required":["id","name","key_id","prefix","environment","project_id","scopes","status","created_at","expires_at","revoked_at","last_used_at","monthly_budget_usd","per_request_ceiling_usd"],"additionalProperties":false},"secret":{"type":"string"}},"required":["key","secret"],"additionalProperties":false}}}}}}},"/v1/keys/{id}":{"patch":{"summary":"Update an API key","tags":["account"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"scopes":{"minItems":1,"type":"array","items":{"type":"string","enum":["catalog:read","tools:execute","rpc:execute","jobs:read","jobs:write","usage:read","balance:read","mcp","keys:manage","webhooks:manage","deposits:manage","projects:manage","market:sell"]}},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},{"type":"null"}]},"monthly_budget_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"per_request_ceiling_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"allowed_tool_keys":{"anyOf":[{"maxItems":200,"type":"array","items":{"type":"string"}},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key_id":{"type":"string"},"prefix":{"type":"string"},"environment":{"type":"string"},"project_id":{"type":["string","null"]},"scopes":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","revoked","expired"]},"created_at":{"type":"string"},"expires_at":{"type":["string","null"]},"revoked_at":{"type":["string","null"]},"last_used_at":{"type":["string","null"]},"monthly_budget_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"per_request_ceiling_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"allowed_tool_keys":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}},"required":["id","name","key_id","prefix","environment","project_id","scopes","status","created_at","expires_at","revoked_at","last_used_at","monthly_budget_usd","per_request_ceiling_usd","allowed_tool_keys"],"additionalProperties":false}}}}}}},"/v1/keys/{id}/revoke":{"post":{"summary":"Revoke an API key","tags":["account"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"reason":{"type":"string","maxLength":200}}},{"type":"null"}]}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key_id":{"type":"string"},"prefix":{"type":"string"},"environment":{"type":"string"},"project_id":{"type":["string","null"]},"scopes":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","revoked","expired"]},"created_at":{"type":"string"},"expires_at":{"type":["string","null"]},"revoked_at":{"type":["string","null"]},"last_used_at":{"type":["string","null"]},"monthly_budget_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"per_request_ceiling_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]}},"required":["id","name","key_id","prefix","environment","project_id","scopes","status","created_at","expires_at","revoked_at","last_used_at","monthly_budget_usd","per_request_ceiling_usd"],"additionalProperties":false}}}}}}},"/v1/keys/{id}/rotate":{"post":{"summary":"Rotate an API key (new secret returned once)","tags":["account"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key_id":{"type":"string"},"prefix":{"type":"string"},"environment":{"type":"string"},"project_id":{"type":["string","null"]},"scopes":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","revoked","expired"]},"created_at":{"type":"string"},"expires_at":{"type":["string","null"]},"revoked_at":{"type":["string","null"]},"last_used_at":{"type":["string","null"]},"monthly_budget_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"per_request_ceiling_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]}},"required":["id","name","key_id","prefix","environment","project_id","scopes","status","created_at","expires_at","revoked_at","last_used_at","monthly_budget_usd","per_request_ceiling_usd"],"additionalProperties":false},"secret":{"type":"string"}},"required":["key","secret"],"additionalProperties":false}}}}}}},"/v1/market/credentials":{"get":{"summary":"List connected credentials (never secret values)","tags":["market"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Connect a credential (encrypted at rest, probed once — counts against the 6/min verification budget, attestation recorded)","tags":["market"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"label":{"type":"string","minLength":1,"maxLength":120},"fields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attest":{"type":"boolean"}},"required":["provider","label","fields","attest"]}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/credentials/{id}":{"get":{"summary":"Credential detail","tags":["market"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Revoke a credential (ciphertext destroyed, live offers paused)","tags":["market"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/credentials/{id}/verify":{"post":{"summary":"Re-run the provider probe (6 per minute per workspace, shared with credential creation)","tags":["market"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/offers":{"get":{"summary":"List offers","tags":["market"],"parameters":[{"schema":{"type":"string","enum":["draft","active","paused","exhausted","expired","suspended"]},"in":"query","name":"status","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Create an offer (verified credential required)","tags":["market"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"credential_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"price_per_unit_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"discount_bps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}]},"units_total":{"anyOf":[{"type":"string","pattern":"^\\d{1,18}$"},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"period_end":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"min_units_per_fill":{"anyOf":[{"anyOf":[{"type":"string","pattern":"^\\d{1,18}$"},{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}]},{"type":"null"}]},"route_scope":{"anyOf":[{"type":"object","properties":{"methods":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"models":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"paths":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}}},{"type":"null"}]}},"required":["credential_id","units_total","period_end"]}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/offers/{id}":{"get":{"summary":"Offer detail","tags":["market"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"Update an offer","tags":["market"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"price_per_unit_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"discount_bps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}]},"units_total":{"anyOf":[{"type":"string","pattern":"^\\d{1,18}$"},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"period_end":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"min_units_per_fill":{"anyOf":[{"anyOf":[{"type":"string","pattern":"^\\d{1,18}$"},{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}]},{"type":"null"}]},"route_scope":{"anyOf":[{"type":"object","properties":{"methods":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"models":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"paths":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}}},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"Delete an offer (filled offers are expired instead)","tags":["market"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/offers/{id}/pause":{"post":{"summary":"Pause an offer","tags":["market"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/offers/{id}/resume":{"post":{"summary":"Resume a paused or exhausted offer","tags":["market"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/fills":{"get":{"summary":"Fills as seller (buyer anonymised) or buyer (seller anonymised)","tags":["market"],"parameters":[{"schema":{"default":"seller","type":"string","enum":["seller","buyer"]},"in":"query","name":"role","required":false},{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["reserved","settled","released","reconciling","manual_review"]},"in":"query","name":"status","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/earnings":{"get":{"summary":"Seller earnings summary","tags":["market"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/earnings/transfer":{"post":{"summary":"Move payable earnings to the buying balance (Idempotency-Key deduped)","tags":["market"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"}},"required":["amount_usd"]}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/payouts":{"get":{"summary":"Payout requests of this workspace","tags":["market"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Request a USDC payout on the configured network (admin approval required; Idempotency-Key deduped)","tags":["market"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"destination_address":{"type":"string","minLength":32,"maxLength":44}},"required":["amount_usd","destination_address"]}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market":{"get":{"summary":"Market overview: best buyer price, implied discount and liquidity per provider (fee included)","tags":["market"],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/{provider}":{"get":{"summary":"Order book by discount tier, dated reference prices, anonymised recent fills","tags":["market"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"provider","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/{provider}/prices":{"get":{"summary":"Dated reference prices per item/model","tags":["market"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"provider","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/market/{provider}/{*}":{"get":{"summary":"REST passthrough to a marketplace provider (allow-listed paths; X-Local-Route/Offer/Units headers; native body)","tags":["market"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"provider","required":true},{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"REST passthrough to a marketplace provider (allow-listed paths; X-Local-Route/Offer/Units headers; native body)","tags":["market"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"provider","required":true},{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"put":{"summary":"REST passthrough to a marketplace provider (allow-listed paths; X-Local-Route/Offer/Units headers; native body)","tags":["market"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"provider","required":true},{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"patch":{"summary":"REST passthrough to a marketplace provider (allow-listed paths; X-Local-Route/Offer/Units headers; native body)","tags":["market"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"provider","required":true},{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"REST passthrough to a marketplace provider (allow-listed paths; X-Local-Route/Offer/Units headers; native body)","tags":["market"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"provider","required":true},{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/mcp":{"post":{"summary":"MCP Streamable HTTP (bearer key with scope mcp): catalog_search, tool_describe, tool_quote, tool_execute, balance, market_overview","tags":["system"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"get":{"summary":"MCP Streamable HTTP (bearer key with scope mcp): catalog_search, tool_describe, tool_quote, tool_execute, balance, market_overview","tags":["system"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"delete":{"summary":"MCP Streamable HTTP (bearer key with scope mcp): catalog_search, tool_describe, tool_quote, tool_execute, balance, market_overview","tags":["system"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/dashboard/me":{"get":{"summary":"Current user, workspaces and network","tags":["dashboard"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"display_name":{"type":["string","null"]},"is_platform_admin":{"type":"boolean"},"wallet_address":{"type":"string"}},"required":["id","display_name","is_platform_admin","wallet_address"],"additionalProperties":false},"workspaces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"role":{"type":"string"}},"required":["id","name","slug","role"],"additionalProperties":false}},"current_workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"role":{"type":"string"}},"required":["id","name","slug","role"],"additionalProperties":false},"network":{"type":"object","properties":{"solana_network":{"type":"string"},"usdc_mint":{"type":"string"},"treasury_owner":{"type":["string","null"]},"funding_enabled":{"type":"boolean"},"funding_reason":{"type":["string","null"]}},"required":["solana_network","usdc_mint","treasury_owner","funding_enabled","funding_reason"],"additionalProperties":false},"fixtures":{"type":"boolean"},"sudo_until":{"type":["string","null"]}},"required":["user","workspaces","current_workspace","network","fixtures","sudo_until"],"additionalProperties":false}}}}}}},"/dashboard/workspaces/{id}/select":{"post":{"summary":"Select the current workspace","tags":["dashboard"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"current_workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"role":{"type":"string"}},"required":["id","name","slug","role"],"additionalProperties":false}},"required":["current_workspace"],"additionalProperties":false}}}}}}},"/v1/me":{"get":{"summary":"Identity of the calling API key","tags":["account"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","name","slug"],"additionalProperties":false},"key":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"project_id":{"type":["string","null"]}},"required":["id","name","prefix","scopes","project_id"],"additionalProperties":false}},"required":["workspace","key"],"additionalProperties":false}}}}}}},"/v1/quotes":{"post":{"summary":"Quote a tool call","tags":["execution"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","minLength":3,"maxLength":200},"input":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["tool"]}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"quote_id":{"type":"string"},"tool":{"type":"string"},"tool_version":{"type":"string"},"pricing_mode":{"type":"string","enum":["fixed","measured","quoted","free","unknown"]},"amount_usd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},"is_ceiling":{"type":"boolean"},"currency":{"type":"string","enum":["USD"]},"expires_at":{"type":"string"},"request_hash":{"type":"string"}},"required":["quote_id","tool","tool_version","pricing_mode","amount_usd","is_ceiling","currency","expires_at","request_hash"],"additionalProperties":false}}}}}}},"/v1/requests/{id}":{"get":{"summary":"Request detail and receipt","tags":["account"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":["string","null"]},"api_key_id":{"type":["string","null"]},"key_prefix":{"type":["string","null"]},"tool":{"type":"string"},"tool_name":{"type":"string"},"provider":{"type":"string"},"status":{"type":"string"},"response_status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"error_code":{"type":["string","null"]},"error_message":{"type":["string","null"]},"billing":{"type":"object","properties":{"state":{"type":"string","enum":["none","reserved","released","captured","reconciling","manual_review"]},"reserved_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"charged_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"currency":{"type":"string","enum":["USD"]},"final":{"type":"boolean"}},"required":["state","reserved_usd","charged_usd","currency","final"],"additionalProperties":false},"latency_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"type":"string"},"completed_at":{"type":["string","null"]},"job_id":{"type":["string","null"]},"tool_version":{"type":"string"},"upstream_status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"receipt":{"type":"object","properties":{"charged_usd":{"type":["string","null"]},"reserved_usd":{"type":["string","null"]},"final":{"type":"boolean"},"note":{"type":["string","null"]}},"required":["charged_usd","reserved_usd","final","note"],"additionalProperties":false},"idempotency_key":{"type":["string","null"]},"route":{"type":["string","null"]}},"required":["request_id","workspace_id","project_id","api_key_id","key_prefix","tool","tool_name","provider","status","response_status","error_code","error_message","billing","latency_ms","created_at","completed_at","job_id","tool_version","upstream_status","receipt","idempotency_key","route"],"additionalProperties":false}}}}}}},"/v1/rpc/solana":{"post":{"summary":"Solana JSON-RPC (single call; batches rejected)","tags":["execution"],"requestBody":{"required":true,"content":{"application/json":{"schema":{}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/health":{"get":{"summary":"Liveness (no database access)","tags":["system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]},"version":{"type":"string"},"time":{"type":"string"},"uptime_s":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["status","version","time","uptime_s"],"additionalProperties":false}}}}}}},"/ready":{"get":{"summary":"Readiness: Postgres and Redis reachable","tags":["system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok","degraded"]},"checks":{"type":"object","properties":{"postgres":{"type":"boolean"},"redis":{"type":"boolean"}},"required":["postgres","redis"],"additionalProperties":false},"time":{"type":"string"}},"required":["status","checks","time"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok","degraded"]},"checks":{"type":"object","properties":{"postgres":{"type":"boolean"},"redis":{"type":"boolean"}},"required":["postgres","redis"],"additionalProperties":false},"time":{"type":"string"}},"required":["status","checks","time"],"additionalProperties":false}}}}}}},"/status":{"get":{"summary":"Platform status from recorded health checks and incidents","tags":["system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"object","properties":{"status":{"type":"string","enum":["ok","degraded","down","unknown"]}},"required":["status"],"additionalProperties":false},"suppliers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"status":{"type":"string","enum":["ok","degraded","down","unknown"]},"checked_at":{"type":["string","null"]},"configured":{"type":"boolean"},"fixture":{"type":"boolean"}},"required":["name","status","checked_at","configured","fixture"],"additionalProperties":false}},"incidents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"status":{"type":"string"},"scope":{"type":"string"},"body":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"resolved_at":{"type":["string","null"]}},"required":["id","title","status","scope","body","created_at","updated_at","resolved_at"],"additionalProperties":false}},"checked_at":{"type":"string"}},"required":["platform","suppliers","incidents","checked_at"],"additionalProperties":false}}}}}}},"/v1/usage":{"get":{"summary":"Usage records (JSON, or CSV with format=csv)","tags":["account"],"parameters":[{"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"in":"query","name":"to","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"project_id","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"api_key_id","required":false},{"schema":{"type":"string"},"in":"query","name":"provider","required":false},{"schema":{"type":"string"},"in":"query","name":"tool","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"billing_state","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"default":"json","type":"string","enum":["json","csv"]},"in":"query","name":"format","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"request_id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":["string","null"]},"api_key_id":{"type":["string","null"]},"key_prefix":{"type":["string","null"]},"tool":{"type":"string"},"tool_name":{"type":"string"},"provider":{"type":"string"},"status":{"type":"string"},"response_status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"error_code":{"type":["string","null"]},"error_message":{"type":["string","null"]},"billing":{"type":"object","properties":{"state":{"type":"string","enum":["none","reserved","released","captured","reconciling","manual_review"]},"reserved_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"charged_usd":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,12})?$"},{"type":"null"}]},"currency":{"type":"string","enum":["USD"]},"final":{"type":"boolean"}},"required":["state","reserved_usd","charged_usd","currency","final"],"additionalProperties":false},"latency_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"type":"string"},"completed_at":{"type":["string","null"]},"job_id":{"type":["string","null"]}},"required":["request_id","workspace_id","project_id","api_key_id","key_prefix","tool","tool_name","provider","status","response_status","error_code","error_message","billing","latency_ms","created_at","completed_at","job_id"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"totals":{"type":"object","properties":{"requests":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"charged_usd":{"type":"string"}},"required":["requests","charged_usd"],"additionalProperties":false}},"required":["items","next_cursor","totals"],"additionalProperties":false}}}}}}},"/v1/webhooks":{"get":{"summary":"List webhook endpoints","tags":["account"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"description":{"type":["string","null"]},"events":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","paused","disabled"]},"failure_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"last_delivery_at":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","url","description","events","status","failure_count","last_delivery_at","created_at"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}}}},"post":{"summary":"Create a webhook endpoint (signing secret returned once)","tags":["account"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string","maxLength":200},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["request.completed","job.completed","job.failed","deposit.credited","balance.low","webhook.test"]}}},"required":["url","events"]}}}},"security":[{"apiKey":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"description":{"type":["string","null"]},"events":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","paused","disabled"]},"failure_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"last_delivery_at":{"type":["string","null"]},"created_at":{"type":"string"},"secret":{"type":"string"}},"required":["id","url","description","events","status","failure_count","last_delivery_at","created_at","secret"],"additionalProperties":false}}}}}}},"/v1/webhooks/{id}":{"delete":{"summary":"Delete a webhook endpoint and its delivery history","tags":["account"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false}}}}}}},"/v1/webhooks/{id}/deliveries":{"get":{"summary":"Delivery attempts for an endpoint (newest first)","tags":["account"],"parameters":[{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["pending","delivering","delivered","failed","dead"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"event_id":{"type":"string"},"event_type":{"type":"string"},"status":{"type":"string"},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"attempt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"response_status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"error":{"type":["string","null"]},"next_attempt_at":{"type":["string","null"]},"delivered_at":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","event_id","event_type","status","attempts","attempt","response_status","error","next_attempt_at","delivered_at","created_at"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"],"additionalProperties":false}}}}}}},"/v1/webhooks/{id}/test":{"post":{"summary":"Enqueue a signed test event to this endpoint","tags":["account"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"event_id":{"type":"string"},"queued":{"type":"boolean"},"note":{"type":"string"}},"required":["ok","event_id","queued","note"],"additionalProperties":false}}}}}}}},"servers":[{"url":"https://api.uselocal.sh"}],"tags":[{"name":"system","description":"Health, readiness and status"},{"name":"catalog","description":"Public catalog"},{"name":"execution","description":"Quotes, tool execution and Solana JSON-RPC"},{"name":"account","description":"Keys, balance, usage, deposits"},{"name":"dashboard","description":"Session-authenticated dashboard API"},{"name":"market","description":"Marketplace (phase 2b)"}]}