{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Lykia API","version":"0.1.0","summary":"Agents and stablecoins on Arc Network through one API, from a one-line quote to enterprise payouts.","description":"Built on Arc Network and Circle's rails. Plan money moves in plain words, check them against a Fence, hand unsigned steps to the user's wallet and follow them to finality. The server never holds user keys; intents come back unsigned. Optional server signers (a gas-only keeper, opt-in Circle developer-controlled wallets) are off unless the operator configures them.\n\nAuthenticate with `Lykia-Key` (lk_live_… or lk_test_…; test keys only reach testnet) or a `Lykia-Session` from wallet sign-in. Pin behaviour with `Lykia-Version` (2026-06-01, 2026-11-01). Send `Idempotency-Key` on POSTs. Every answer carries `X-Request-Id`; every error is `{ error: { code, message, details?, requestId } }`.","contact":{"name":"Lykia","url":"https://lykiaai.com"},"license":{"name":"MIT","identifier":"MIT"}},"servers":[{"url":"https://api.lykiaai.com"}],"security":[{},{"LykiaKey":[]},{"LykiaSession":[]}],"tags":[{"name":"AI routing"},{"name":"Admin"},{"name":"Agent"},{"name":"Agents"},{"name":"Aggregator"},{"name":"Alerts"},{"name":"Arc"},{"name":"Auth","description":"Sign in with your wallet (SIWE on Arc) for a session token."},{"name":"Automations"},{"name":"Autopilot"},{"name":"Billing","description":"Plans, usage and credits for API usage."},{"name":"Circle"},{"name":"Consent"},{"name":"Contracts"},{"name":"Data"},{"name":"Developers","description":"Developer profile, keys and settings."},{"name":"Discover"},{"name":"Ecosystem"},{"name":"Events","description":"The event feed behind webhooks."},{"name":"Fence","description":"The rule book around an agent or an owner."},{"name":"Flock"},{"name":"Fold"},{"name":"Integrations"},{"name":"Intents","description":"Plan an outcome, prepare unsigned steps, submit hashes. The server never signs."},{"name":"Invoices"},{"name":"Jobs"},{"name":"Keys","description":"API keys: live and test, scopes, rotation, IP allowlists and limits."},{"name":"Knowledge"},{"name":"Language"},{"name":"League"},{"name":"Leashes"},{"name":"Logs","description":"Request logs per key and project."},{"name":"MCP"},{"name":"Orders"},{"name":"Pack"},{"name":"Payouts"},{"name":"Personal"},{"name":"Platform","description":"The API itself: this document, the reference, versions and the event catalogue."},{"name":"Projects","description":"White-label projects: brand, origins, keys and limits."},{"name":"Routes"},{"name":"Scent"},{"name":"Security"},{"name":"Standing"},{"name":"System"},{"name":"Tags"},{"name":"Telegram"},{"name":"Verdicts"},{"name":"Webhooks","description":"Signed webhooks: endpoints, the event catalogue, deliveries, replays and test events."},{"name":"x402","description":"Pay per call in USDC on Arc."}],"paths":{"/v1/admin/circle/entity-secret":{"post":{"operationId":"postAdminCircleEntitySecret","summary":"Register the Circle entity secret","tags":["Admin"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/admin/deployments":{"get":{"operationId":"getAdminDeployments","summary":"Recorded deployments","tags":["Admin"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postAdminDeployments","summary":"Record a deployment after checking it on chain","tags":["Admin"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/admin/flags":{"get":{"operationId":"getAdminFlags","summary":"Feature flags","tags":["Admin"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"put":{"operationId":"putAdminFlags","summary":"Set feature flags","tags":["Admin"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/admin/overview":{"get":{"operationId":"getAdminOverview","summary":"Operator overview","tags":["Admin"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/admin/ownership":{"get":{"operationId":"getAdminOwnership","summary":"Unsigned ownership-hardening calls (Safe + timelock)","tags":["Admin"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/admin/router":{"get":{"operationId":"getAdminRouter","summary":"Router allowlist","tags":["Admin"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/agent/automations":{"get":{"operationId":"getAgentAutomations","summary":"Agent automations (the owner's session or a secret key with the agents scope)","tags":["Agent"],"parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postAgentAutomations","summary":"Create an automation","tags":["Agent"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/agent/automations/{id}/disable":{"post":{"operationId":"postAgentAutomationsByIdDisable","summary":"Disable an automation","tags":["Agent"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/agent/automations/{id}/enable":{"post":{"operationId":"postAgentAutomationsByIdEnable","summary":"Enable an automation","tags":["Agent"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/agent/automations/run":{"post":{"operationId":"postAgentAutomationsRun","summary":"Run due automations now","tags":["Agent"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/agent/chat":{"post":{"operationId":"postAgentChat","summary":"Chat with Lyko (server-sent events)","description":"Streams Server-Sent Events: thread, notice, reading, task, tool, step (one step of Lyko at work: sent with state running when it starts and again with the same id, ok, warn or fail, the result and the measured ms when it ends), block (a typed answer card built from server data: gas, fence, balance, rate, herded or settled; the text stays the fallback), thinking-summary, proposal, clarify, draft, program, text, error and done. Send Accept: application/json to get the same events collected in one JSON document.","tags":["Agent"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":4000},"messages":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string","enum":["user","assistant"]},"content":{"type":"string","minLength":1,"maxLength":4000}},"required":["role","content"]},"minItems":1,"maxItems":30},"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"environment":{"type":"string","enum":["mainnet","testnet"]},"threadId":{"type":"string","maxLength":120},"fence":{},"origin":{"type":"string","enum":["ask","fold"]},"context":{"type":"string","maxLength":1000},"locale":{"type":"string","enum":["en","tr","es","pt-BR","zh-CN","fr"],"description":"The interface language Lyko answers in (overrides Accept-Language). Input may be in any language."}}}}}}}},"/v1/agent/check":{"post":{"operationId":"postAgentCheck","summary":"Check a proposed agent move","tags":["Agent"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/agent/insights":{"get":{"operationId":"getAgentInsights","summary":"Insights about an owner's Flock","tags":["Agent"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/agent/threads":{"get":{"operationId":"getAgentThreads","summary":"Conversation threads (the owner's session or a secret key with the agents scope)","tags":["Agent"],"parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postAgentThreads","summary":"Start a thread","tags":["Agent"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/agent/threads/{id}":{"get":{"operationId":"getAgentThreadsById","summary":"One thread","tags":["Agent"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/agent/instructions":{"get":{"operationId":"getAgentInstructions","summary":"The owner's hand-offs between Lyko on watch and Ask Lyko (plans and watch tasks), newest first; plan statuses follow their plans","tags":["Agents"],"parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"name":"to","in":"query","required":false,"schema":{"type":"string","enum":["watch","ask"]}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["plan","watch"]}},{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":20}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"instructions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"environment":{"type":"string"},"from":{"type":"string","enum":["watch","ask"]},"to":{"type":"string","enum":["watch","ask"]},"kind":{"type":"string","enum":["plan","watch"]},"payload":{"type":"object","additionalProperties":{},"description":"plan: sentence, title, reason, insightId, intentId. watch: condition, label, fired, lastFiredAt, observation."},"status":{"type":"string","description":"plan: pending, planned, signed, done, refused, stopped. watch: active, paused, removed."},"threadId":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","owner","environment","from","to","kind","payload","status","threadId","createdAt","updatedAt"]}}},"required":["instructions"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postAgentInstructions","summary":"Hand work to the other agent: a plan from an insight (Lyko on watch to Ask Lyko, planned under the owner's Fence as a staged plan and written to the shared thread), or a watch task (Ask Lyko to Lyko on watch) from a condition or from a settled plan","tags":["Agents"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"instruction":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"environment":{"type":"string"},"from":{"type":"string","enum":["watch","ask"]},"to":{"type":"string","enum":["watch","ask"]},"kind":{"type":"string","enum":["plan","watch"]},"payload":{"type":"object","additionalProperties":{},"description":"plan: sentence, title, reason, insightId, intentId. watch: condition, label, fired, lastFiredAt, observation."},"status":{"type":"string","description":"plan: pending, planned, signed, done, refused, stopped. watch: active, paused, removed."},"threadId":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","owner","environment","from","to","kind","payload","status","threadId","createdAt","updatedAt"]},"proposal":{"type":"object","additionalProperties":{}},"threadId":{"type":"string"}},"required":["instruction"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"kind":{"const":"plan"},"from":{"type":"string","enum":["watch","ask"]},"to":{"type":"string","enum":["watch","ask"]},"insightId":{"type":"string","minLength":2,"maxLength":120},"threadId":{"type":"string","maxLength":120},"fence":{}},"required":["owner","kind","from","to","insightId"]},{"type":"object","properties":{"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"kind":{"const":"watch"},"from":{"type":"string","enum":["watch","ask"]},"to":{"type":"string","enum":["watch","ask"]},"condition":{"anyOf":[{"type":"object","properties":{"kind":{"const":"health-below"},"threshold":{"type":"string","maxLength":20,"pattern":"^(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},"venue":{"type":"string","pattern":"^[a-z0-9-]{2,40}$"}},"required":["kind","threshold"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"lp-out-of-range"},"venue":{"type":"string","pattern":"^[a-z0-9-]{2,40}$"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"idle-above"},"token":{"type":"string","enum":["USDC","EURC"]},"amount":{"type":"string","maxLength":20,"pattern":"^(?:0|[1-9]\\d*)(?:\\.\\d+)?$"}},"required":["kind","token","amount"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"apy-below"},"percent":{"type":"string","maxLength":20,"pattern":"^(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},"venue":{"type":"string","pattern":"^[a-z0-9-]{2,40}$"}},"required":["kind","percent"],"additionalProperties":false}]},"intentId":{"type":"string","pattern":"^out_[A-Za-z0-9_-]{6,32}$"},"threadId":{"type":"string","maxLength":120}},"required":["owner","kind","from","to"]}]}}}}}},"/v1/agent/instructions/{id}/pause":{"post":{"operationId":"postAgentInstructionsByIdPause","summary":"Pause a watch task","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}:ins_[0-9a-f]{16}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"instruction":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"environment":{"type":"string"},"from":{"type":"string","enum":["watch","ask"]},"to":{"type":"string","enum":["watch","ask"]},"kind":{"type":"string","enum":["plan","watch"]},"payload":{"type":"object","additionalProperties":{},"description":"plan: sentence, title, reason, insightId, intentId. watch: condition, label, fired, lastFiredAt, observation."},"status":{"type":"string","description":"plan: pending, planned, signed, done, refused, stopped. watch: active, paused, removed."},"threadId":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","owner","environment","from","to","kind","payload","status","threadId","createdAt","updatedAt"]}},"required":["instruction"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"}},"required":["owner"]}}}}}},"/v1/agent/instructions/{id}/remove":{"post":{"operationId":"postAgentInstructionsByIdRemove","summary":"Remove a watch task","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}:ins_[0-9a-f]{16}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"instruction":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"environment":{"type":"string"},"from":{"type":"string","enum":["watch","ask"]},"to":{"type":"string","enum":["watch","ask"]},"kind":{"type":"string","enum":["plan","watch"]},"payload":{"type":"object","additionalProperties":{},"description":"plan: sentence, title, reason, insightId, intentId. watch: condition, label, fired, lastFiredAt, observation."},"status":{"type":"string","description":"plan: pending, planned, signed, done, refused, stopped. watch: active, paused, removed."},"threadId":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","owner","environment","from","to","kind","payload","status","threadId","createdAt","updatedAt"]}},"required":["instruction"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"}},"required":["owner"]}}}}}},"/v1/agent/instructions/{id}/resume":{"post":{"operationId":"postAgentInstructionsByIdResume","summary":"Resume a watch task","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}:ins_[0-9a-f]{16}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"instruction":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"environment":{"type":"string"},"from":{"type":"string","enum":["watch","ask"]},"to":{"type":"string","enum":["watch","ask"]},"kind":{"type":"string","enum":["plan","watch"]},"payload":{"type":"object","additionalProperties":{},"description":"plan: sentence, title, reason, insightId, intentId. watch: condition, label, fired, lastFiredAt, observation."},"status":{"type":"string","description":"plan: pending, planned, signed, done, refused, stopped. watch: active, paused, removed."},"threadId":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","owner","environment","from","to","kind","payload","status","threadId","createdAt","updatedAt"]}},"required":["instruction"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"}},"required":["owner"]}}}}}},"/v1/agents":{"get":{"operationId":"getAgents","summary":"List agents","tags":["Agents"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]},"post":{"operationId":"postAgents","summary":"Create an agent","tags":["Agents"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"agents","security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"},"name":{"type":"string","minLength":2,"maxLength":64},"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"tools":{"type":"array","items":{"type":"string","enum":["plan","flock","scent","venues","prices","search_routes","knowledge","outrun"]},"maxItems":8},"kinds":{"type":["array","null"],"items":{"type":"string","enum":["approve","transfer","swap","fx","deposit","withdraw","supply","borrow","repay","bridge","gateway-deposit","register-agent","attest"]},"maxItems":20},"venues":{"type":["array","null"],"items":{"type":"string","minLength":1,"maxLength":48},"maxItems":40},"fence":{"type":"object","additionalProperties":{},"description":"A lykia.fence/v1 document (see /v1/fence/templates)."},"budget":{"type":"object","properties":{"perRunUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"dailyUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"maxRunsPerDay":{"type":"integer","minimum":1,"maximum":1000}}},"pack":{"type":"array","items":{"type":"string","minLength":8,"maxLength":120},"maxItems":16},"persona":{"type":"string","maxLength":2400},"memory":{"type":"boolean"},"autoPrepare":{"type":"boolean"},"llm":{"type":"object","properties":{"provider":{"type":"string","enum":["lykia","none"]}},"required":["provider"]},"status":{"type":"string","enum":["active","paused"]}},"required":["name","owner"]}}}}}},"/v1/agents/{id}":{"delete":{"operationId":"deleteAgentsById","summary":"Delete an agent","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agt_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"agents","security":[{"LykiaKey":[]},{"LykiaSession":[]}]},"get":{"operationId":"getAgentsById","summary":"One agent","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agt_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]},"patch":{"operationId":"patchAgentsById","summary":"Reconfigure an agent","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agt_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"agents","security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"},"name":{"type":"string","minLength":2,"maxLength":64},"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"tools":{"type":"array","items":{"type":"string","enum":["plan","flock","scent","venues","prices","search_routes","knowledge","outrun"]},"maxItems":8},"kinds":{"type":["array","null"],"items":{"type":"string","enum":["approve","transfer","swap","fx","deposit","withdraw","supply","borrow","repay","bridge","gateway-deposit","register-agent","attest"]},"maxItems":20},"venues":{"type":["array","null"],"items":{"type":"string","minLength":1,"maxLength":48},"maxItems":40},"fence":{"type":"object","additionalProperties":{},"description":"A lykia.fence/v1 document (see /v1/fence/templates)."},"budget":{"type":"object","properties":{"perRunUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"dailyUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"maxRunsPerDay":{"type":"integer","minimum":1,"maximum":1000}}},"pack":{"type":"array","items":{"type":"string","minLength":8,"maxLength":120},"maxItems":16},"persona":{"type":"string","maxLength":2400},"memory":{"type":"boolean"},"autoPrepare":{"type":"boolean"},"llm":{"type":"object","properties":{"provider":{"type":"string","enum":["lykia","none"]}},"required":["provider"]},"status":{"type":"string","enum":["active","paused"]}}}}}}}},"/v1/agents/{id}/run":{"post":{"operationId":"postAgentsByIdRun","summary":"Sentence to plan under the agent's Fence","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agt_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":4000},"threadId":{"type":"string","maxLength":80},"autoPrepare":{"type":"boolean"},"dryRun":{"type":"boolean"}},"required":["message"]}}}}}},"/v1/agents/{id}/tag":{"post":{"operationId":"postAgentsByIdTag","summary":"ERC-8004 registration (card + unsigned register call)","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agt_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"agents","security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","maxLength":500},"agentWallet":{"type":"string"}}}}}}}},"/v1/agents/{id}/threads":{"get":{"operationId":"getAgentsByIdThreads","summary":"Conversation threads","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agt_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/agents/{id}/threads/{threadId}":{"get":{"operationId":"getAgentsByIdThreadsByThreadId","summary":"One thread","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agt_[a-z0-9]{12}$"}},{"name":"threadId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/aggregator/build":{"post":{"operationId":"postAggregatorBuild","summary":"Build ready-to-sign calls","description":"From a quote id or the action's params. Simulated on Arc in one batch and checked by the Fence and the security layer before it is returned; refuses (fail closed) on a deny, an unconfirmed confirm, a revert or any security block. format: transactions (EOA, Arc Memo + Multicall3From), calls (smart accounts) or eip5792 (wallet_sendCalls).","tags":["Aggregator"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["transfer","swap","fx","bridge","deposit","withdraw","supply","borrow","repay","batch"]},"environment":{"type":"string","enum":["mainnet","testnet"]},"taker":{"type":"string"},"sell":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"buy":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"route":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"venue":{"type":"string"},"summary":{"type":"string"},"reason":{"type":["string","null"]}},"required":["id","kind","venue","summary","reason"]}}},"required":["steps"]},"best":{"type":["object","null"],"properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]},"alternatives":{"type":"array","items":{"type":"object","properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]}},"priceImpactBps":{"type":["number","null"]},"gas":{"type":"object","properties":{"units":{"type":"number"},"priceWei":{"type":"string"},"usdc":{"type":"string"}},"required":["units","priceWei","usdc"]},"fees":{"type":"object","properties":{"lykiaBps":{"type":"number"},"lykiaUsd":{"type":["string","null"]},"integratorUsd":{"type":["string","null"]},"totalUsd":{"type":["string","null"]}},"required":["lykiaBps","lykiaUsd","integratorUsd","totalUsd"]},"fence":{"type":"object","properties":{"decision":{"type":"string"},"signable":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}},"digest":{"type":"string"}},"required":["decision","signable","reasons","digest"]},"warnings":{"type":"array","items":{"type":"string"}},"quoteId":{"type":["string","null"]},"intentId":{"type":"string"},"format":{"type":"string","enum":["transactions","calls","eip5792"]},"preview":{"type":"boolean"},"transactions":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"from":{"type":"string"},"to":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"},"label":{"type":"string"}},"required":["chainId","from","to","data","value","label"]}},"calls":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"},"label":{"type":"string"},"stepId":{"type":"string"}},"required":["to","data","value","label","stepId"]}},"walletSendCalls":{"type":["object","null"],"properties":{"version":{"const":"2.0.0"},"chainId":{"type":"string"},"from":{"type":"string"},"atomicRequired":{"const":true},"calls":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"}},"required":["to","data","value"]}}},"required":["version","chainId","from","atomicRequired","calls"]},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"venue":{"type":"string"},"summary":{"type":"string"},"binding":{"type":"string"},"memo":{"type":"string"},"security":{"type":"object","properties":{"decision":{"type":"string"},"findings":{"type":"array","items":{}}},"required":["decision","findings"]}},"required":["id","kind","venue","summary","binding","memo","security"]}},"simulation":{"type":"object","properties":{"ok":{"type":"boolean"},"mode":{"const":"batch"},"block":{"type":["string","null"]}},"required":["ok","mode","block"]},"security":{"type":"object","properties":{"decision":{"type":"string","enum":["pass","warn","block"]},"findings":{"type":"number"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["decision","findings","warnings"]}},"required":["kind","environment","taker","sell","buy","route","best","alternatives","priceImpactBps","gas","fees","fence","warnings","quoteId","intentId","format","preview","transactions","calls","walletSendCalls","steps","simulation","security"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"build","x-lykia-idempotent":true,"security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["transfer","swap","fx","bridge","deposit","withdraw","supply","borrow","repay","batch"]},"quoteId":{"type":"string","pattern":"^q_[A-Za-z0-9_-]{8,40}$"},"environment":{"type":"string","enum":["mainnet","testnet"]},"taker":{"type":"string"},"owner":{"type":"string"},"tokenIn":{"type":"string","minLength":2,"maxLength":12},"tokenOut":{"type":"string","minLength":2,"maxLength":12},"token":{"type":"string","minLength":2,"maxLength":12},"amount":{"anyOf":[{"const":"all"},{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}]},"to":{"type":"string"},"memo":{"type":"string","maxLength":256},"destination":{"type":"string","minLength":2,"maxLength":20},"recipient":{"type":"string"},"venue":{"type":"string","maxLength":80},"maxRisk":{"type":"string","enum":["low","medium","high"]},"collateral":{"type":"object","properties":{"token":{"type":"string","minLength":2,"maxLength":12},"amount":{"anyOf":[{"const":"all"},{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}]}},"required":["token"]},"minHealth":{"type":"string","pattern":"^\\d{1,3}(?:\\.\\d{1,4})?$"},"actions":{"type":"array","items":{},"minItems":1,"maxItems":12},"slippageBps":{"type":"integer","minimum":0,"maximum":1000},"integratorFee":{"type":"object","properties":{"bps":{"type":"integer","minimum":0,"maximum":50},"recipient":{"type":"string"}},"required":["bps","recipient"]},"venues":{"type":"object","properties":{"include":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24},"exclude":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24}}},"split":{"type":"boolean"},"fence":{},"signer":{"type":"string","enum":["wallet","agent"]},"agent":{"type":"object","properties":{"address":{"type":"string"},"agentId":{"type":"string","pattern":"^\\d{1,30}$"}},"required":["address"]},"format":{"type":"string","enum":["transactions","calls","eip5792"]},"batch":{"type":"string","enum":["step","single"]},"confirm":{"type":"boolean"},"preview":{"type":"boolean"},"provider":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"}},"additionalProperties":false}}}}}},"/v1/aggregator/quote":{"get":{"operationId":"getAggregatorQuote","summary":"Swap quote from query parameters","description":"Best route across every executable Arc venue, the alternatives it beat, price impact, gas in USDC, Lykia's fee, the integrator's fee and the Fence verdict. Returns a quote id to build from.","tags":["Aggregator"],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["swap","fx"]}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"name":"tokenIn","in":"query","required":true,"schema":{"type":"string","maxLength":12}},{"name":"tokenOut","in":"query","required":true,"schema":{"type":"string","maxLength":12}},{"name":"amount","in":"query","required":true,"schema":{"type":"string","maxLength":40}},{"name":"taker","in":"query","required":true,"schema":{"type":"string"}},{"name":"slippageBps","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":1000}},{"name":"integratorFeeBps","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":50}},{"name":"integratorFeeRecipient","in":"query","required":false,"schema":{"type":"string"}},{"name":"includeVenues","in":"query","required":false,"schema":{"type":"string","maxLength":1584}},{"name":"excludeVenues","in":"query","required":false,"schema":{"type":"string","maxLength":1584}},{"name":"split","in":"query","required":false,"schema":{"type":"string","enum":["true","false","1","0"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["transfer","swap","fx","bridge","deposit","withdraw","supply","borrow","repay","batch"]},"environment":{"type":"string","enum":["mainnet","testnet"]},"taker":{"type":"string"},"expiresAt":{"type":"string"},"sell":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"buy":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"route":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"venue":{"type":"string"},"summary":{"type":"string"},"reason":{"type":["string","null"]}},"required":["id","kind","venue","summary","reason"]}}},"required":["steps"]},"best":{"type":["object","null"],"properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]},"alternatives":{"type":"array","items":{"type":"object","properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]}},"priceImpactBps":{"type":["number","null"]},"gas":{"type":"object","properties":{"units":{"type":"number"},"priceWei":{"type":"string"},"usdc":{"type":"string"}},"required":["units","priceWei","usdc"]},"fees":{"type":"object","properties":{"lykiaBps":{"type":"number"},"lykiaUsd":{"type":["string","null"]},"integratorUsd":{"type":["string","null"]},"totalUsd":{"type":["string","null"]}},"required":["lykiaBps","lykiaUsd","integratorUsd","totalUsd"]},"fence":{"type":"object","properties":{"decision":{"type":"string"},"signable":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}},"digest":{"type":"string"}},"required":["decision","signable","reasons","digest"]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["id","kind","environment","taker","expiresAt","sell","buy","route","best","alternatives","priceImpactBps","gas","fees","fence","warnings"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}]},"post":{"operationId":"postAggregatorQuote","summary":"Quote any action","description":"kind: transfer, swap, fx, bridge, deposit, withdraw, supply, borrow, repay or batch.","tags":["Aggregator"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["transfer","swap","fx","bridge","deposit","withdraw","supply","borrow","repay","batch"]},"environment":{"type":"string","enum":["mainnet","testnet"]},"taker":{"type":"string"},"expiresAt":{"type":"string"},"sell":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"buy":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"route":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"venue":{"type":"string"},"summary":{"type":"string"},"reason":{"type":["string","null"]}},"required":["id","kind","venue","summary","reason"]}}},"required":["steps"]},"best":{"type":["object","null"],"properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]},"alternatives":{"type":"array","items":{"type":"object","properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]}},"priceImpactBps":{"type":["number","null"]},"gas":{"type":"object","properties":{"units":{"type":"number"},"priceWei":{"type":"string"},"usdc":{"type":"string"}},"required":["units","priceWei","usdc"]},"fees":{"type":"object","properties":{"lykiaBps":{"type":"number"},"lykiaUsd":{"type":["string","null"]},"integratorUsd":{"type":["string","null"]},"totalUsd":{"type":["string","null"]}},"required":["lykiaBps","lykiaUsd","integratorUsd","totalUsd"]},"fence":{"type":"object","properties":{"decision":{"type":"string"},"signable":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}},"digest":{"type":"string"}},"required":["decision","signable","reasons","digest"]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["id","kind","environment","taker","expiresAt","sell","buy","route","best","alternatives","priceImpactBps","gas","fees","fence","warnings"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["transfer","swap","fx","bridge","deposit","withdraw","supply","borrow","repay","batch"],"default":"swap"},"environment":{"type":"string","enum":["mainnet","testnet"]},"taker":{"type":"string"},"owner":{"type":"string"},"tokenIn":{"type":"string","minLength":2,"maxLength":12},"tokenOut":{"type":"string","minLength":2,"maxLength":12},"token":{"type":"string","minLength":2,"maxLength":12},"amount":{"anyOf":[{"const":"all"},{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}]},"to":{"type":"string"},"memo":{"type":"string","maxLength":256},"destination":{"type":"string","minLength":2,"maxLength":20},"recipient":{"type":"string"},"venue":{"type":"string","maxLength":80},"maxRisk":{"type":"string","enum":["low","medium","high"]},"collateral":{"type":"object","properties":{"token":{"type":"string","minLength":2,"maxLength":12},"amount":{"anyOf":[{"const":"all"},{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}]}},"required":["token"]},"minHealth":{"type":"string","pattern":"^\\d{1,3}(?:\\.\\d{1,4})?$"},"actions":{"type":"array","items":{},"minItems":1,"maxItems":12},"slippageBps":{"type":"integer","minimum":0,"maximum":1000},"integratorFee":{"type":"object","properties":{"bps":{"type":"integer","minimum":0,"maximum":50},"recipient":{"type":"string"}},"required":["bps","recipient"]},"venues":{"type":"object","properties":{"include":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24},"exclude":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24}}},"split":{"type":"boolean"},"fence":{},"signer":{"type":"string","enum":["wallet","agent"]},"agent":{"type":"object","properties":{"address":{"type":"string"},"agentId":{"type":"string","pattern":"^\\d{1,30}$"}},"required":["address"]}},"additionalProperties":false}}}}}},"/v1/build/{kind}":{"post":{"operationId":"postBuildByKind","summary":"Build one action type","description":"transfer, swap, fx, bridge, deposit, withdraw, supply, borrow, repay or batch; same answer as POST /v1/aggregator/build.","tags":["Aggregator"],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["transfer","swap","fx","bridge","deposit","withdraw","supply","borrow","repay","batch"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["transfer","swap","fx","bridge","deposit","withdraw","supply","borrow","repay","batch"]},"environment":{"type":"string","enum":["mainnet","testnet"]},"taker":{"type":"string"},"sell":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"buy":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"route":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"venue":{"type":"string"},"summary":{"type":"string"},"reason":{"type":["string","null"]}},"required":["id","kind","venue","summary","reason"]}}},"required":["steps"]},"best":{"type":["object","null"],"properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]},"alternatives":{"type":"array","items":{"type":"object","properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]}},"priceImpactBps":{"type":["number","null"]},"gas":{"type":"object","properties":{"units":{"type":"number"},"priceWei":{"type":"string"},"usdc":{"type":"string"}},"required":["units","priceWei","usdc"]},"fees":{"type":"object","properties":{"lykiaBps":{"type":"number"},"lykiaUsd":{"type":["string","null"]},"integratorUsd":{"type":["string","null"]},"totalUsd":{"type":["string","null"]}},"required":["lykiaBps","lykiaUsd","integratorUsd","totalUsd"]},"fence":{"type":"object","properties":{"decision":{"type":"string"},"signable":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}},"digest":{"type":"string"}},"required":["decision","signable","reasons","digest"]},"warnings":{"type":"array","items":{"type":"string"}},"quoteId":{"type":["string","null"]},"intentId":{"type":"string"},"format":{"type":"string","enum":["transactions","calls","eip5792"]},"preview":{"type":"boolean"},"transactions":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"number"},"from":{"type":"string"},"to":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"},"label":{"type":"string"}},"required":["chainId","from","to","data","value","label"]}},"calls":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"},"label":{"type":"string"},"stepId":{"type":"string"}},"required":["to","data","value","label","stepId"]}},"walletSendCalls":{"type":["object","null"],"properties":{"version":{"const":"2.0.0"},"chainId":{"type":"string"},"from":{"type":"string"},"atomicRequired":{"const":true},"calls":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"}},"required":["to","data","value"]}}},"required":["version","chainId","from","atomicRequired","calls"]},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"venue":{"type":"string"},"summary":{"type":"string"},"binding":{"type":"string"},"memo":{"type":"string"},"security":{"type":"object","properties":{"decision":{"type":"string"},"findings":{"type":"array","items":{}}},"required":["decision","findings"]}},"required":["id","kind","venue","summary","binding","memo","security"]}},"simulation":{"type":"object","properties":{"ok":{"type":"boolean"},"mode":{"const":"batch"},"block":{"type":["string","null"]}},"required":["ok","mode","block"]},"security":{"type":"object","properties":{"decision":{"type":"string","enum":["pass","warn","block"]},"findings":{"type":"number"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["decision","findings","warnings"]}},"required":["kind","environment","taker","sell","buy","route","best","alternatives","priceImpactBps","gas","fees","fence","warnings","quoteId","intentId","format","preview","transactions","calls","walletSendCalls","steps","simulation","security"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"build","x-lykia-idempotent":true,"security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quoteId":{"type":"string","pattern":"^q_[A-Za-z0-9_-]{8,40}$"},"environment":{"type":"string","enum":["mainnet","testnet"]},"taker":{"type":"string"},"owner":{"type":"string"},"tokenIn":{"type":"string","minLength":2,"maxLength":12},"tokenOut":{"type":"string","minLength":2,"maxLength":12},"token":{"type":"string","minLength":2,"maxLength":12},"amount":{"anyOf":[{"const":"all"},{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}]},"to":{"type":"string"},"memo":{"type":"string","maxLength":256},"destination":{"type":"string","minLength":2,"maxLength":20},"recipient":{"type":"string"},"venue":{"type":"string","maxLength":80},"maxRisk":{"type":"string","enum":["low","medium","high"]},"collateral":{"type":"object","properties":{"token":{"type":"string","minLength":2,"maxLength":12},"amount":{"anyOf":[{"const":"all"},{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}]}},"required":["token"]},"minHealth":{"type":"string","pattern":"^\\d{1,3}(?:\\.\\d{1,4})?$"},"actions":{"type":"array","items":{},"minItems":1,"maxItems":12},"slippageBps":{"type":"integer","minimum":0,"maximum":1000},"integratorFee":{"type":"object","properties":{"bps":{"type":"integer","minimum":0,"maximum":50},"recipient":{"type":"string"}},"required":["bps","recipient"]},"venues":{"type":"object","properties":{"include":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24},"exclude":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24}}},"split":{"type":"boolean"},"fence":{},"signer":{"type":"string","enum":["wallet","agent"]},"agent":{"type":"object","properties":{"address":{"type":"string"},"agentId":{"type":"string","pattern":"^\\d{1,30}$"}},"required":["address"]},"format":{"type":"string","enum":["transactions","calls","eip5792"]},"batch":{"type":"string","enum":["step","single"]},"confirm":{"type":"boolean"},"preview":{"type":"boolean"},"provider":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"}},"additionalProperties":false}}}}}},"/v1/quote/{kind}":{"post":{"operationId":"postQuoteByKind","summary":"Quote one action type","tags":["Aggregator"],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["transfer","swap","fx","bridge","deposit","withdraw","supply","borrow","repay","batch"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["transfer","swap","fx","bridge","deposit","withdraw","supply","borrow","repay","batch"]},"environment":{"type":"string","enum":["mainnet","testnet"]},"taker":{"type":"string"},"expiresAt":{"type":"string"},"sell":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"buy":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"},"units":{"type":"string"},"minimum":{"type":"string"},"usd":{"type":["string","null"]}},"required":["symbol","token","amount","units","usd"]}},"route":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"venue":{"type":"string"},"summary":{"type":"string"},"reason":{"type":["string","null"]}},"required":["id","kind","venue","summary","reason"]}}},"required":["steps"]},"best":{"type":["object","null"],"properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]},"alternatives":{"type":"array","items":{"type":"object","properties":{"venue":{"type":"string"},"label":{"type":"string"}},"required":["venue","label"]}},"priceImpactBps":{"type":["number","null"]},"gas":{"type":"object","properties":{"units":{"type":"number"},"priceWei":{"type":"string"},"usdc":{"type":"string"}},"required":["units","priceWei","usdc"]},"fees":{"type":"object","properties":{"lykiaBps":{"type":"number"},"lykiaUsd":{"type":["string","null"]},"integratorUsd":{"type":["string","null"]},"totalUsd":{"type":["string","null"]}},"required":["lykiaBps","lykiaUsd","integratorUsd","totalUsd"]},"fence":{"type":"object","properties":{"decision":{"type":"string"},"signable":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}},"digest":{"type":"string"}},"required":["decision","signable","reasons","digest"]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["id","kind","environment","taker","expiresAt","sell","buy","route","best","alternatives","priceImpactBps","gas","fees","fence","warnings"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"taker":{"type":"string"},"owner":{"type":"string"},"tokenIn":{"type":"string","minLength":2,"maxLength":12},"tokenOut":{"type":"string","minLength":2,"maxLength":12},"token":{"type":"string","minLength":2,"maxLength":12},"amount":{"anyOf":[{"const":"all"},{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}]},"to":{"type":"string"},"memo":{"type":"string","maxLength":256},"destination":{"type":"string","minLength":2,"maxLength":20},"recipient":{"type":"string"},"venue":{"type":"string","maxLength":80},"maxRisk":{"type":"string","enum":["low","medium","high"]},"collateral":{"type":"object","properties":{"token":{"type":"string","minLength":2,"maxLength":12},"amount":{"anyOf":[{"const":"all"},{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}]}},"required":["token"]},"minHealth":{"type":"string","pattern":"^\\d{1,3}(?:\\.\\d{1,4})?$"},"actions":{"type":"array","items":{},"minItems":1,"maxItems":12},"slippageBps":{"type":"integer","minimum":0,"maximum":1000},"integratorFee":{"type":"object","properties":{"bps":{"type":"integer","minimum":0,"maximum":50},"recipient":{"type":"string"}},"required":["bps","recipient"]},"venues":{"type":"object","properties":{"include":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24},"exclude":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24}}},"split":{"type":"boolean"},"fence":{},"signer":{"type":"string","enum":["wallet","agent"]},"agent":{"type":"object","properties":{"address":{"type":"string"},"agentId":{"type":"string","pattern":"^\\d{1,30}$"}},"required":["address"]}},"additionalProperties":false}}}}}},"/v1/ai/compile":{"post":{"operationId":"postAiCompile","summary":"Goal language -> lykia.program/v1 -> plan for now + drafts for later","description":"The intent compiler. Reads several goals, time (every month, if BTC goes above) and abstract wording (safe, the rest, a third, out within a day) into a typed, hashed program; resolves shares, remainders and reserves against the owner's balances (or what-if balances); compiles one plan for now (route-searched under the Fence, the program digest pinned in the Fence facts) plus automation, order, alert and standing-order drafts with links to their prefilled forms; and explains assumptions, trade-offs, rejected alternatives and what is deferred. overrides change an assumption by id. Nothing is signed or saved; plan: true stores the plan for signing.","tags":["AI routing"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"const":"lykia.compile-result/v1"},"status":{"type":"string","enum":["ready","needs-input","refused"]},"source":{"type":"string","enum":["llm","deterministic"]},"program":{},"programHash":{"type":"string"},"resolution":{},"now":{"anyOf":[{},{"type":"null"}]},"scheduled":{"type":"array","items":{}},"why":{},"questions":{"type":"array","items":{}},"pin":{}},"required":["schema","status","source","programHash","scheduled","questions"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":1000},"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"overrides":{"type":"object","additionalProperties":{"type":"string","maxLength":64}},"balances":{"type":"object","additionalProperties":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,14})(?:\\.\\d{1,18})?$"}},"constraints":{"type":"object","properties":{"fence":{},"venues":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24},"deny":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24}}},"maxCandidates":{"type":"integer","minimum":1,"maximum":24},"horizonDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"search":{"type":"boolean"},"plan":{"type":"boolean"},"preview":{"type":"boolean"},"reader":{"type":"string","enum":["auto","llm","deterministic"]}},"required":["text"],"additionalProperties":false}}}}}},"/v1/ai/explain-route":{"post":{"operationId":"postAiExplainRoute","summary":"Explain a route or a quote in plain words","tags":["AI routing"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"source":{"type":"string","enum":["llm","deterministic"]}},"required":["text","source"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"route":{},"language":{"type":"string","maxLength":40},"question":{"type":"string","maxLength":300}},"additionalProperties":false},{"type":"object","properties":{"quoteId":{"type":"string","pattern":"^q_[A-Za-z0-9_-]{8,40}$"},"language":{"type":"string","maxLength":40}},"required":["quoteId"],"additionalProperties":false}]}}}}}},"/v1/ai/route":{"post":{"operationId":"postAiRoute","summary":"Natural language -> actions -> best route","description":"Any language when a model is configured (deterministic English reader otherwise). Constraints (Fence, venue allow/deny, risk appetite, max steps) only tighten the Fence. build: true also returns the aggregator build of the best route.","tags":["AI routing"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["routed","no-route","clarify","refused","compiled"]},"understood":{"type":"object","properties":{"actions":{"type":"array","items":{}},"clarify":{"type":"array","items":{"type":"string"}},"source":{"type":"string","enum":["llm","deterministic"]}},"required":["actions","clarify","source"]},"best":{"anyOf":[{},{"type":"null"}]},"explain":{"anyOf":[{},{"type":"null"}]},"build":{"anyOf":[{},{"type":"null"}]}},"required":["status","understood"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":1000},"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"constraints":{"type":"object","properties":{"fence":{},"venues":{"type":"object","properties":{"allow":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24},"deny":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"},"maxItems":24}}},"appetite":{"type":"string","enum":["low","medium","high"]},"maxSteps":{"type":"integer","minimum":1,"maximum":12},"maxCandidates":{"type":"integer","minimum":1,"maximum":24},"horizonDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"simulate":{"type":"boolean"},"build":{"type":"boolean"},"buildOptions":{"type":"object","properties":{"format":{"type":"string","enum":["transactions","calls","eip5792"]},"batch":{"type":"string","enum":["step","single"]},"confirm":{"type":"boolean"},"preview":{"type":"boolean"},"provider":{"type":"string","pattern":"^[a-z0-9-]{2,48}$"}},"additionalProperties":false}},"required":["text","owner"],"additionalProperties":false}}}}}},"/v1/alerts":{"get":{"operationId":"getAlerts","summary":"Alert rules","tags":["Alerts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postAlerts","summary":"Create an alert rule","tags":["Alerts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/alerts/{id}":{"delete":{"operationId":"deleteAlertsById","summary":"Delete an alert rule","tags":["Alerts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"patch":{"operationId":"patchAlertsById","summary":"Update an alert rule","tags":["Alerts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/alerts/check":{"post":{"operationId":"postAlertsCheck","summary":"Check alert rules now","tags":["Alerts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/alerts/inbox":{"get":{"operationId":"getAlertsInbox","summary":"Fired alerts","tags":["Alerts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/alerts/inbox/read":{"post":{"operationId":"postAlertsInboxRead","summary":"Mark alerts read","tags":["Alerts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/arc/pulse":{"get":{"operationId":"getArcPulse","summary":"Latest block, gas and finality on Arc","tags":["Arc"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/arc/pulse/stream":{"get":{"operationId":"getArcPulseStream","summary":"Server-sent events: Arc pulse","tags":["Arc"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/contracts":{"get":{"operationId":"getContracts","summary":"Verified Circle and protocol contracts","tags":["Arc"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/deployments":{"get":{"operationId":"getDeployments","summary":"Lykia's verified contract deployments","tags":["Arc"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/networks":{"get":{"operationId":"getNetworks","summary":"Arc mainnet and testnet","tags":["Arc"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/oracles":{"get":{"operationId":"getOracles","summary":"Chainlink and Pyth reference prices","tags":["Arc"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/protocols":{"get":{"operationId":"getProtocols","summary":"The protocol registry on Arc","tags":["Arc"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/tokens":{"get":{"operationId":"getTokens","summary":"Verified tokens per network","tags":["Arc"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/venues":{"get":{"operationId":"getVenues","summary":"Registry venues with live status and whether Lykia can route through them","tags":["Arc"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/auth/logout":{"post":{"operationId":"postAuthLogout","summary":"Revoke the current session","tags":["Auth"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/auth/mcp-token":{"post":{"operationId":"postAuthMcpToken","summary":"A read-only token for the MCP personal tools (memory, contacts, profile); never usable as a session","tags":["Auth"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ttlHours":{"type":"integer","minimum":1,"maximum":168}}}}}}}},"/v1/auth/mcp-token/revoke":{"post":{"operationId":"postAuthMcpTokenRevoke","summary":"Revoke an MCP read-only token","tags":["Auth"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"]}}}}}},"/v1/auth/nonce":{"post":{"operationId":"postAuthNonce","summary":"A SIWE nonce and a ready EIP-4361 message for Arc","tags":["Auth"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"chainId":{"type":"integer"}}}}}}}},"/v1/auth/session":{"get":{"operationId":"getAuthSession","summary":"The current session and its roles","tags":["Auth"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/auth/verify":{"post":{"operationId":"postAuthVerify","summary":"Verify a signed SIWE message and get a session token","tags":["Auth"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"signature":{"type":"string"}},"required":["message","signature"]}}}}}},"/v1/automations":{"get":{"operationId":"getAutomations","summary":"Unified list (with the owner's standing orders, alerts, agent automations and orders)","tags":["Automations"],"parameters":[{"name":"owner","in":"query","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]},"post":{"operationId":"postAutomations","summary":"Create an automation (price, schedule, balance or event; plan or notify)","tags":["Automations"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"},"owner":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":120},"environment":{"type":"string","enum":["mainnet","testnet"]},"trigger":{"anyOf":[{"type":"object","properties":{"type":{"const":"price"},"feed":{"type":"string","enum":["EURC/USD","BTC/USD","ETH/USD","EUR/USD","USDC/USD","JPY/USD","BRL/USD","MXN/USD","PAXG/USD"]},"op":{"type":"string","enum":["above","below"]},"value":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,17})(?:\\.\\d{1,18})?$"}},"required":["type","feed","op","value"]},{"type":"object","properties":{"every":{"type":"string","enum":["day","week","month"]},"weekday":{"type":"string","enum":["mon","tue","wed","thu","fri","sat","sun"]},"day":{"type":"integer","minimum":1,"maximum":28},"at":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"timezone":{"type":"string","minLength":1,"maxLength":64},"type":{"const":"schedule"}},"required":["every","at","timezone","type"]},{"type":"object","properties":{"type":{"const":"balance"},"token":{"type":"string","minLength":2,"maxLength":42},"op":{"type":"string","enum":["above","below"]},"value":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,17})(?:\\.\\d{1,18})?$"},"address":{"type":"string"}},"required":["type","token","op","value"]},{"type":"object","properties":{"type":{"const":"event"},"event":{"type":"string","enum":["payout.created","payout.settled","payout.failed","invoice.created","invoice.paid"]}},"required":["type","event"]}]},"action":{"anyOf":[{"type":"object","properties":{"type":{"const":"plan"},"actions":{"type":"array","items":{},"maxItems":12},"sentence":{"type":"string","minLength":3,"maxLength":400}},"required":["type"]},{"type":"object","properties":{"type":{"const":"notify"},"channel":{"const":"webhook"}},"required":["type","channel"]}]},"fence":{"type":"object","additionalProperties":{},"description":"A lykia.fence/v1 document (see /v1/fence/templates)."},"maxFiresPerDay":{"type":"integer","minimum":1,"maximum":24}},"required":["owner","name","trigger","action"]}}}}}},"/v1/automations/{id}":{"delete":{"operationId":"deleteAutomationsById","summary":"Delete","tags":["Automations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":140}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"automation","security":[{"LykiaKey":[]},{"LykiaSession":[]}]},"get":{"operationId":"getAutomationsById","summary":"One automation","tags":["Automations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":140}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/automations/{id}/pause":{"post":{"operationId":"postAutomationsByIdPause","summary":"Pause","tags":["Automations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":140}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"automation","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/automations/{id}/resume":{"post":{"operationId":"postAutomationsByIdResume","summary":"Resume","tags":["Automations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":140}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"automation","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/autopilot":{"get":{"operationId":"getAutopilot","summary":"The owner's Autopilot","description":"Whether this server can sign for Autopilot, its ceilings (at most the lower of $100 a step and $300 a day and the mainnet beta cap), the acknowledgement and its digest, who holds what, and the owner's Autopilot with its leash, today's spend and the last runs. Task kinds: repay, dca, sweep, pay, watch.","tags":["Autopilot"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/autopilot/enable":{"post":{"operationId":"postAutopilotEnable","summary":"Turn Autopilot on","description":"Needs LYKIA_CIRCLE_SERVER_WALLETS=true on the server (403 otherwise), the acknowledgement digest (400 AUTOPILOT_ACK_REQUIRED otherwise) and limits under the ceilings. Makes (or reuses) the owner's Circle EOA wallet and a leash on the owner's LykiaAccount with that wallet as its session key; returns the transactions the owner signs once. Nothing is signed by the server before that session lands.","tags":["Autopilot"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"201":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"ack":{"type":"string","maxLength":80,"description":"The digest of the acknowledgement text from GET /v1/autopilot (offer.ack.digest)."},"limits":{"type":"object","properties":{"perStepUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"perDayUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"days":{"type":"integer","minimum":1,"maximum":30}},"required":["perStepUsd","perDayUsd","days"]},"payees":{"type":"array","items":{"type":"string"},"maxItems":10,"description":"Addresses Autopilot may pay (recurring invoices). Money to you is always allowed."}},"required":["ack","limits"]}}}}}},"/v1/autopilot/pause":{"post":{"operationId":"postAutopilotPause","summary":"Pause Autopilot","description":"Nothing is signed until it is resumed; the session stays.","tags":["Autopilot"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"reason":{"type":"string","maxLength":200}}}}}}}},"/v1/autopilot/resume":{"post":{"operationId":"postAutopilotResume","summary":"Resume Autopilot","description":"After a pause by the owner or by the anomaly guard (repeated refusals, unusual spend velocity).","tags":["Autopilot"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"reason":{"type":"string","maxLength":200}}}}}}}},"/v1/autopilot/stop":{"post":{"operationId":"postAutopilotStop","summary":"Stop Autopilot","description":"The kill switch. Server signing stops at once, the leash and its Pack agent are revoked, and revokeSession comes back for the owner's wallet.","tags":["Autopilot"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"reason":{"type":"string","maxLength":200}}}}}}}},"/v1/autopilot/tasks":{"post":{"operationId":"postAutopilotTasks","summary":"Add an Autopilot task","description":"repay (when the account's health factor drops below a floor), dca (convert on a schedule), sweep (idle USDC above an amount into a vault), pay (a payee named when Autopilot was turned on, on a schedule), watch (one of the owner's watches, then an action). Every run is planned under the Autopilot leash and checked again before Circle signs.","tags":["Autopilot"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"201":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"task":{"anyOf":[{"type":"object","properties":{"kind":{"const":"repay"},"amountUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"floor":{"type":"string","maxLength":8},"venue":{"const":"aave-v4"}},"required":["kind","amountUsd","floor"]},{"type":"object","properties":{"kind":{"const":"dca"},"amountUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"every":{"type":"string","enum":["day","week","month"]},"to":{"type":"string","enum":["EURC","USDC"]}},"required":["kind","amountUsd","every","to"]},{"type":"object","properties":{"kind":{"const":"sweep"},"amountUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"keepUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"vault":{"type":"string","minLength":2,"maxLength":48}},"required":["kind","amountUsd","keepUsd","vault"]},{"type":"object","properties":{"kind":{"const":"pay"},"amountUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"every":{"type":"string","enum":["day","week","month"]},"payee":{"type":"string"},"note":{"type":"string","maxLength":40}},"required":["kind","amountUsd","every","payee"]},{"type":"object","properties":{"kind":{"const":"watch"},"watchId":{"type":"string","maxLength":80},"condition":{"type":"object","properties":{"kind":{"type":"string","enum":["health-below","lp-out-of-range","idle-above","apy-below"]},"threshold":{"type":"string","maxLength":12},"venue":{"type":"string","maxLength":48},"token":{"type":"string","maxLength":8},"amount":{"type":"string","maxLength":16},"percent":{"type":"string","maxLength":8}},"required":["kind"],"description":"Ignored: the watch's own condition is used."},"sentence":{"type":"string","minLength":4,"maxLength":200},"amountUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"}},"required":["kind","watchId","sentence","amountUsd"]}]}},"required":["task"]}}}}}},"/v1/autopilot/tasks/{id}/{action}":{"post":{"operationId":"postAutopilotTasksByIdByAction","summary":"Pause, resume, remove or run a task","description":"run plans it now with the same checks as a scheduled run.","tags":["Autopilot"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^apt_[a-f0-9]{8}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["pause","resume","remove","run"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]}}}}}}}},"/v1/billing/credits":{"post":{"operationId":"postBillingCredits","summary":"Buy prepaid API credits with x402 (USDC on Arc); answers 402 with the requirements until paid","tags":["Billing"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"},{"name":"X-PAYMENT","in":"header","required":false,"description":"Base64 JSON x402 payment payload (EIP-3009 authorization in USDC on Arc).","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"creditsUnits":{"type":"string"},"bought":{"type":"string"},"payer":{"type":"string"},"settlement":{"type":"string"}},"required":["creditsUnits","bought","payer","settlement"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amountUsdc":{"type":"string","pattern":"^\\d{1,5}(?:\\.\\d{1,6})?$"}},"required":["amountUsdc"]}}}}}},"/v1/billing/ledger":{"get":{"operationId":"getBillingLedger","summary":"Credit purchases and overage paid over x402","tags":["Billing"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"read","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/billing/plan":{"get":{"operationId":"getBillingPlan","summary":"The account's plan, credits and limits","tags":["Billing"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"object","properties":{"id":{"type":"string","enum":["free","payg","enterprise"]},"name":{"type":"string"},"summary":{"type":"string"},"includedRequests":{"type":"integer"},"overageUnitsPerRequest":{"type":["string","null"]},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"logRetentionDays":{"type":"integer"},"webhookEndpoints":{"type":"integer"}},"required":["id","name","summary","includedRequests","overageUnitsPerRequest","perMinute","perDay","logRetentionDays","webhookEndpoints"]},"creditsUnits":{"type":"string"},"plans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["free","payg","enterprise"]},"name":{"type":"string"},"summary":{"type":"string"},"includedRequests":{"type":"integer"},"overageUnitsPerRequest":{"type":["string","null"]},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"logRetentionDays":{"type":"integer"},"webhookEndpoints":{"type":"integer"}},"required":["id","name","summary","includedRequests","overageUnitsPerRequest","perMinute","perDay","logRetentionDays","webhookEndpoints"]}}},"required":["plan","creditsUnits","plans"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"read","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"put":{"operationId":"putBillingPlan","summary":"Switch between Free and Pay as you go","tags":["Billing"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"object","properties":{"id":{"type":"string","enum":["free","payg","enterprise"]},"name":{"type":"string"},"summary":{"type":"string"},"includedRequests":{"type":"integer"},"overageUnitsPerRequest":{"type":["string","null"]},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"logRetentionDays":{"type":"integer"},"webhookEndpoints":{"type":"integer"}},"required":["id","name","summary","includedRequests","overageUnitsPerRequest","perMinute","perDay","logRetentionDays","webhookEndpoints"]}},"required":["plan"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"string","enum":["free","payg","enterprise"]},"owner":{"type":"string","description":"Admins only: the account to change."}},"required":["plan"]}}}}}},"/v1/billing/plans":{"get":{"operationId":"getBillingPlans","summary":"Every API plan","tags":["Billing"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["free","payg","enterprise"]},"name":{"type":"string"},"summary":{"type":"string"},"includedRequests":{"type":"integer"},"overageUnitsPerRequest":{"type":["string","null"]},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"logRetentionDays":{"type":"integer"},"webhookEndpoints":{"type":"integer"}},"required":["id","name","summary","includedRequests","overageUnitsPerRequest","perMinute","perDay","logRetentionDays","webhookEndpoints"]}}},"required":["plans"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/billing/usage":{"get":{"operationId":"getBillingUsage","summary":"Usage this month, per day and per endpoint","tags":["Billing"],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"string","pattern":"^-?\\d{1,15}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"string"},"month":{"type":"string"},"requests":{"type":"integer"},"includedRequests":{"type":"integer"},"overageRequests":{"type":"integer"},"overageUnits":{"type":"string"},"creditsUnits":{"type":"string"},"days":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"requests":{"type":"integer"},"errors":{"type":"integer"}},"required":["day","requests","errors"]}},"endpoints":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"endpoint":{"type":"string"},"requests":{"type":"integer"},"errors":{"type":"integer"},"avgLatencyMs":{"type":"integer"}},"required":["day","endpoint","requests","errors","avgLatencyMs"]}}},"required":["plan","month","requests","includedRequests","overageRequests","overageUnits","creditsUnits","days","endpoints"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"read","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/circle/agent-wallets":{"post":{"operationId":"postCircleAgentWallets","summary":"Create Circle agent wallets","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/cctp/fees":{"get":{"operationId":"getCircleCctpFees","summary":"CCTP V2 fees","tags":["Circle"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/circle/cctp/forward":{"post":{"operationId":"postCircleCctpForward","summary":"Draft a CCTP forward","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/cctp/status":{"get":{"operationId":"getCircleCctpStatus","summary":"A CCTP burn from Arc: attestation, forwarding state, destination mint","tags":["Circle"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/circle/compliance/{address}":{"get":{"operationId":"getCircleComplianceByAddress","summary":"Compliance screening of an address","tags":["Circle"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/circle/gateway/balance":{"get":{"operationId":"getCircleGatewayBalance","summary":"Unified Gateway balance","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/circle/gateway/transfer":{"post":{"operationId":"postCircleGatewayTransfer","summary":"Submit a Gateway transfer","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/gateway/transfer/attest":{"post":{"operationId":"postCircleGatewayTransferAttest","summary":"Attest a Gateway transfer","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/gateway/transfer/draft":{"post":{"operationId":"postCircleGatewayTransferDraft","summary":"Draft a Gateway transfer","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/gateway/transfers/{id}":{"get":{"operationId":"getCircleGatewayTransfersById","summary":"Gateway's record of a transfer, forwarded mints included","tags":["Circle"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/circle/mandates/draft":{"post":{"operationId":"postCircleMandatesDraft","summary":"Arc typed-mandate draft from a Fence (status pending)","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-idempotent":true,"security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/mandates/proof":{"post":{"operationId":"postCircleMandatesProof","summary":"Arc execution-proof draft from a verdict (status pending)","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-idempotent":true,"security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/marketplace/listing":{"get":{"operationId":"getCircleMarketplaceListing","summary":"Lykia's Agent Marketplace listing package","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/circle/marketplace/services":{"get":{"operationId":"getCircleMarketplaceServices","summary":"Agent Marketplace services payable on Arc","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/circle/policies/apply":{"post":{"operationId":"postCirclePoliciesApply","summary":"The owner's Circle CLI commands for a compiled policy (never applied by Lykia)","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-idempotent":true,"security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/policies/compile":{"post":{"operationId":"postCirclePoliciesCompile","summary":"Compile a Fence into a Circle Agent Wallet spending policy, with who enforces each rule","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-idempotent":true,"security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/providers":{"get":{"operationId":"getCircleProviders","summary":"Circle execution providers and controls, with status","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/circle/screen":{"post":{"operationId":"postCircleScreen","summary":"Screen an address","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/services":{"get":{"operationId":"getCircleServices","summary":"Circle Agent Marketplace services","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/circle/stablefx/fund":{"post":{"operationId":"postCircleStablefxFund","summary":"StableFX taker funding: hand over the signed Permit2 data","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/stablefx/funding/presign":{"post":{"operationId":"postCircleStablefxFundingPresign","summary":"StableFX taker funding: Permit2 typed data to sign","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/stablefx/quote":{"post":{"operationId":"postCircleStablefxQuote","summary":"StableFX quote (USDC/EURC)","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/stablefx/trade":{"post":{"operationId":"postCircleStablefxTrade","summary":"StableFX trade","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/stablefx/trades/{id}":{"get":{"operationId":"getCircleStablefxTradesById","summary":"A StableFX trade","tags":["Circle"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/circle/status":{"get":{"operationId":"getCircleStatus","summary":"Every Circle product live on Arc and how Lykia uses it","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/circle/usyc/eligibility":{"get":{"operationId":"getCircleUsycEligibility","summary":"USYC entitlement of a wallet on Arc (Entitlements.canCall on the Teller)","tags":["Circle"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/circle/usyc/prepare":{"post":{"operationId":"postCircleUsycPrepare","summary":"USYC subscribe or redeem for an entitled wallet: Fence verdict and unsigned calls","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/wallets/{id}/balances":{"get":{"operationId":"getCircleWalletsByIdBalances","summary":"Circle wallet balances","tags":["Circle"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/circle/wallets/agent":{"post":{"operationId":"postCircleWalletsAgent","summary":"Create a Circle agent wallet","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/x402/pay":{"post":{"operationId":"postCircleX402Pay","summary":"Pay an x402 resource","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/circle/x402/prepare":{"post":{"operationId":"postCircleX402Prepare","summary":"Prepare an x402 payment","tags":["Circle"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/consents":{"get":{"operationId":"getConsents","summary":"Projects the signed-in owner lets act for them","description":"A project's secret keys may act for an owner other than the key's own developer (agents, Fold, standing orders, automations, saved chat state, webhook events) only while that owner's consent is on record. Session only.","tags":["Consent"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"consents":{"type":"array","items":{"type":"object","properties":{"owner":{"type":"string"},"projectId":{"type":"string"},"developer":{"type":"string"},"projectName":{"type":"string"},"grantedAt":{"type":"string"}},"required":["owner","projectId","developer","projectName","grantedAt"]}}},"required":["consents"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postConsents","summary":"Let a project act for the signed-in owner","description":"Grants the project's secret keys the right to act for this owner and adds this owner's events to the project's webhooks. Session only: an API key can never grant consent.","tags":["Consent"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"201":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"projectId":{"type":"string"},"developer":{"type":"string"},"projectName":{"type":"string"},"grantedAt":{"type":"string"}},"required":["owner","projectId","developer","projectName","grantedAt"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"}},"required":["projectId"]}}}}}},"/v1/consents/{projectId}":{"delete":{"operationId":"deleteConsentsByProjectId","summary":"Revoke a project's consent","description":"The project's keys stop acting for this owner and its webhooks stop carrying this owner's events.","tags":["Consent"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"revoked":{"type":"boolean"}},"required":["revoked"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/contracts/decode":{"post":{"operationId":"postContractsDecode","summary":"Calldata and logs -> plain English","tags":["Contracts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"calls":{"type":"array","items":{}},"lines":{"type":"array","items":{"type":"string"}},"events":{"type":"array","items":{}}},"required":["calls","lines","events"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"to":{"type":"string"},"data":{"type":"string","pattern":"^0x(?:[0-9a-fA-F]{2}){0,24576}$"},"value":{"type":"string","pattern":"^\\d{1,40}$"},"logs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"topics":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"minItems":1,"maxItems":4},"data":{"type":"string","pattern":"^0x(?:[0-9a-fA-F]{2}){0,24576}$"}},"required":["address","topics","data"]},"maxItems":100},"abi":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":1000},"minItems":1,"maxItems":64},{"type":"array","items":{"type":"object","additionalProperties":{}},"minItems":1,"maxItems":256}]}},"additionalProperties":false}}}}}},"/v1/contracts/encode":{"post":{"operationId":"postContractsEncode","summary":"ABI + function + args -> calldata","tags":["Contracts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"string"},"selector":{"type":"string"},"signature":{"type":"string"}},"required":["data","selector","signature"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":1000},"minItems":1,"maxItems":64},{"type":"array","items":{"type":"object","additionalProperties":{}},"minItems":1,"maxItems":256}]},"function":{"type":"string","minLength":1,"maxLength":200},"args":{"type":"array","items":{},"maxItems":32}},"required":["abi","function"],"additionalProperties":false}}}}}},"/v1/contracts/read":{"post":{"operationId":"postContractsRead","summary":"Many view calls in one multicall","tags":["Contracts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"block":{"type":["string","null"]},"results":{"type":"array","items":{"type":"object","properties":{}}}},"required":["block","results"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"calls":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"abi":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":1000},"minItems":1,"maxItems":64},{"type":"array","items":{"type":"object","additionalProperties":{}},"minItems":1,"maxItems":256}]},"function":{"type":"string","minLength":1,"maxLength":200},"args":{"type":"array","items":{},"maxItems":32}},"required":["address","abi","function"]},"minItems":1,"maxItems":50}},"required":["calls"],"additionalProperties":false}}}}}},"/v1/contracts/simulate":{"post":{"operationId":"postContractsSimulate","summary":"Simulate a call batch from an address","description":"One Multicall3From eth_call: balance diff, decoded calls, events when eth_simulateV1 is available, and a security verdict.","tags":["Contracts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"balanceChanges":{"type":"array","items":{"type":"object","properties":{}}},"security":{"type":"object","properties":{"decision":{"type":"string"},"findings":{"type":"array","items":{"type":"object","properties":{}}}},"required":["decision","findings"]}},"required":["ok","balanceChanges","security"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"from":{"type":"string"},"calls":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"to":{"type":"string"},"data":{"type":"string","pattern":"^0x(?:[0-9a-fA-F]{2}){0,24576}$"},"value":{"type":"string","pattern":"^\\d{1,40}$"}},"required":["to","data"],"additionalProperties":false},{"type":"object","properties":{"to":{"type":"string"},"abi":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":1000},"minItems":1,"maxItems":64},{"type":"array","items":{"type":"object","additionalProperties":{}},"minItems":1,"maxItems":256}]},"function":{"type":"string","minLength":1,"maxLength":200},"args":{"type":"array","items":{},"maxItems":32},"value":{"type":"string","pattern":"^\\d{1,40}$"}},"required":["to","abi","function"],"additionalProperties":false}]},"minItems":1,"maxItems":20},"tokens":{"type":"array","items":{"type":"string"},"maxItems":10},"abi":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":1000},"minItems":1,"maxItems":64},{"type":"array","items":{"type":"object","additionalProperties":{}},"minItems":1,"maxItems":256}]}},"required":["from","calls"],"additionalProperties":false}}}}}},"/v1/data/portfolio/{address}":{"get":{"operationId":"getDataPortfolioByAddress","summary":"Balances and positions across venues, in USD","tags":["Data"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"totalUsd":{"type":["string","null"]},"holdings":{"type":"array","items":{"type":"object","properties":{}}},"venues":{"type":"array","items":{"type":"object","properties":{}}}},"required":["totalUsd","holdings","venues"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/data/prices":{"get":{"operationId":"getDataPrices","summary":"USD prices (Chainlink on Arc, pegs, NAV)","tags":["Data"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"name":"symbols","in":"query","required":false,"schema":{"type":"string","maxLength":1980}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"prices":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"usd":{"type":["string","null"]},"source":{"type":"string"}},"required":["symbol","usd","source"]}}},"required":["prices"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/data/protocols":{"get":{"operationId":"getDataProtocols","summary":"The protocols mapped on Arc: status, TVL, APYs and routable adapters","tags":["Data"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"protocols":{"type":"array","items":{"type":"object","properties":{}}}},"required":["protocols"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/data/tokens":{"get":{"operationId":"getDataTokens","summary":"Token registry with prices and sources","tags":["Data"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"tokens":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":["string","null"]},"decimals":{"type":"number"},"priceUsd":{"type":["string","null"]},"priceSource":{"type":["string","null"]}},"required":["symbol","address","decimals","priceUsd","priceSource"]}}},"required":["environment","tokens"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/tx/explain":{"post":{"operationId":"postTxExplain","summary":"Explain a transaction in plain English","description":"A mined transaction by hash (decoded calls and events), or an unsigned one (decoded, simulated, with a security verdict).","tags":["Data"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string"},"steps":{"type":"array","items":{"type":"string"}}},"required":["summary","steps"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"quote","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"required":["hash"],"additionalProperties":false},{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"transaction":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"data":{"type":"string","pattern":"^0x(?:[0-9a-fA-F]{2}){0,24576}$"},"value":{"type":"string","pattern":"^\\d{1,40}$"}},"required":["from","to","data"],"additionalProperties":false}},"required":["transaction"],"additionalProperties":false}]}}}}}},"/v1/tx/explain/{hash}":{"get":{"operationId":"getTxExplainByHash","summary":"Explain a mined transaction","tags":["Data"],"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string"},"steps":{"type":"array","items":{"type":"string"}}},"required":["summary","steps"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/developers/me":{"get":{"operationId":"getDevelopersMe","summary":"Profile, fee settings and usage","tags":["Developers"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/developers/register":{"post":{"operationId":"postDevelopersRegister","summary":"Become a developer","tags":["Developers"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64},"website":{"type":["string","null"],"format":"uri"}},"required":["name"]}}}}}},"/v1/developers/settings":{"put":{"operationId":"putDevelopersSettings","summary":"Integrator fee (bps, capped) and its recipient","tags":["Developers"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"integratorFeeBps":{"type":"integer","minimum":0,"maximum":50},"feeRecipient":{"type":["string","null"],"pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["integratorFeeBps","feeRecipient"]}}}}}},"/v1/developers/usage":{"get":{"operationId":"getDevelopersUsage","summary":"Requests today, the last seven days and per key","tags":["Developers"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/activity":{"get":{"operationId":"getActivity","summary":"Recent activity","tags":["Discover"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/discover/launches":{"get":{"operationId":"getDiscoverLaunches","summary":"New token launches on Arc","tags":["Discover"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/perps/markets":{"get":{"operationId":"getPerpsMarkets","summary":"Perpetual markets","tags":["Discover"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/perps/markets/{market}":{"get":{"operationId":"getPerpsMarketsByMarket","summary":"One perpetual market","tags":["Discover"],"parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/track/{hash}":{"get":{"operationId":"getTrackByHash","summary":"Track a transaction on Arc","tags":["Discover"],"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/watch":{"get":{"operationId":"getWatch","summary":"Watched addresses","tags":["Discover"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postWatch","summary":"Watch an address","tags":["Discover"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["address"]}}}}}},"/v1/watch/{address}":{"delete":{"operationId":"deleteWatchByAddress","summary":"Stop watching an address","tags":["Discover"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/ecosystem":{"get":{"operationId":"getEcosystem","summary":"The protocols mapped on Arc, Circle's products, TVL and value routed by Lykia","tags":["Ecosystem"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/events":{"get":{"operationId":"getEvents","summary":"The account's events, newest first (what webhooks deliver)","tags":["Events"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^-?\\d{1,15}$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"event":{"type":"string"},"createdAt":{"type":"string"},"owner":{"type":["string","null"]},"project":{"type":["string","null"]},"livemode":{"type":"boolean"},"apiVersion":{"type":"string"},"data":{}},"required":["id","type","event","createdAt","owner","project","livemode","apiVersion"]}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"read","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/events/{id}":{"get":{"operationId":"getEventsById","summary":"One event","tags":["Events"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"event":{"type":"string"},"createdAt":{"type":"string"},"owner":{"type":["string","null"]},"project":{"type":["string","null"]},"livemode":{"type":"boolean"},"apiVersion":{"type":"string"},"data":{}},"required":["id","type","event","createdAt","owner","project","livemode","apiVersion"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"read","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/fence/default":{"get":{"operationId":"getFenceDefault","summary":"The default Fence","tags":["Fence"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/fence/evaluate":{"post":{"operationId":"postFenceEvaluate","summary":"Evaluate a planned move against a Fence: allow, confirm or deny with reasons","tags":["Fence"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fence":{},"facts":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"signer":{"type":"string","enum":["wallet","agent"]},"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"proposedByAgent":{"type":"boolean"},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":32},"kind":{"type":"string","maxLength":32},"venue":{"type":"string","maxLength":48},"usd":{"type":["string","null"],"pattern":"^\\d{1,15}(?:\\.\\d{1,8})?$"},"tokens":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string","maxLength":32},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"listed":{"type":"boolean"},"acquired":{"type":"boolean"},"scent":{"type":"string","enum":["verified","no-red-flags","caution","danger","unknown"]}},"required":["symbol","address","listed","acquired"]},"maxItems":8},"recipient":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"destination":{"type":"string","maxLength":32},"slippageBps":{"type":"integer","minimum":0,"maximum":10000},"healthFactorAfter":{"type":["string","null"],"maxLength":16},"fxDeviationBps":{"type":["integer","null"],"minimum":-10000,"maximum":10000}},"required":["id","kind","venue","usd","tokens"]},"maxItems":12},"spent":{"type":"object","properties":{"dayUsd":{"type":["string","null"],"pattern":"^\\d{1,15}(?:\\.\\d{1,8})?$"},"weekUsd":{"type":["string","null"],"pattern":"^\\d{1,15}(?:\\.\\d{1,8})?$"}},"required":["dayUsd","weekUsd"]},"now":{"type":"integer","exclusiveMinimum":0}},"required":["environment","signer","owner","steps"]}},"required":["facts"]}}}}}},"/v1/fence/templates":{"get":{"operationId":"getFenceTemplates","summary":"Fence templates","tags":["Fence"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/fence/validate":{"post":{"operationId":"postFenceValidate","summary":"Validate a Fence document (and diff it against a previous one)","tags":["Fence"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fence":{},"previous":{}}}}}}}},"/v1/me/fence":{"get":{"operationId":"getMeFence","summary":"The owner's Fence, kept on the server: its preset (Careful, Balanced or Bold, the risk profile), whether it was edited beyond the preset, and its hash. Chat, proposals and automations plan under it","tags":["Fence"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"put":{"operationId":"putMeFence","summary":"Pick a preset or save an edited Fence. Tightening applies at once; a loosening returns 403 FENCE_SIGNATURE_REQUIRED with the message to sign, then succeeds with signature","tags":["Fence"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"preset":{"type":"string","enum":["careful","balanced","bold"]},"fence":{"type":"object","additionalProperties":{}},"signature":{"type":"string","maxLength":4000,"description":"The owner's signature on the loosening message (403 FENCE_SIGNATURE_REQUIRED returns it); only a loosening needs one."},"migrated":{"type":"boolean","description":"True when this Fence is the one a browser held from before, kept by the owner."}}}}}}}},"/v1/me/fence/migrated":{"post":{"operationId":"postMeFenceMigrated","summary":"The owner discarded the Fence a browser held from before; it is not proposed again","tags":["Fence"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/flock/{address}":{"get":{"operationId":"getFlockByAddress","summary":"One balance sheet: wallet, Gateway and venue positions, priced","tags":["Flock"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/flock/{address}/stream":{"get":{"operationId":"getFlockByAddressStream","summary":"Server-sent events: the Flock as it changes","tags":["Flock"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/fold/answer":{"post":{"operationId":"postFoldAnswer","summary":"Answer a follow-up chip and write the exchange to the owner's shared thread","tags":["Fold"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"threadId":{"type":"string"},"question":{"type":"string"},"reply":{"type":"string"},"artifact":{"type":"object","properties":{"kind":{"type":"string","enum":["yield","whatif","week","approvals"]},"title":{"type":"string"},"summary":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"note":{"type":["string","null"]}},"required":["label","value","note"]}},"sources":{"type":"array","items":{"type":"string"}},"at":{"type":"string"}},"required":["kind","title","summary","lines","sources","at"]}},"required":["threadId","question","reply","artifact"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"question":{"type":"string","enum":["yield","whatif","week","approvals"]},"threadId":{"type":"string","maxLength":120},"shocks":{"type":"object","properties":{"EURC":{"type":"number","minimum":-90,"maximum":90,"default":0},"cirBTC":{"type":"number","minimum":-90,"maximum":90,"default":0},"ratesBps":{"type":"integer","minimum":-1000,"maximum":1000,"default":0}}}},"required":["owner","question"]}}}}}},"/v1/fold/explain":{"get":{"operationId":"getFoldExplain","summary":"A structured explanation (yield and fees, a what-if, this week's runs, open approvals) as label, value and note lines","tags":["Fold"],"parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"name":"question","in":"query","required":true,"schema":{"type":"string","enum":["yield","whatif","week","approvals"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["yield","whatif","week","approvals"]},"title":{"type":"string"},"summary":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"note":{"type":["string","null"]}},"required":["label","value","note"]}},"sources":{"type":"array","items":{"type":"string"}},"at":{"type":"string"}},"required":["kind","title","summary","lines","sources","at"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/fold/feed":{"get":{"operationId":"getFoldFeed","summary":"Every proposal transition of the last 30 days","tags":["Fold"],"parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/fold/insights/{address}":{"get":{"operationId":"getFoldInsightsByAddress","summary":"Lyko on watch: deterministic insights for an address (idle USDC, health factor, FX drift, runway, approvals, red-flag tokens, gas, caps, orders, agent budgets, unsettled steps, better rates), each with the figures behind it and an optional one-tap draft. Signed in as the owner: preferences, handled flags and the morning brief apply.","tags":["Fold"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"environment":{"type":"string"},"at":{"type":"string"},"insights":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["idle-usdc","health-factor","fx-drift","runway","approval-hygiene","scent-warning","gas-floor","beta-headroom","order-near-trigger","agent-budget","unsettled","yield-change","lp-out-of-range","order-expiring","watch-task","near-threshold","unclaimed","expiring","idle-position","stranded","dust","obligations","bridge-stuck"]},"severity":{"type":"string","enum":["info","watch","act"]},"title":{"type":"string"},"explain":{"type":"string"},"figures":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"]}},"draft":{"type":["object","null"],"properties":{"label":{"type":"string"},"sentence":{"type":["string","null"]}},"required":["label","sentence"]},"handled":{"type":"boolean"}},"required":["id","kind","severity","title","explain","figures","draft","handled"]}},"brief":{"type":"object","properties":{"since":{"type":["string","null"]},"lines":{"type":"array","items":{"type":"string"}}},"required":["since","lines"]},"personal":{"type":"boolean"}},"required":["owner","environment","at","insights","brief","personal"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/fold/instructions":{"get":{"operationId":"getFoldInstructions","summary":"Herding: one list of every standing instruction (automations, standing orders and recurring payments, alerts, agent automations, LykiaOrders orders) with next run, last result and the expected Fence verdict, plus the proposals waiting for a signature","tags":["Fold"],"parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"at":{"type":"string"},"instructions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"sourceLabel":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"trigger":{"type":"string"},"nextRunAt":{"type":["string","null"]},"nextRunLabel":{"type":"string"},"lastRunAt":{"type":["string","null"]},"lastResult":{"type":["string","null"]},"controllable":{"type":"boolean"},"editSentence":{"type":"string"}},"required":["id","source","sourceLabel","name","status","trigger","nextRunAt","nextRunLabel","lastRunAt","lastResult","controllable","editSentence"]}},"waiting":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"status":{"type":"string","enum":["proposed","approved","done","stopped"]},"title":{"type":"string"},"sentence":{"type":["string","null"]},"intentId":{"type":["string","null"]},"decision":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"steps":{"type":"array","items":{"type":"string"}}},"required":["id","owner","status","title","sentence","intentId","decision","reasons","steps"]}},"counts":{"type":"object","properties":{"running":{"type":"number"},"paused":{"type":"number"},"ordersWaiting":{"type":"number"},"waitingSignature":{"type":"number"}},"required":["running","paused","ordersWaiting","waitingSignature"]}},"required":["owner","at","instructions","waiting","counts"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/fold/positions/{address}":{"get":{"operationId":"getFoldPositionsByAddress","summary":"Every position the address holds in every venue Lykia supports on Arc: the wallet, Aave V4 (Main and Forex Spokes), Morpho vaults (by curator: Galaxy, Keyrock, Steakhouse, Gauntlet, Bitwise) and Morpho Blue markets, Uniswap v3 and v4, Aerodrome Slipstream, Archery, Unitflow Finance V3 and SushiSwap V3 LP NFTs, USYC, the Circle Gateway unified balance and, for the proven owner, CCTP and Relay transfers in flight, open LykiaOrders orders and scheduled payments. Each position carries its amount, USD value, state (earning, idle, borrowing, at-risk, out-of-range, pending, escrowed, committed), what it is doing, APY, health, range and fees where they apply, one-tap Lyko actions, its source (chain, api, history), the block and an explorer link. A venue that cannot be read comes back unavailable with the reason, never as zero. Each venue is read with its own time limit and cached for 20 seconds per address.","tags":["Fold"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"name":"venues","in":"query","required":false,"schema":{"type":"string","maxLength":400,"description":"Comma-separated venue ids to read (default all): wallet, aave-v4, morpho-vaults, galaxy-curation, keyrock, steakhouse-financial, gauntlet, bitwise, morpho-blue, uniswap-v3, uniswap-v4, aerodrome-slipstream, archery, unitflow-finance-v3, sushiswap, usyc, gateway, cctp, relay, across, lykia-orders, arc-transfer, leashes, plans, watches, lykia-practice"},"description":"Comma-separated venue ids to read (default all): wallet, aave-v4, morpho-vaults, galaxy-curation, keyrock, steakhouse-financial, gauntlet, bitwise, morpho-blue, uniswap-v3, uniswap-v4, aerodrome-slipstream, archery, unitflow-finance-v3, sushiswap, usyc, gateway, cctp, relay, across, lykia-orders, arc-transfer, leashes, plans, watches, lykia-practice"},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"environment":{"type":"string"},"at":{"type":"string"},"block":{"type":["string","null"]},"venues":{"type":"array","items":{"type":"object","properties":{"venue":{"type":"string"},"venueName":{"type":"string"},"venueKind":{"type":"string"},"status":{"type":"string","enum":["ok","unavailable","private"]},"reason":{"type":"string"},"positions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"venue":{"type":"string"},"venueName":{"type":"string"},"venueKind":{"type":"string"},"label":{"type":"string"},"assets":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":["string","null"]},"amount":{"type":"string"},"valueUsd":{"type":["string","null"]},"role":{"type":"string"}},"required":["symbol","token","amount","valueUsd","role"]}},"amount":{"type":"string"},"symbol":{"type":"string"},"valueUsd":{"type":["string","null"],"description":"Signed USD value (debt is negative); null when unpriced, never zero"},"counts":{"type":"string","enum":["net","overlay"],"description":"overlay: money already counted elsewhere (orders, scheduled payments)"},"state":{"type":"string","enum":["earning","idle","borrowing","at-risk","out-of-range","pending","escrowed","committed","watching"]},"doing":{"type":"string","description":"What the position is doing, in one plain line"},"apy":{"type":"object","properties":{"percent":{"type":"string"},"kind":{"type":"string"},"source":{"type":"string"}},"required":["percent","kind","source"]},"earned":{"type":"object","properties":{"usd":{"type":"string"},"since":{"type":"string"},"method":{"type":"string"}},"required":["usd","since","method"]},"health":{"type":"object","properties":{"factor":{"type":["string","null"]},"liquidationAtPercent":{"type":["string","null"]},"ltvPercent":{"type":["string","null"]},"floor":{"type":"string"}},"required":["factor","liquidationAtPercent","ltvPercent","floor"]},"range":{"type":"object","properties":{"tickLower":{"type":"number"},"tickUpper":{"type":"number"},"tick":{"type":"number"},"lower":{"type":"string"},"upper":{"type":"string"},"price":{"type":"string"},"quote":{"type":"string"},"inRange":{"type":"boolean"}},"required":["tickLower","tickUpper","tick","lower","upper","price","quote","inRange"]},"fees":{"type":"object","properties":{"assets":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"token":{"type":["string","null"]},"amount":{"type":"string"},"valueUsd":{"type":["string","null"]},"role":{"type":"string"}},"required":["symbol","token","amount","valueUsd","role"]}},"valueUsd":{"type":["string","null"]},"method":{"type":"string"}},"required":["assets","valueUsd","method"]},"collateral":{"type":"boolean"},"since":{"type":["string","null"]},"facts":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"]}},"actions":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"label":{"type":"string"},"sentence":{"type":"string"},"mode":{"type":"string","enum":["draft","ask"]}},"required":["kind","label","sentence","mode"]}},"source":{"type":"string","enum":["chain","api","history"]},"readAt":{"type":"string"},"block":{"type":["string","null"]},"explorer":{"type":["string","null"]}},"required":["id","venue","venueName","venueKind","label","assets","amount","symbol","valueUsd","counts","state","doing","actions","source","readAt","block","explorer"]}},"source":{"type":"string"},"method":{"type":"string"},"coverage":{"type":"string"},"readAt":{"type":"string"},"block":{"type":["string","null"]},"ms":{"type":"number"}},"required":["venue","venueName","venueKind","status","positions","source","method","readAt","block","ms"]}},"summary":{"type":"object","properties":{"netUsd":{"type":["string","null"]},"pricedNetUsd":{"type":"string"},"byState":{"type":"object","additionalProperties":{"type":"string"}},"weightedApyPercent":{"type":["string","null"]},"yearlyYieldUsd":{"type":["string","null"]},"lowestHealth":{"type":["object","null"],"properties":{"venue":{"type":"string"},"label":{"type":"string"},"factor":{"type":"string"}},"required":["venue","label","factor"]},"positions":{"type":"number"},"unpriced":{"type":"number"},"unavailable":{"type":"array","items":{"type":"string"}}},"required":["netUsd","pricedNetUsd","byState","weightedApyPercent","yearlyYieldUsd","lowestHealth","positions","unpriced","unavailable"]},"personal":{"type":"boolean"},"healthFloor":{"type":"string"}},"required":["address","environment","at","block","venues","summary","personal","healthFloor"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/fold/proposals":{"get":{"operationId":"getFoldProposals","summary":"The owner's proposals, newest first; plans that settled become done and plans that failed become stopped","tags":["Fold"],"parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["proposed","approved","done","stopped"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"proposals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"status":{"type":"string","enum":["proposed","approved","done","stopped"]},"title":{"type":"string"},"sentence":{"type":["string","null"]},"intentId":{"type":["string","null"]},"decision":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"steps":{"type":"array","items":{"type":"string"}}},"required":["id","owner","status","title","sentence","intentId","decision","reasons","steps"]}}},"required":["proposals"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postFoldProposals","summary":"Draft a proposal: from an insight (its server-side draft is used), a holding action or a chat sentence (planned under the owner's Fence with the fee and the beta cap), or a Fence edit. Nothing is signed.","tags":["Fold"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"201":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"status":{"type":"string","enum":["proposed","approved","done","stopped"]},"title":{"type":"string"},"sentence":{"type":["string","null"]},"intentId":{"type":["string","null"]},"decision":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"steps":{"type":"array","items":{"type":"string"}}},"required":["id","owner","status","title","sentence","intentId","decision","reasons","steps"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"source":{"type":"object","properties":{"kind":{"type":"string","enum":["insight","chat","fence","holding"]},"ref":{"type":["string","null"],"maxLength":120,"default":null}},"required":["kind"]},"title":{"type":"string","minLength":1,"maxLength":160},"sentence":{"type":"string","minLength":3,"maxLength":400},"fencePatch":{"type":"object","additionalProperties":{}},"fence":{}},"required":["owner","source"]}}}}}},"/v1/fold/proposals/{id}/approve":{"post":{"operationId":"postFoldProposalsByIdApprove","summary":"The owner accepted or started signing a proposal (proposed → approved)","tags":["Fold"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}:prp_[0-9a-f]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"status":{"type":"string","enum":["proposed","approved","done","stopped"]},"title":{"type":"string"},"sentence":{"type":["string","null"]},"intentId":{"type":["string","null"]},"decision":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"steps":{"type":"array","items":{"type":"string"}}},"required":["id","owner","status","title","sentence","intentId","decision","reasons","steps"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"note":{"type":"string","maxLength":200}},"required":["owner"]}}}}}},"/v1/fold/proposals/{id}/done":{"post":{"operationId":"postFoldProposalsByIdDone","summary":"A proposal finished (approved → done)","tags":["Fold"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}:prp_[0-9a-f]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"status":{"type":"string","enum":["proposed","approved","done","stopped"]},"title":{"type":"string"},"sentence":{"type":["string","null"]},"intentId":{"type":["string","null"]},"decision":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"steps":{"type":"array","items":{"type":"string"}}},"required":["id","owner","status","title","sentence","intentId","decision","reasons","steps"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"note":{"type":"string","maxLength":200}},"required":["owner"]}}}}}},"/v1/fold/proposals/{id}/stop":{"post":{"operationId":"postFoldProposalsByIdStop","summary":"Stop a proposal (its plan is stopped too)","tags":["Fold"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-f]{40}:prp_[0-9a-f]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"string"},"status":{"type":"string","enum":["proposed","approved","done","stopped"]},"title":{"type":"string"},"sentence":{"type":["string","null"]},"intentId":{"type":["string","null"]},"decision":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"steps":{"type":"array","items":{"type":"string"}}},"required":["id","owner","status","title","sentence","intentId","decision","reasons","steps"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"note":{"type":"string","maxLength":200}},"required":["owner"]}}}}}},"/v1/fold/seen":{"post":{"operationId":"postFoldSeen","summary":"Mark the morning brief as seen: the next brief lists only what changed after now","tags":["Fold"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"at":{"type":"string"}},"required":["at"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]}},"required":["owner"]}}}}}},"/v1/fold/summary/{address}":{"get":{"operationId":"getFoldSummaryByAddress","summary":"The Fold bar: today's spend against the Fence's daily cap and the beta cap, and the counts of rules running, orders waiting, agents working and proposals waiting","tags":["Fold"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/fold/trails":{"get":{"operationId":"getFoldTrails","summary":"Trails: settled steps with their Arc Memo, Fence verdict and digest and fee; plans running; failed and refused attempts; orders, alerts and proposals","tags":["Fold"],"parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/fold/whatif/{address}":{"get":{"operationId":"getFoldWhatifByAddress","summary":"The shared shock model on the live Flock: EURC and cirBTC price moves (percent) and a lending rate change (bps), with health factors and one sentence","tags":["Fold"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"name":"eurc","in":"query","required":false,"schema":{"type":"number"}},{"name":"btc","in":"query","required":false,"schema":{"type":"number"}},{"name":"rates","in":"query","required":false,"schema":{"type":"number"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/me/preferences":{"delete":{"operationId":"deleteMePreferences","summary":"Back to the default preferences","tags":["Fold"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"get":{"operationId":"getMePreferences","summary":"Your Lyko: risk profile, liquidity floor, target mix, gas floor, insights and notifications and the Fold's layout, with the effect of each","tags":["Fold"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"put":{"operationId":"putMePreferences","summary":"Update Your Lyko (partial; validated). The risk profile is the Fence preset: a change that loosens the Fence needs fenceSignature, the owner's signature on the loosening message","tags":["Fold"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}}}},"/v1/me/threads":{"get":{"operationId":"getMeThreads","summary":"The owner's shared threads (Ask Lyko and Lyko on watch), newest first, with size, last line and origin","tags":["Fold"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/integrations/adapters":{"get":{"operationId":"getIntegrationsAdapters","summary":"List adapters","tags":["Integrations"],"parameters":[{"name":"mine","in":"query","required":false,"schema":{"type":"string","enum":["true","false","1","0"]}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["submitted","validated","approved","routable","rejected","suspended"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"adapters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["submitted","validated","approved","routable","rejected","suspended"]},"manifest":{"type":"object","additionalProperties":{}},"submittedBy":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"validation":{},"review":{},"history":{"type":"array","items":{}}},"required":["id","status","manifest","submittedBy","submittedAt","updatedAt","history"]}}},"required":["adapters"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]},"post":{"operationId":"postIntegrationsAdapters","summary":"Submit a Lykia Adapter Manifest","description":"A lykia.adapter/v1 document. validate: true runs the on-chain validation right away.","tags":["Integrations"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["submitted","validated","approved","routable","rejected","suspended"]},"manifest":{"type":"object","additionalProperties":{}},"submittedBy":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"validation":{},"review":{},"history":{"type":"array","items":{}}},"required":["id","status","manifest","submittedBy","submittedAt","updatedAt","history"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"build","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"manifest":{},"validate":{"type":"boolean"},"environment":{"type":"string","enum":["mainnet","testnet"]}},"additionalProperties":false}}}}}},"/v1/integrations/adapters/{id}":{"get":{"operationId":"getIntegrationsAdaptersById","summary":"One adapter","tags":["Integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,47}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["submitted","validated","approved","routable","rejected","suspended"]},"manifest":{"type":"object","additionalProperties":{}},"submittedBy":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"validation":{},"review":{},"history":{"type":"array","items":{}}},"required":["id","status","manifest","submittedBy","submittedAt","updatedAt","history"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/integrations/adapters/{id}/review":{"post":{"operationId":"postIntegrationsAdaptersByIdReview","summary":"Admin review: approve, reject, route or suspend","tags":["Integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,47}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["submitted","validated","approved","routable","rejected","suspended"]},"manifest":{"type":"object","additionalProperties":{}},"submittedBy":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"validation":{},"review":{},"history":{"type":"array","items":{}}},"required":["id","status","manifest","submittedBy","submittedAt","updatedAt","history"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["approve","reject","route","suspend"]},"note":{"type":"string","maxLength":400}},"required":["decision"],"additionalProperties":false}}}}}},"/v1/integrations/adapters/{id}/status":{"get":{"operationId":"getIntegrationsAdaptersByIdStatus","summary":"Adapter status and last validation","tags":["Integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,47}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["submitted","validated","approved","routable","rejected","suspended"]},"validation":{"anyOf":[{},{"type":"null"}]},"history":{"type":"array","items":{}}},"required":["id","status","history"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/integrations/adapters/{id}/validate":{"post":{"operationId":"postIntegrationsAdaptersByIdValidate","summary":"Validate an adapter on chain","description":"eth_getCode for every contract, selectors in the ABI (and the bytecode, info only), every read callable, and a dry simulation of each capability with a sample amount.","tags":["Integrations"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,47}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["submitted","validated","approved","routable","rejected","suspended"]},"manifest":{"type":"object","additionalProperties":{}},"submittedBy":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"validation":{},"review":{},"history":{"type":"array","items":{}}},"required":["id","status","manifest","submittedBy","submittedAt","updatedAt","history"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"build","security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]}},"additionalProperties":false}}}}}},"/v1/integrations/manifest":{"get":{"operationId":"getIntegrationsManifest","summary":"The adapter manifest spec and an example","tags":["Integrations"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string"},"verbs":{"type":"array","items":{"type":"string"}},"templates":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"example":{}},"required":["schema","verbs","templates","statuses"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/intents":{"post":{"operationId":"postIntents","summary":"Plan an outcome (a sentence or actions), checked against the Fence","description":"Returns the intent graph, the Fence verdict, the Outrun and the Lykia fee per step. The server never signs. `intent.preflight` lists what will go wrong before anything is signed (lykia.preflight/v1): each finding has a severity (block, warn, note), the figures it used with their source and read time, and fixes computed by code (a `replan` fix carries the sentence and the actions to plan instead). Example: 2 of 2.01 USDC to EURC on Arc leaves no USDC for gas, so a `gas-reserve` warning offers \"Use 1.50 USDC\".","tags":["Intents"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"intent":{"type":"object","properties":{"id":{"type":"string"},"preflight":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable for the same condition"},"check":{"type":"string","enum":["gas-reserve","cash-floor","obligations","dust","insufficient","cost-ratio","price-impact","fx-band","price-stale","quote-age","round-trip","loan-health","vault-state","lp-range","approvals","recipient","bridge-destination","network","duplicate","fence-room","budget","conflict","unpriced","plan-refused"]},"family":{"type":"string","enum":["gas","money","cost","risk","time","address","bridge","network","approval","limits"]},"severity":{"type":"string","enum":["block","warn","note"],"description":"block: cannot be prepared; warn: prepare needs acknowledge: true; note: for the record"},"title":{"type":"string"},"why":{"type":"string"},"say":{"type":"string"},"figures":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"source":{"type":"string"},"readAt":{"type":["string","null"],"description":"ISO time of the read; null for a schedule or a preference"}},"required":["label","value","source","readAt"]}},"change":{"type":"object","properties":{"label":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"}},"required":["label","before","after"]},"fixes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["replan","wait","pause","switch-network","change-fence","add-funds","open"]},"label":{"type":"string","description":"The chip, e.g. \"Use 1.50 USDC\""},"detail":{"type":"string"},"question":{"type":"string"},"sentence":{"type":"string","description":"replan: the sentence to plan instead (POST /v1/intents with text)"},"actions":{"type":"array","items":{},"description":"replan: the same plan as typed actions (POST /v1/intents with actions)"},"path":{"type":"string"},"method":{"type":"string","enum":["get","post"]},"etaSeconds":{"type":"number"},"address":{"type":"string"},"chainId":{"type":"number"},"needsGas":{"type":"boolean","description":"True when the fix is itself a transaction from this wallet"}},"required":["id","kind","label","needsGas"]}},"step":{"type":"string"}},"required":["id","check","family","severity","title","why","say","figures","fixes"]}}},"required":["id"]},"outrun":{"type":"object","properties":{}},"stored":{"type":"boolean"}},"required":["intent","outrun","stored"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"build","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":500},"actions":{"type":"array","items":{},"maxItems":12},"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"fence":{},"signer":{"type":"string","enum":["wallet","agent"]},"agent":{"type":"object","properties":{"address":{"type":"string"},"agentId":{"type":"string","pattern":"^\\d{1,30}$"}},"required":["address"]},"account":{"type":"string","enum":["eoa","smart"]},"dryRun":{"type":"boolean"},"proposedByAgent":{"type":"boolean"},"locale":{"type":"string","enum":["en","tr","es","pt-BR","zh-CN","fr"]}},"required":["owner"]}}}}}},"/v1/intents/{id}":{"get":{"operationId":"getIntentsById","summary":"An intent and its Outrun","tags":["Intents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"intent":{"type":"object","properties":{"id":{"type":"string"},"preflight":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable for the same condition"},"check":{"type":"string","enum":["gas-reserve","cash-floor","obligations","dust","insufficient","cost-ratio","price-impact","fx-band","price-stale","quote-age","round-trip","loan-health","vault-state","lp-range","approvals","recipient","bridge-destination","network","duplicate","fence-room","budget","conflict","unpriced","plan-refused"]},"family":{"type":"string","enum":["gas","money","cost","risk","time","address","bridge","network","approval","limits"]},"severity":{"type":"string","enum":["block","warn","note"],"description":"block: cannot be prepared; warn: prepare needs acknowledge: true; note: for the record"},"title":{"type":"string"},"why":{"type":"string"},"say":{"type":"string"},"figures":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"source":{"type":"string"},"readAt":{"type":["string","null"],"description":"ISO time of the read; null for a schedule or a preference"}},"required":["label","value","source","readAt"]}},"change":{"type":"object","properties":{"label":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"}},"required":["label","before","after"]},"fixes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["replan","wait","pause","switch-network","change-fence","add-funds","open"]},"label":{"type":"string","description":"The chip, e.g. \"Use 1.50 USDC\""},"detail":{"type":"string"},"question":{"type":"string"},"sentence":{"type":"string","description":"replan: the sentence to plan instead (POST /v1/intents with text)"},"actions":{"type":"array","items":{},"description":"replan: the same plan as typed actions (POST /v1/intents with actions)"},"path":{"type":"string"},"method":{"type":"string","enum":["get","post"]},"etaSeconds":{"type":"number"},"address":{"type":"string"},"chainId":{"type":"number"},"needsGas":{"type":"boolean","description":"True when the fix is itself a transaction from this wallet"}},"required":["id","kind","label","needsGas"]}},"step":{"type":"string"}},"required":["id","check","family","severity","title","why","say","figures","fixes"]}}},"required":["id"]},"outrun":{"type":"object","properties":{}},"stored":{"type":"boolean"}},"required":["intent","outrun","stored"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/intents/{id}/outrun":{"get":{"operationId":"getIntentsByIdOutrun","summary":"Where the money is: the Outrun","tags":["Intents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/intents/{id}/preflight":{"get":{"operationId":"getIntentsByIdPreflight","summary":"Preflight read again now: blocks, warnings and notes with their fixes","description":"Balances, gas, prices, Herding and recipients are read again; the findings are stored on the plan. `gate.blocked` means prepare refuses; `gate.needsAck` lists the warnings prepare wants acknowledged.","tags":["Intents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"intentId":{"type":"string"},"at":{"type":"string"},"findings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable for the same condition"},"check":{"type":"string","enum":["gas-reserve","cash-floor","obligations","dust","insufficient","cost-ratio","price-impact","fx-band","price-stale","quote-age","round-trip","loan-health","vault-state","lp-range","approvals","recipient","bridge-destination","network","duplicate","fence-room","budget","conflict","unpriced","plan-refused"]},"family":{"type":"string","enum":["gas","money","cost","risk","time","address","bridge","network","approval","limits"]},"severity":{"type":"string","enum":["block","warn","note"],"description":"block: cannot be prepared; warn: prepare needs acknowledge: true; note: for the record"},"title":{"type":"string"},"why":{"type":"string"},"say":{"type":"string"},"figures":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"source":{"type":"string"},"readAt":{"type":["string","null"],"description":"ISO time of the read; null for a schedule or a preference"}},"required":["label","value","source","readAt"]}},"change":{"type":"object","properties":{"label":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"}},"required":["label","before","after"]},"fixes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["replan","wait","pause","switch-network","change-fence","add-funds","open"]},"label":{"type":"string","description":"The chip, e.g. \"Use 1.50 USDC\""},"detail":{"type":"string"},"question":{"type":"string"},"sentence":{"type":"string","description":"replan: the sentence to plan instead (POST /v1/intents with text)"},"actions":{"type":"array","items":{},"description":"replan: the same plan as typed actions (POST /v1/intents with actions)"},"path":{"type":"string"},"method":{"type":"string","enum":["get","post"]},"etaSeconds":{"type":"number"},"address":{"type":"string"},"chainId":{"type":"number"},"needsGas":{"type":"boolean","description":"True when the fix is itself a transaction from this wallet"}},"required":["id","kind","label","needsGas"]}},"step":{"type":"string"}},"required":["id","check","family","severity","title","why","say","figures","fixes"]}},"gate":{"type":"object","properties":{"blocked":{"type":"boolean"},"needsAck":{"type":"array","items":{"type":"string"}}},"required":["blocked","needsAck"]}},"required":["intentId","at","findings","gate"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/intents/{id}/steps/{sid}/attestation":{"get":{"operationId":"getIntentsByIdStepsBySidAttestation","summary":"The CCTP attestation of a bridge step","tags":["Intents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/intents/{id}/steps/{sid}/prepare":{"post":{"operationId":"postIntentsByIdStepsBySidPrepare","summary":"Unsigned calls, binding and memo for one step (or its whole stage), rebuilt now","description":"Preflight is read again first (while no step has left the wallet): a `block` finding answers 409 PREFLIGHT_BLOCKED with the findings in details; `warn` findings answer 409 PREFLIGHT_ACK_REQUIRED until the call carries `acknowledge: true`; the answer carries `preflight`. A step whose amount is what the step before produced is first planned again with the amount that step's receipt shows (net Transfer logs), never the quote; the answer carries `replanned`. The Fence and the beta cap are evaluated again on the plan as it is now. With `stage: true` an EOA's steps that share the stage come back as one Multicall3From transaction (`stepIds`). A refusal (FENCE_DENIED, NO_ROUTE, INSUFFICIENT_BALANCE) is recorded on the step, so the plan reads as paused there until it is retried.","tags":["Intents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"stepId":{"type":"string"},"transactions":{"type":"array","items":{"type":"object","properties":{}}},"binding":{"type":"string"},"memo":{"type":"string"},"preflight":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable for the same condition"},"check":{"type":"string","enum":["gas-reserve","cash-floor","obligations","dust","insufficient","cost-ratio","price-impact","fx-band","price-stale","quote-age","round-trip","loan-health","vault-state","lp-range","approvals","recipient","bridge-destination","network","duplicate","fence-room","budget","conflict","unpriced","plan-refused"]},"family":{"type":"string","enum":["gas","money","cost","risk","time","address","bridge","network","approval","limits"]},"severity":{"type":"string","enum":["block","warn","note"],"description":"block: cannot be prepared; warn: prepare needs acknowledge: true; note: for the record"},"title":{"type":"string"},"why":{"type":"string"},"say":{"type":"string"},"figures":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"source":{"type":"string"},"readAt":{"type":["string","null"],"description":"ISO time of the read; null for a schedule or a preference"}},"required":["label","value","source","readAt"]}},"change":{"type":"object","properties":{"label":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"}},"required":["label","before","after"]},"fixes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["replan","wait","pause","switch-network","change-fence","add-funds","open"]},"label":{"type":"string","description":"The chip, e.g. \"Use 1.50 USDC\""},"detail":{"type":"string"},"question":{"type":"string"},"sentence":{"type":"string","description":"replan: the sentence to plan instead (POST /v1/intents with text)"},"actions":{"type":"array","items":{},"description":"replan: the same plan as typed actions (POST /v1/intents with actions)"},"path":{"type":"string"},"method":{"type":"string","enum":["get","post"]},"etaSeconds":{"type":"number"},"address":{"type":"string"},"chainId":{"type":"number"},"needsGas":{"type":"boolean","description":"True when the fix is itself a transaction from this wallet"}},"required":["id","kind","label","needsGas"]}},"step":{"type":"string"}},"required":["id","check","family","severity","title","why","say","figures","fixes"]}}},"required":["stepId","transactions","binding","memo"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"build","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"confirm":{"type":"boolean"},"stage":{"type":"boolean","description":"Batch the steps that share this step's stage into one Multicall3From transaction (EOA signers)."},"acknowledge":{"anyOf":[{"type":"boolean"},{"type":"array","items":{"type":"string","maxLength":120},"maxItems":40}],"description":"The owner read the plan's preflight warnings (intent.preflight, severity warn): true for all of them, or the ids of the ones shown. Without it a plan with warnings answers 409 PREFLIGHT_ACK_REQUIRED; a block always answers 409 PREFLIGHT_BLOCKED."}},"default":{}}}}}}},"/v1/intents/{id}/steps/{sid}/retry":{"post":{"operationId":"postIntentsByIdStepsBySidRetry","summary":"Retry a paused step: back to ready with its old calls dropped","description":"For a step refused at prepare or whose transaction reverted (nothing moved). Settled steps stay settled; nothing is signed.","tags":["Intents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"build","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/intents/{id}/steps/{sid}/submit":{"post":{"operationId":"postIntentsByIdStepsBySidSubmit","summary":"Record signed transaction hashes (or a userOpHash) for a step","tags":["Intents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"execute","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"hashes":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"minItems":1,"maxItems":4}},"required":["hashes"]},{"type":"object","properties":{"userOpHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"required":["userOpHash"]}]}}}}}},"/v1/intents/{id}/stop":{"post":{"operationId":"postIntentsByIdStop","summary":"Stop every step that has not started","tags":["Intents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"execute","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/intents/{id}/stream":{"get":{"operationId":"getIntentsByIdStream","summary":"Server-sent events: intent and Outrun updates","tags":["Intents"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/invoices":{"get":{"operationId":"getInvoices","summary":"List invoices","tags":["Invoices"],"parameters":[{"name":"projectId","in":"query","required":false,"schema":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]},"post":{"operationId":"postInvoices","summary":"Create an invoice and its payment link","tags":["Invoices"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"payouts","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"},"environment":{"type":"string","enum":["mainnet","testnet"]},"token":{"type":"string","minLength":2,"maxLength":42},"payee":{"type":"string"},"amount":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,17})(?:\\.\\d{1,18})?$"},"payer":{"type":"string"},"dueDate":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":64},"memo":{"type":"string","maxLength":200},"lineItems":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string","minLength":1,"maxLength":160},"quantity":{"type":"string","maxLength":24},"unitAmount":{"type":"string","maxLength":40}},"required":["description","quantity","unitAmount"]},"maxItems":50},"allowPartial":{"type":"boolean"}},"required":["token","payee"]}}}}}},"/v1/invoices/{id}":{"get":{"operationId":"getInvoicesById","summary":"One invoice with its payments","tags":["Invoices"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^inv_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/invoices/{id}/pay":{"post":{"operationId":"postInvoicesByIdPay","summary":"Plan the payer's transfer (unsigned)","tags":["Invoices"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^inv_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payer":{"type":"string"},"amount":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,17})(?:\\.\\d{1,18})?$"},"account":{"type":"string","enum":["eoa","smart"]}},"required":["payer"]}}}}}},"/v1/invoices/{id}/payments":{"post":{"operationId":"postInvoicesByIdPayments","summary":"Reconcile a payment by transaction hash","tags":["Invoices"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^inv_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"required":["hash"]}}}}}},"/v1/invoices/{id}/public":{"get":{"operationId":"getInvoicesByIdPublic","summary":"What the hosted pay page reads","tags":["Invoices"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^inv_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/invoices/{id}/void":{"post":{"operationId":"postInvoicesByIdVoid","summary":"Void an unpaid invoice","tags":["Invoices"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^inv_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"payouts","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/jobs/{id}":{"get":{"operationId":"getJobsById","summary":"An escrowed job","tags":["Jobs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/jobs/{id}/complete":{"post":{"operationId":"postJobsByIdComplete","summary":"Complete a job (unsigned)","tags":["Jobs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/jobs/{id}/fund":{"post":{"operationId":"postJobsByIdFund","summary":"Fund a job (unsigned)","tags":["Jobs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/jobs/{id}/refund":{"post":{"operationId":"postJobsByIdRefund","summary":"Refund a job (unsigned)","tags":["Jobs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/jobs/{id}/reject":{"post":{"operationId":"postJobsByIdReject","summary":"Reject a job (unsigned)","tags":["Jobs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/jobs/draft":{"post":{"operationId":"postJobsDraft","summary":"Draft an escrowed job","tags":["Jobs"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/developers/keys":{"get":{"operationId":"getDevelopersKeys","summary":"List API keys","tags":["Keys"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"prefix":{"type":"string"},"kind":{"type":"string","enum":["secret","publishable"]},"mode":{"type":"string","enum":["live","test"]},"scopes":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"allowedIps":{"type":"array","items":{"type":"string"}},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"apiVersion":{"type":"string"},"createdAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"previousSecretExpiresAt":{"type":["string","null"]},"projectId":{"type":"string"}},"required":["id","label","prefix","kind","scopes","allowedOrigins","allowedIps","perMinute","perDay","apiVersion","createdAt","revokedAt","lastUsedAt","previousSecretExpiresAt"]}}},"required":["keys"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postDevelopersKeys","summary":"Create an API key (live or test, scopes, IP allowlist, limits, version pin)","tags":["Keys"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"prefix":{"type":"string"},"kind":{"type":"string","enum":["secret","publishable"]},"mode":{"type":"string","enum":["live","test"]},"scopes":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"allowedIps":{"type":"array","items":{"type":"string"}},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"apiVersion":{"type":"string"},"createdAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"previousSecretExpiresAt":{"type":["string","null"]},"projectId":{"type":"string"},"secret":{"type":"string","description":"The full key, shown once."}},"required":["id","label","prefix","kind","scopes","allowedOrigins","allowedIps","perMinute","perDay","apiVersion","createdAt","revokedAt","lastUsedAt","previousSecretExpiresAt","secret"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":48},"kind":{"type":"string","enum":["secret","publishable"],"default":"secret"},"mode":{"type":"string","enum":["live","test"],"description":"live (lk_live_…) or test (lk_test_…, testnet only). Omit for a legacy lk_sk_ key."},"scopes":{"type":"array","items":{"type":"string","enum":["read","quote","build","execute","agents","automation","payouts","admin","plan","webhooks"]},"minItems":1,"maxItems":10},"allowedOrigins":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":10},"allowedIps":{"type":"array","items":{"type":"string","minLength":2,"maxLength":64,"description":"An IPv4/IPv6 address or a CIDR range"},"maxItems":20},"perMinute":{"type":"integer","minimum":1,"maximum":6000},"perDay":{"type":"integer","minimum":1,"maximum":5000000},"apiVersion":{"type":"string","enum":["2026-06-01","2026-11-01"]},"projectId":{"type":"string","pattern":"^prj_[a-z0-9]{12}$","description":"Bind a secret key to one of your projects: the project's Fence and limits apply, and the key may act for owners who granted that project consent (POST /v1/consents)."}},"required":["label"]}}}}}},"/v1/developers/keys/{id}":{"get":{"operationId":"getDevelopersKeysById","summary":"One API key","tags":["Keys"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"prefix":{"type":"string"},"kind":{"type":"string","enum":["secret","publishable"]},"mode":{"type":"string","enum":["live","test"]},"scopes":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"allowedIps":{"type":"array","items":{"type":"string"}},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"apiVersion":{"type":"string"},"createdAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"previousSecretExpiresAt":{"type":["string","null"]},"projectId":{"type":"string"}},"required":["id","label","prefix","kind","scopes","allowedOrigins","allowedIps","perMinute","perDay","apiVersion","createdAt","revokedAt","lastUsedAt","previousSecretExpiresAt"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"patch":{"operationId":"patchDevelopersKeysById","summary":"Change a key's label, scopes, IP allowlist, origins, limits or version pin","tags":["Keys"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"prefix":{"type":"string"},"kind":{"type":"string","enum":["secret","publishable"]},"mode":{"type":"string","enum":["live","test"]},"scopes":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"allowedIps":{"type":"array","items":{"type":"string"}},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"apiVersion":{"type":"string"},"createdAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"previousSecretExpiresAt":{"type":["string","null"]},"projectId":{"type":"string"}},"required":["id","label","prefix","kind","scopes","allowedOrigins","allowedIps","perMinute","perDay","apiVersion","createdAt","revokedAt","lastUsedAt","previousSecretExpiresAt"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":48},"scopes":{"type":"array","items":{"type":"string","enum":["read","quote","build","execute","agents","automation","payouts","admin","plan","webhooks"]},"minItems":1,"maxItems":10},"allowedOrigins":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":10},"allowedIps":{"type":"array","items":{"type":"string","minLength":2,"maxLength":64,"description":"An IPv4/IPv6 address or a CIDR range"},"maxItems":20},"perMinute":{"type":"integer","minimum":1,"maximum":6000},"perDay":{"type":"integer","minimum":1,"maximum":5000000},"apiVersion":{"type":"string","enum":["2026-06-01","2026-11-01"]}}}}}}}},"/v1/developers/keys/{id}/revoke":{"post":{"operationId":"postDevelopersKeysByIdRevoke","summary":"Revoke a key (immediate, including any rotation overlap)","tags":["Keys"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"prefix":{"type":"string"},"kind":{"type":"string","enum":["secret","publishable"]},"mode":{"type":"string","enum":["live","test"]},"scopes":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"allowedIps":{"type":"array","items":{"type":"string"}},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"apiVersion":{"type":"string"},"createdAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"previousSecretExpiresAt":{"type":["string","null"]},"projectId":{"type":"string"}},"required":["id","label","prefix","kind","scopes","allowedOrigins","allowedIps","perMinute","perDay","apiVersion","createdAt","revokedAt","lastUsedAt","previousSecretExpiresAt"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/developers/keys/{id}/rotate":{"post":{"operationId":"postDevelopersKeysByIdRotate","summary":"Rotate a key: a new secret now, the old one keeps working for overlapSeconds (default 86400)","tags":["Keys"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"prefix":{"type":"string"},"kind":{"type":"string","enum":["secret","publishable"]},"mode":{"type":"string","enum":["live","test"]},"scopes":{"type":"array","items":{"type":"string"}},"allowedOrigins":{"type":"array","items":{"type":"string"}},"allowedIps":{"type":"array","items":{"type":"string"}},"perMinute":{"type":"integer"},"perDay":{"type":"integer"},"apiVersion":{"type":"string"},"createdAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"previousSecretExpiresAt":{"type":["string","null"]},"projectId":{"type":"string"},"secret":{"type":"string","description":"The full key, shown once."}},"required":["id","label","prefix","kind","scopes","allowedOrigins","allowedIps","perMinute","perDay","apiVersion","createdAt","revokedAt","lastUsedAt","previousSecretExpiresAt","secret"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"overlapSeconds":{"type":"integer","minimum":0,"maximum":604800}}}}}}}},"/v1/capabilities":{"get":{"operationId":"getCapabilities","summary":"What Lyko can do: every action with the venues it routes through, bridge destinations per route, what each token can do, and the features to reach for","description":"Built from the engine's executable venues, the CCTP, Across, Relay and Gateway route tables and the routable adapter manifests, so it changes when an adapter or venue is added. Lyko reads the same map (its `capabilities` tool).","tags":["Knowledge"],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/knowledge":{"get":{"operationId":"getKnowledge","summary":"Lyko's knowledge of Arc venues, contracts and paths","tags":["Knowledge"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/knowledge/contracts/{address}":{"get":{"operationId":"getKnowledgeContractsByAddress","summary":"What Lykia knows about a contract","tags":["Knowledge"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/knowledge/paths":{"get":{"operationId":"getKnowledgePaths","summary":"Known paths between assets","tags":["Knowledge"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/knowledge/venues/{venue}":{"get":{"operationId":"getKnowledgeVenuesByVenue","summary":"What Lykia knows about a venue","tags":["Knowledge"],"parameters":[{"name":"venue","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/language/parse":{"post":{"operationId":"postLanguageParse","summary":"Read a sentence into typed actions","tags":["Language"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":500},"environment":{"type":"string","enum":["mainnet","testnet"]},"owner":{"type":"string"}},"required":["text"]}}}}}},"/v1/admin/league":{"get":{"operationId":"getAdminLeague","summary":"Admin: every League entry, requests first, and which official cities exist","tags":["League"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/admin/league/seed":{"post":{"operationId":"postAdminLeagueSeed","summary":"Admin: create the official cities that are missing (idempotent, owned by the first admin address)","tags":["League"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":["string","null"]},"cities":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"projectId":{"type":"string"},"name":{"type":"string"},"outcome":{"type":"string","enum":["created","present","missing"]}},"required":["key","projectId","name","outcome"]}}},"required":["owner","cities"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/league":{"get":{"operationId":"getLeague","summary":"The League: listed cities (Lykia's sub-products and approved community projects) with their public project view and live usage","tags":["League"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"cities":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"league":{"type":"object","properties":{"status":{"type":"string","enum":["official","community"]},"state":{"type":"string","enum":["live","coming","paused"]},"featured":{"type":"boolean"},"slug":{"type":"string"},"emblem":{"type":"string","enum":["lighthouse","temple","prow","lyre","triskeles","flame"]},"tagline":{"type":"string"},"category":{"type":"string","enum":["payments","agents","trading","treasury","commerce","tools"]},"codename":{"type":["string","null"]},"codenameNote":{"type":["string","null"]},"note":{"type":["string","null"]},"does":{"type":"array","items":{"type":"string"}},"pages":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"href":{"type":"string"}},"required":["label","href"]}}},"required":["status","state","featured","slug","emblem","tagline","category","codename","codenameNote","note","does","pages"]},"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"modules":{"type":"array","items":{"type":"string"}},"network":{"type":"string","enum":["mainnet","testnet"]},"assistantName":{"type":"string"}},"required":["id","name","modules","network","assistantName"]},"usage":{"type":"object","properties":{"today":{"type":"object","properties":{"requests":{"type":"integer"},"plans":{"type":"integer"}},"required":["requests","plans"]},"last7Days":{"type":"object","properties":{"requests":{"type":"integer"},"plans":{"type":"integer"}},"required":["requests","plans"]}},"required":["today","last7Days"]}},"required":["slug","league","project","usage"]}}},"required":["cities"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/league/{id}":{"put":{"operationId":"putLeagueById","summary":"Admin: approve, reject, feature, unfeature, delist, relist, pause, resume or launch a city (audited)","tags":["League"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["approve","reject","feature","unfeature","delist","relist","pause","resume","launch"]},"note":{"type":"string","maxLength":200}},"required":["action"],"additionalProperties":false}}}}}},"/v1/league/{slug}":{"get":{"operationId":"getLeagueBySlug","summary":"One listed city","tags":["League"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,22}[a-z0-9]$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"league":{"type":"object","properties":{"status":{"type":"string","enum":["official","community"]},"state":{"type":"string","enum":["live","coming","paused"]},"featured":{"type":"boolean"},"slug":{"type":"string"},"emblem":{"type":"string","enum":["lighthouse","temple","prow","lyre","triskeles","flame"]},"tagline":{"type":"string"},"category":{"type":"string","enum":["payments","agents","trading","treasury","commerce","tools"]},"codename":{"type":["string","null"]},"codenameNote":{"type":["string","null"]},"note":{"type":["string","null"]},"does":{"type":"array","items":{"type":"string"}},"pages":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"href":{"type":"string"}},"required":["label","href"]}}},"required":["status","state","featured","slug","emblem","tagline","category","codename","codenameNote","note","does","pages"]},"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"modules":{"type":"array","items":{"type":"string"}},"network":{"type":"string","enum":["mainnet","testnet"]},"assistantName":{"type":"string"}},"required":["id","name","modules","network","assistantName"]},"usage":{"type":"object","properties":{"today":{"type":"object","properties":{"requests":{"type":"integer"},"plans":{"type":"integer"}},"required":["requests","plans"]},"last7Days":{"type":"object","properties":{"requests":{"type":"integer"},"plans":{"type":"integer"}},"required":["requests","plans"]}},"required":["today","last7Days"]}},"required":["slug","league","project","usage"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/league/by-host":{"get":{"operationId":"getLeagueByHost","summary":"A listed city by one of its verified custom domains","tags":["League"],"parameters":[{"name":"host","in":"query","required":true,"schema":{"type":"string","maxLength":253,"pattern":"^[a-z0-9.-]+$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"league":{"type":"object","properties":{"status":{"type":"string","enum":["official","community"]},"state":{"type":"string","enum":["live","coming","paused"]},"featured":{"type":"boolean"},"slug":{"type":"string"},"emblem":{"type":"string","enum":["lighthouse","temple","prow","lyre","triskeles","flame"]},"tagline":{"type":"string"},"category":{"type":"string","enum":["payments","agents","trading","treasury","commerce","tools"]},"codename":{"type":["string","null"]},"codenameNote":{"type":["string","null"]},"note":{"type":["string","null"]},"does":{"type":"array","items":{"type":"string"}},"pages":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"href":{"type":"string"}},"required":["label","href"]}}},"required":["status","state","featured","slug","emblem","tagline","category","codename","codenameNote","note","does","pages"]},"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"modules":{"type":"array","items":{"type":"string"}},"network":{"type":"string","enum":["mainnet","testnet"]},"assistantName":{"type":"string"}},"required":["id","name","modules","network","assistantName"]},"usage":{"type":"object","properties":{"today":{"type":"object","properties":{"requests":{"type":"integer"},"plans":{"type":"integer"}},"required":["requests","plans"]},"last7Days":{"type":"object","properties":{"requests":{"type":"integer"},"plans":{"type":"integer"}},"required":["requests","plans"]}},"required":["today","last7Days"]}},"required":["slug","league","project","usage"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/league/by-slug/{slug}":{"get":{"operationId":"getLeagueBySlugBySlug","summary":"A listed city by its project slug: what <slug>.<root domain> and /c/<slug> load","tags":["League"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,22}[a-z0-9]$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"league":{"type":"object","properties":{"status":{"type":"string","enum":["official","community"]},"state":{"type":"string","enum":["live","coming","paused"]},"featured":{"type":"boolean"},"slug":{"type":"string"},"emblem":{"type":"string","enum":["lighthouse","temple","prow","lyre","triskeles","flame"]},"tagline":{"type":"string"},"category":{"type":"string","enum":["payments","agents","trading","treasury","commerce","tools"]},"codename":{"type":["string","null"]},"codenameNote":{"type":["string","null"]},"note":{"type":["string","null"]},"does":{"type":"array","items":{"type":"string"}},"pages":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"href":{"type":"string"}},"required":["label","href"]}}},"required":["status","state","featured","slug","emblem","tagline","category","codename","codenameNote","note","does","pages"]},"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"modules":{"type":"array","items":{"type":"string"}},"network":{"type":"string","enum":["mainnet","testnet"]},"assistantName":{"type":"string"}},"required":["id","name","modules","network","assistantName"]},"usage":{"type":"object","properties":{"today":{"type":"object","properties":{"requests":{"type":"integer"},"plans":{"type":"integer"}},"required":["requests","plans"]},"last7Days":{"type":"object","properties":{"requests":{"type":"integer"},"plans":{"type":"integer"}},"required":["requests","plans"]}},"required":["today","last7Days"]}},"required":["slug","league","project","usage"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/projects/{id}/league/request":{"post":{"operationId":"postProjectsByIdLeagueRequest","summary":"Ask for a community listing of your project; an admin reviews it","tags":["League"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tagline":{"type":"string","minLength":8,"maxLength":90},"category":{"type":"string","enum":["payments","agents","trading","treasury","commerce","tools"]},"emblem":{"type":"string","enum":["lighthouse","temple","prow","lyre","triskeles","flame"]},"slug":{"type":"string","maxLength":32},"codename":{"type":"string","maxLength":24}},"required":["tagline","category"],"additionalProperties":false}}}}}},"/v1/leashes":{"get":{"operationId":"getLeashes","summary":"List an owner's leashes","description":"Each with live usage: spendable() and getLimit() read from the LykiaAccount are authoritative; Lykia's records count when larger.","tags":["Leashes"],"parameters":[{"name":"owner","in":"query","required":false,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]},"post":{"operationId":"postLeashes","summary":"Put an agent on a leash","description":"One call: a Pack agent whose Fence is a strict subset of its parent's, a daily budget carved from the parent, the unsigned LykiaAccount session transaction (createSession from the owner, or createSubSession from the parent agent's session key) with per-token caps, payees, call rules, expiry and the Fence hash, a leash key shown once, a ready MCP config and optionally an ERC-8004 Tag registration. With spendFrom gateway the money is the owner's Circle Gateway balance: the response carries the owner's LykiaStile (its creation when there is none), addDelegate on Gateway Wallet and createSession on the Stile instead of a LykiaAccount session. Owner only: a Lykia-Session, or a secret key with the agents scope that may act for the owner.","tags":["Leashes"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"Defaults to the signed-in address; required with a project key acting through consent."},"environment":{"type":"string","enum":["mainnet","testnet"]},"agent":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":48},"mission":{"type":"string","maxLength":400},"signer":{"type":"string","description":"The agent's own address: it becomes the LykiaAccount session key. Lykia never sees its private key."}},"required":["name","signer"]},"parentAgentId":{"type":"string","minLength":8,"maxLength":120,"description":"A Pack agent to carve the leash from (its Fence and budget bound the leash)."},"name":{"type":"string","minLength":1,"maxLength":48,"description":"With parentAgentId: the new sub-agent's name."},"signer":{"type":"string","description":"With parentAgentId: the new sub-agent's session key address."},"template":{"type":"string","enum":["pay-invoices","trade-small","earn","custom"]},"fence":{"type":"object","additionalProperties":{},"description":"\"custom\" only: a lykia.fence/v1 document."},"budget":{"type":"object","properties":{"perStepUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"perDayUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"totalUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"}},"required":["perStepUsd","perDayUsd","totalUsd"]},"expiresAt":{"type":"string","maxLength":40},"venues":{"type":"array","items":{"type":"string","minLength":2,"maxLength":48},"maxItems":20},"recipients":{"type":"array","items":{"type":"string"},"maxItems":25},"maxSlippageBps":{"type":"integer","minimum":0,"maximum":300},"tools":{"type":"array","items":{"type":"string","enum":["plan","submit","status","trail","venues","scent"]},"maxItems":6},"maxCalls":{"type":"integer","minimum":1,"maximum":10000},"tag":{"type":"boolean"},"spendFrom":{"type":"string","enum":["arc","gateway"],"description":"\"arc\" (default): the owner's LykiaAccount on Arc. \"gateway\": the owner's Circle Gateway balance through LykiaStile, where it is switched on (see GET /v1/leashes/templates)."},"destinations":{"type":"array","items":{"type":"string","minLength":2,"maxLength":24},"minItems":1,"maxItems":16,"description":"\"gateway\" only: Gateway chains the agent may pay to, e.g. [\"arc\", \"base\"]."},"maxGatewayFeeUsd":{"type":"string","maxLength":12,"description":"\"gateway\" only: Circle's fee per burn intent the session allows (default $0.10, at most $5)."}},"required":["budget","expiresAt"]}}}}}},"/v1/leashes/{id}":{"get":{"operationId":"getLeashesById","summary":"One leash with usage","description":"The owner, or the leash's own key.","tags":["Leashes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^lsh_[a-f0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"read","security":[{"LykiaKey":[]},{}]}},"/v1/leashes/{id}/plan":{"post":{"operationId":"postLeashesByIdPlan","summary":"Plan inside a leash","description":"For the leash key. The Fence with the leash's own spend, the leash's total, spendable() per token and the session's call rules and payees on chain, then a simulation from the session key. Inside: the intent and its first step as one transaction for the session key. Outside: 422 LEASH_DENIED with reason codes and the remaining budget. A Gateway leash plans one transfer: the burn intents (payment and Lykia's fee leg) and the reserve transaction on the owner's LykiaStile, in prepared.gateway.","tags":["Leashes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^lsh_[a-f0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"build","security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":500},"actions":{"type":"array","items":{},"maxItems":12},"dryRun":{"type":"boolean"},"forward":{"type":"boolean","description":"Gateway leashes: ask Circle's Forwarding Service to submit the mint on the destination (its fee comes from Gateway's estimate)."}}}}}}}},"/v1/leashes/{id}/renew":{"post":{"operationId":"postLeashesByIdRenew","summary":"Renew a leash","description":"A new carve, a new session and a new key; the old leash is revoked. Never an increase in place.","tags":["Leashes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^lsh_[a-f0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"201":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"agents","security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"budget":{"type":"object","properties":{"perStepUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"perDayUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"},"totalUsd":{"type":"string","pattern":"^\\d{1,12}(?:\\.\\d{1,2})?$"}},"required":["perStepUsd","perDayUsd","totalUsd"]},"expiresAt":{"type":"string","maxLength":40},"recipients":{"type":"array","items":{"type":"string"},"maxItems":25},"venues":{"type":"array","items":{"type":"string","minLength":2,"maxLength":48},"maxItems":20},"signer":{"type":"string"}},"required":["expiresAt"]}}}}}},"/v1/leashes/{id}/revoke":{"post":{"operationId":"postLeashesByIdRevoke","summary":"Revoke a leash","description":"The leash key stops working at once and the carve returns to the parent. Returns the unsigned revokeSession(id) for the owner's wallet; once signed the session and every sub-session under it end on chain.","tags":["Leashes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^lsh_[a-f0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"agents","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/leashes/{id}/session":{"post":{"operationId":"postLeashesByIdSession","summary":"Bind the on-chain session","description":"With txHash: read from its SessionCreated event. Without: found among the session ids issued since the leash was made.","tags":["Leashes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^lsh_[a-f0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"agents","security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"txHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}}}}}}}},"/v1/leashes/{id}/submit":{"post":{"operationId":"postLeashesByIdSubmit","summary":"Report a signed leash step","description":"The hash of the transaction the session key sent. Checked against the prepared one, settled from its receipt, counted against the leash; the next step comes back prepared. For a Gateway leash the reservation is proven from its Reserved event, then the burn intents go to Gateway's /v1/transfer with contractSigner true; the attestation and the unsigned gatewayMint come back (status pending while Gateway cannot see the reservation yet: submit the same hash again).","tags":["Leashes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^lsh_[a-f0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"execute","security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"intentId":{"type":"string","pattern":"^out_[A-Za-z0-9_-]{6,32}$"},"stepId":{"type":"string","pattern":"^s\\d{1,2}$"},"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"required":["intentId","stepId","hash"]}}}}}},"/v1/leashes/{id}/trail":{"get":{"operationId":"getLeashesByIdTrail","summary":"Everything done under a leash","description":"Plans, denials and transactions, each cross-checked with the chain: chain-proven when the receipt succeeded, carries AgentCall or AgentTransfer for the session and its AgentMemo names the same intent, step and verdict. Session events Lykia has no record of are listed as source chain.","tags":["Leashes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^lsh_[a-f0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"read","security":[{"LykiaKey":[]},{}]}},"/v1/leashes/templates":{"get":{"operationId":"getLeashesTemplates","summary":"Leash templates and the enforcement split","description":"pay-invoices, trade-small, earn and custom, with what LykiaAccount enforces on chain and what the API enforces; and, for spending from a Gateway balance through LykiaStile, where it is available, its destinations, ceilings and enforcement split.","tags":["Leashes"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/logs":{"get":{"operationId":"getLogs","summary":"Request logs of the account's keys, newest first","tags":["Logs"],"parameters":[{"name":"keyId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9]{12}$"}},{"name":"projectId","in":"query","required":false,"schema":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","pattern":"^-?\\d{1,15}$"}},{"name":"statusClass","in":"query","required":false,"schema":{"type":"string","enum":["2xx","3xx","4xx","5xx","error"]}},{"name":"method","in":"query","required":false,"schema":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE","get","post","put","patch","delete"]}},{"name":"path","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time","description":"Only entries newer than this time (for tailing)."},"description":"Only entries newer than this time (for tailing)."},{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^-?\\d{1,15}$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"requestId":{"type":"string"},"at":{"type":"string"},"method":{"type":"string"},"path":{"type":"string"},"route":{"type":["string","null"]},"status":{"type":"integer"},"latencyMs":{"type":"integer"},"errorCode":{"type":["string","null"]},"keyId":{"type":["string","null"]},"projectId":{"type":["string","null"]},"mode":{"anyOf":[{"type":"string","enum":["live","test"]},{"type":"null"}]},"apiVersion":{"type":"string"},"idempotentReplay":{"type":"boolean"}},"required":["requestId","at","method","path","route","status","latencyMs","errorCode","keyId","projectId","mode","apiVersion","idempotentReplay"]}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"read","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/logs/{requestId}":{"get":{"operationId":"getLogsByRequestId","summary":"One logged request by X-Request-Id","tags":["Logs"],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string"},"at":{"type":"string"},"method":{"type":"string"},"path":{"type":"string"},"route":{"type":["string","null"]},"status":{"type":"integer"},"latencyMs":{"type":"integer"},"errorCode":{"type":["string","null"]},"keyId":{"type":["string","null"]},"projectId":{"type":["string","null"]},"mode":{"anyOf":[{"type":"string","enum":["live","test"]},{"type":"null"}]},"apiVersion":{"type":"string"},"idempotentReplay":{"type":"boolean"}},"required":["requestId","at","method","path","route","status","latencyMs","errorCode","keyId","projectId","mode","apiVersion","idempotentReplay"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"read","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/mcp":{"delete":{"operationId":"deleteMcp","summary":"Close an MCP session","tags":["MCP"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]},"get":{"operationId":"getMcp","summary":"MCP session stream","tags":["MCP"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]},"post":{"operationId":"postMcp","summary":"Model Context Protocol (streamable HTTP): plan, Scent, Flock, Fence and more as tools","description":"Point any MCP client (IDE assistants, desktop chat apps, agent SDKs) at /v1/mcp with a Lykia-Key header.","tags":["MCP"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"build","security":[{"LykiaKey":[]},{}]}},"/v1/orders":{"get":{"operationId":"getOrders","summary":"Limit orders of an owner","tags":["Orders"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]},"post":{"operationId":"postOrders","summary":"Place a signed limit order","tags":["Orders"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/orders/{hash}/cancel-tx":{"get":{"operationId":"getOrdersByHashCancelTx","summary":"The unsigned cancel transaction","tags":["Orders"],"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/orders/{hash}/execute-tx":{"get":{"operationId":"getOrdersByHashExecuteTx","summary":"The unsigned execute transaction","tags":["Orders"],"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/orders/config":{"get":{"operationId":"getOrdersConfig","summary":"Limit order configuration","tags":["Orders"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/orders/draft":{"post":{"operationId":"postOrdersDraft","summary":"Draft a limit order for signing","tags":["Orders"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/pack":{"get":{"operationId":"getPack","summary":"An owner's Pack of agents","tags":["Pack"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]},"post":{"operationId":"postPack","summary":"Add an agent to the Pack","tags":["Pack"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"name":{"type":"string"},"role":{"type":"string"}},"required":["owner","name","role"]}}}}}},"/v1/pack/{id}":{"get":{"operationId":"getPackById","summary":"One agent","tags":["Pack"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/pack/{id}/budget":{"get":{"operationId":"getPackByIdBudget","summary":"An agent's budget and spend","tags":["Pack"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/pack/{id}/pause":{"post":{"operationId":"postPackByIdPause","summary":"Pause an agent","tags":["Pack"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/pack/{id}/resume":{"post":{"operationId":"postPackByIdResume","summary":"Resume an agent","tags":["Pack"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/pack/{id}/revoke":{"post":{"operationId":"postPackByIdRevoke","summary":"Revoke an agent and its sub-agents","tags":["Pack"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/pack/{id}/session":{"post":{"operationId":"postPackByIdSession","summary":"Record an agent's on-chain session","tags":["Pack"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/pack/{id}/session-tx":{"post":{"operationId":"postPackByIdSessionTx","summary":"The unsigned sub-session transaction for an agent","tags":["Pack"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/pack/{id}/spawn":{"post":{"operationId":"postPackByIdSpawn","summary":"Spawn a sub-agent inside the parent's Fence","tags":["Pack"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}]}},"/v1/pack/account":{"get":{"operationId":"getPackAccount","summary":"The owner's LykiaAccount","tags":["Pack"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","security":[{"LykiaKey":[]},{}]}},"/v1/pack/whistle":{"post":{"operationId":"postPackWhistle","summary":"Blow the Whistle: stop all new risk","tags":["Pack"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"agents","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"reason":{"type":"string"}},"required":["owner"]}}}}}},"/v1/whistle":{"get":{"operationId":"getWhistle","summary":"What the Whistle holds for the owner: every automation, standing order, agent automation, Pack agent, leash and Autopilot it stopped, each with its state","tags":["Pack"],"parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"blownAt":{"type":["string","null"]},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["automation","standing","agent-automation","agent","leash","autopilot","alert"]},"id":{"type":"string"},"label":{"type":"string"},"environment":{"type":["string","null"]},"state":{"type":"string","enum":["paused","resumed"]}},"required":["kind","id","label","environment","state"]}},"transaction":{"type":["object","null"],"properties":{"chainId":{"type":"number"},"from":{"type":"string"},"to":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"},"label":{"type":"string"}},"required":["chainId","from","to","data","value","label"]},"account":{"type":["string","null"]},"counts":{"type":"object","additionalProperties":{"type":"number"}},"note":{"type":"string"}},"required":["owner","blownAt","items","transaction","account","counts","note"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postWhistle","summary":"Blow the Whistle: pause every automation, standing order and recurring payment, agent automation, Pack agent, leash (its key is refused) and Autopilot for the owner, on the server, at once. Returns exactly what was stopped and the unsigned blowWhistle() for the owner's LykiaAccount when it exists","tags":["Pack"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"blownAt":{"type":["string","null"]},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["automation","standing","agent-automation","agent","leash","autopilot","alert"]},"id":{"type":"string"},"label":{"type":"string"},"environment":{"type":["string","null"]},"state":{"type":"string","enum":["paused","resumed"]}},"required":["kind","id","label","environment","state"]}},"transaction":{"type":["object","null"],"properties":{"chainId":{"type":"number"},"from":{"type":"string"},"to":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"},"label":{"type":"string"}},"required":["chainId","from","to","data","value","label"]},"account":{"type":["string","null"]},"counts":{"type":"object","additionalProperties":{"type":"number"}},"note":{"type":"string"}},"required":["owner","blownAt","items","transaction","account","counts","note"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"reason":{"type":"string","maxLength":300}},"required":["owner"]}}}}}},"/v1/whistle/resume":{"post":{"operationId":"postWhistleResume","summary":"Let one item the Whistle stopped run again ({ kind, id }), or every item when none is named. Things that were paused before the Whistle stay paused","tags":["Pack"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"blownAt":{"type":["string","null"]},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["automation","standing","agent-automation","agent","leash","autopilot","alert"]},"id":{"type":"string"},"label":{"type":"string"},"environment":{"type":["string","null"]},"state":{"type":"string","enum":["paused","resumed"]}},"required":["kind","id","label","environment","state"]}},"transaction":{"type":["object","null"],"properties":{"chainId":{"type":"number"},"from":{"type":"string"},"to":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"},"label":{"type":"string"}},"required":["chainId","from","to","data","value","label"]},"account":{"type":["string","null"]},"counts":{"type":"object","additionalProperties":{"type":"number"}},"note":{"type":"string"}},"required":["owner","blownAt","items","transaction","account","counts","note"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string"},"environment":{"type":"string","enum":["mainnet","testnet"]},"kind":{"type":"string","enum":["automation","standing","agent-automation","agent","leash","autopilot","alert"]},"id":{"type":"string","minLength":1,"maxLength":160}},"required":["owner"]}}}}}},"/v1/payouts":{"get":{"operationId":"getPayouts","summary":"List payouts","tags":["Payouts"],"parameters":[{"name":"projectId","in":"query","required":false,"schema":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]},"post":{"operationId":"postPayouts","summary":"Create a payout batch","description":"Up to 100 rows (token, amount, reference, memo each). Checked by the security layer, the payer's balances, the Fence and the beta cap; built as Multicall3From batches with an Arc Memo per transfer.","tags":["Payouts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"payouts","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payer":{"type":"string","description":"The paying wallet. Required unless circleWalletId is given; with it, the payer is that wallet's own address."},"projectId":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"},"environment":{"type":"string","enum":["mainnet","testnet"]},"fence":{"type":"object","additionalProperties":{},"description":"A lykia.fence/v1 document (see /v1/fence/templates)."},"circleWalletId":{"type":"string","format":"uuid","description":"Opt-in servers only (LYKIA_CIRCLE_SERVER_WALLETS): execute from a Circle developer-controlled wallet you created through POST /v1/circle/wallets/agent. Its address becomes the payer; a wallet someone else created is refused."},"dryRun":{"type":"boolean"},"confirm":{"type":"boolean"},"rows":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string","maxLength":42},"token":{"type":"string","minLength":2,"maxLength":42},"amount":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":64},"memo":{"type":"string","maxLength":120}},"required":["to","token","amount"]},"minItems":1,"maxItems":100}},"required":["rows"]}}}}}},"/v1/payouts/{id}":{"get":{"operationId":"getPayoutsById","summary":"Payout status, row by row","tags":["Payouts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^po_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/payouts/{id}/batches/{index}/submit":{"post":{"operationId":"postPayoutsByIdBatchesByIndexSubmit","summary":"Report a broadcast batch","description":"The transaction must be exactly the prepared batch; rows settle from the receipt's Memo events.","tags":["Payouts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^po_[a-z0-9]{12}$"}},{"name":"index","in":"path","required":true,"schema":{"type":"integer","minimum":0,"maximum":99}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"payouts","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"required":["hash"]}}}}}},"/v1/payouts/{id}/execute":{"post":{"operationId":"postPayoutsByIdExecute","summary":"Execute from the payout's Circle developer-controlled wallet","tags":["Payouts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^po_[a-z0-9]{12}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"payouts","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/payouts/import":{"post":{"operationId":"postPayoutsImport","summary":"Create a payout from CSV","description":"Columns: to, token, amount, reference, memo (header optional).","tags":["Payouts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"payouts","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payer":{"type":"string","description":"The paying wallet. Required unless circleWalletId is given; with it, the payer is that wallet's own address."},"projectId":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"},"environment":{"type":"string","enum":["mainnet","testnet"]},"fence":{"type":"object","additionalProperties":{},"description":"A lykia.fence/v1 document (see /v1/fence/templates)."},"circleWalletId":{"type":"string","format":"uuid","description":"Opt-in servers only (LYKIA_CIRCLE_SERVER_WALLETS): execute from a Circle developer-controlled wallet you created through POST /v1/circle/wallets/agent. Its address becomes the payer; a wallet someone else created is refused."},"dryRun":{"type":"boolean"},"confirm":{"type":"boolean"},"csv":{"type":"string","minLength":1,"maxLength":65536}},"required":["csv"]}}}}}},"/v1/payouts/parse-csv":{"post":{"operationId":"postPayoutsParseCsv","summary":"Preview a payout CSV","tags":["Payouts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","x-lykia-scope":"read","security":[{"LykiaKey":[]},{"LykiaSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"csv":{"type":"string"}},"required":["csv"]}}}}}},"/v1/reconcile/tick":{"post":{"operationId":"postReconcileTick","summary":"One full background pass: standing orders, conditional orders, alerts, webhook retries, payout receipts, invoice memos and automations","description":"For external pingers on serverless hosts: send Authorization: Bearer $CRON_SECRET (or an admin session). Idempotent; ping it as often as schedules must hold.","tags":["Payouts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"secret","security":[{"LykiaKey":[]},{"LykiaSession":[]}]}},"/v1/contacts":{"get":{"operationId":"getContacts","summary":"Contacts","tags":["Personal"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postContacts","summary":"Add a contact","tags":["Personal"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"aliases":{"type":"array","items":{"type":"string"}},"note":{"type":"string"}},"required":["name","address"]}}}}}},"/v1/contacts/{id}":{"delete":{"operationId":"deleteContactsById","summary":"Delete a contact","tags":["Personal"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"put":{"operationId":"putContactsById","summary":"Update a contact","tags":["Personal"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"aliases":{"type":"array","items":{"type":"string"}},"note":{"type":"string"}},"required":["name","address"]}}}}}},"/v1/memory":{"get":{"operationId":"getMemory","summary":"What Lyko remembers","tags":["Personal"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/memory/{id}":{"delete":{"operationId":"deleteMemoryById","summary":"Forget one item","tags":["Personal"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/memory/export":{"get":{"operationId":"getMemoryExport","summary":"Export memory","tags":["Personal"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/memory/forget":{"post":{"operationId":"postMemoryForget","summary":"Forget intents, contacts or everything","tags":["Personal"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"what":{"type":"string","enum":["intents","contacts","all"]}}}}}}}},"/v1/memory/intents":{"get":{"operationId":"getMemoryIntents","summary":"Remembered plans","tags":["Personal"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/profile":{"delete":{"operationId":"deleteProfile","summary":"Reset the profile","tags":["Personal"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"get":{"operationId":"getProfile","summary":"The owner's profile","tags":["Personal"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"put":{"operationId":"putProfile","summary":"Update the profile (never loosens a Fence)","tags":["Personal"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/openapi.json":{"get":{"operationId":"getOpenapiJson","summary":"This OpenAPI 3.1 document","tags":["Platform"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/reference":{"get":{"operationId":"getReference","summary":"The API reference as a web page","tags":["Platform"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/versions":{"get":{"operationId":"getVersions","summary":"Dated API versions (send one as Lykia-Version)","tags":["Platform"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"latest":{"type":"string"},"versions":{"type":"array","items":{"type":"string"}},"header":{"const":"Lykia-Version"}},"required":["latest","versions","header"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/projects":{"get":{"operationId":"getProjects","summary":"The developer's projects","tags":["Projects"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postProjects","summary":"Create a white-label project","tags":["Projects"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"origins":{"type":"array","items":{"type":"string"}},"modules":{"type":"array","items":{"type":"string"}},"network":{"type":"string","enum":["mainnet","testnet"]}},"required":["name"]}}}}}},"/v1/projects/{id}":{"delete":{"operationId":"deleteProjectsById","summary":"Delete a project","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"get":{"operationId":"getProjectsById","summary":"A project (owner view)","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"patch":{"operationId":"patchProjectsById","summary":"Update a project","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/projects/{id}/fence":{"get":{"operationId":"getProjectsByIdFence","summary":"The project's default Fence","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/projects/{id}/keys":{"get":{"operationId":"getProjectsByIdKeys","summary":"The project's publishable keys","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postProjectsByIdKeys","summary":"Issue a publishable key bound to the project's origins","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":48}},"required":["label"]}}}}}},"/v1/projects/{id}/limits":{"get":{"operationId":"getProjectsByIdLimits","summary":"A project's rate limits","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"perMinute":{"type":"integer"},"perDay":{"type":"integer"}},"required":["perMinute","perDay"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"read","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"put":{"operationId":"putProjectsByIdLimits","summary":"Set a project's rate limits (up to the plan's)","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"perMinute":{"type":"integer"},"perDay":{"type":"integer"}},"required":["perMinute","perDay"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"perMinute":{"type":"integer","minimum":1,"maximum":100000},"perDay":{"type":"integer","minimum":1,"maximum":100000000}}}}}}}},"/v1/projects/{id}/origins/challenge":{"post":{"operationId":"postProjectsByIdOriginsChallenge","summary":"The DNS TXT or /.well-known value proving an origin","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"}},"required":["origin"]}}}}}},"/v1/projects/{id}/origins/verify":{"post":{"operationId":"postProjectsByIdOriginsVerify","summary":"Check an origin proof","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"},"method":{"type":"string","enum":["dns","well-known"]}},"required":["origin","method"]}}}}}},"/v1/projects/{id}/public":{"get":{"operationId":"getProjectsByIdPublic","summary":"Brand, modules, network and fee: what embeds read","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/projects/{id}/usage":{"get":{"operationId":"getProjectsByIdUsage","summary":"Requests and plans per day","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/projects/{id}/usage/endpoints":{"get":{"operationId":"getProjectsByIdUsageEndpoints","summary":"A project's requests per endpoint and day","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"days","in":"query","required":false,"schema":{"type":"string","pattern":"^-?\\d{1,15}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"read","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/projects/{id}/webhook":{"post":{"operationId":"postProjectsByIdWebhook","summary":"Register the project's webhook URL (secret shown once)","tags":["Projects"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/cctp/inbound":{"post":{"operationId":"postCctpInbound","summary":"USDC burned elsewhere: attestation and the unsigned receiveMessage on Arc","tags":["Routes"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"source":{"type":"string"},"txHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["source","txHash"]}}}}}},"/v1/quote":{"post":{"operationId":"postQuote","summary":"Every live venue's option for a swap, earn or borrow, and the engine's pick","tags":["Routes"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"kind":{"const":"swap"},"environment":{"type":"string","enum":["mainnet","testnet"]},"from":{"type":"string","minLength":2,"maxLength":10},"to":{"type":"string","minLength":2,"maxLength":10},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}},"required":["kind","from","to","amount"]},{"type":"object","properties":{"kind":{"const":"earn"},"environment":{"type":"string","enum":["mainnet","testnet"]},"token":{"type":"string","minLength":2,"maxLength":10},"maxRisk":{"type":"string","enum":["low","medium","high"]}},"required":["kind","token"]},{"type":"object","properties":{"kind":{"const":"borrow"},"environment":{"type":"string","enum":["mainnet","testnet"]},"token":{"type":"string","minLength":2,"maxLength":10},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"},"collateral":{"type":"string","minLength":2,"maxLength":10},"collateralAmount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"},"minHealth":{"type":"string"},"account":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["kind","token","amount","account"]}]}}}}}},"/v1/rates":{"get":{"operationId":"getRates","summary":"Live yields and borrow rates on Arc","tags":["Routes"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/routes/search":{"post":{"operationId":"postRoutesSearch","summary":"Search multi-hop routes across Arc venues, each checked against the Fence","tags":["Routes"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/scent/{token}":{"get":{"operationId":"getScentByToken","summary":"What can be proven about a token before anyone touches it","tags":["Scent"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/security/alerts":{"get":{"operationId":"getSecurityAlerts","summary":"Security alerts","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/security/approvals":{"get":{"operationId":"getSecurityApprovals","summary":"Token approvals of an owner","tags":["Security"],"parameters":[{"name":"owner","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/security/audit":{"get":{"operationId":"getSecurityAudit","summary":"Audit trail","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/security/check-address":{"post":{"operationId":"postSecurityCheckAddress","summary":"Check an address before sending","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"quote","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["address"]}}}}}},"/v1/security/halt":{"post":{"operationId":"postSecurityHalt","summary":"Halt routing (admin)","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/security/pause":{"post":{"operationId":"postSecurityPause","summary":"Pause an agent, venue or owner","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/security/pauses":{"get":{"operationId":"getSecurityPauses","summary":"Active pauses","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/security/policy":{"get":{"operationId":"getSecurityPolicy","summary":"The owner's security policy","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"put":{"operationId":"putSecurityPolicy","summary":"Update the security policy","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/security/resume":{"post":{"operationId":"postSecurityResume","summary":"Lift a pause","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/security/scent/token/{token}":{"get":{"operationId":"getSecurityScentTokenByToken","summary":"Scent report for a token","tags":["Security"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/security/screen/address/{address}":{"get":{"operationId":"getSecurityScreenAddressByAddress","summary":"Screen an address","description":"Blocklist (USDC/EURC), look-alikes against the owner's contacts, poisoning, contract Scent and Circle Compliance when configured.","tags":["Security"],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"]}},{"name":"owner","in":"query","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["pass","warn","block"]},"findings":{"type":"array","items":{"type":"object","properties":{}}}},"required":["decision","findings"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-scope":"read","security":[{},{"LykiaKey":[]}]}},"/v1/security/status":{"get":{"operationId":"getSecurityStatus","summary":"Security layer status","tags":["Security"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/security/venues/{id}":{"put":{"operationId":"putSecurityVenuesById","summary":"Set a venue's security status (admin)","tags":["Security"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/standing":{"get":{"operationId":"getStanding","summary":"Standing orders of an owner","tags":["Standing"],"parameters":[{"name":"owner","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postStanding","summary":"Arm a standing order","tags":["Standing"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"text":{"type":"string"}},"required":["owner"]}}}}}},"/v1/standing/{id}":{"delete":{"operationId":"deleteStandingById","summary":"Cancel a standing order","tags":["Standing"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"automation","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"get":{"operationId":"getStandingById","summary":"A standing order","tags":["Standing"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/standing/{id}/check":{"post":{"operationId":"postStandingByIdCheck","summary":"Check a standing order now","tags":["Standing"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/standing/{id}/pause":{"post":{"operationId":"postStandingByIdPause","summary":"Pause a standing order","tags":["Standing"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/standing/{id}/resume":{"post":{"operationId":"postStandingByIdResume","summary":"Resume a standing order","tags":["Standing"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"automation","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/fees":{"get":{"operationId":"getFees","summary":"Lykia's protocol fee and the beta caps","tags":["System"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/health":{"get":{"operationId":"getHealth","summary":"Service health and features","tags":["System"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/stats":{"get":{"operationId":"getStats","summary":"Public aggregate traction numbers (no personal data)","tags":["System"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/tags/{agentId}":{"get":{"operationId":"getTagsByAgentId","summary":"An agent's Tag (ERC-8004 identity and Fence hash)","tags":["Tags"],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/tags/{agentId}/policy-salt":{"get":{"operationId":"getTagsByAgentIdPolicySalt","summary":"The policy salt of a Tag","tags":["Tags"],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/tags/attest":{"post":{"operationId":"postTagsAttest","summary":"Draft an ERC-8354 attestation of a verdict (unsigned)","tags":["Tags"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"build","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/tags/cards/{digest}":{"get":{"operationId":"getTagsCardsByDigest","summary":"A Tag card by digest","tags":["Tags"],"parameters":[{"name":"digest","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/tags/draft":{"post":{"operationId":"postTagsDraft","summary":"Draft a Tag registration (unsigned)","tags":["Tags"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"key","x-lykia-scope":"build","x-lykia-idempotent":true,"security":[{"LykiaKey":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}},"/v1/tags/verdicts/{hash}":{"get":{"operationId":"getTagsVerdictsByHash","summary":"A filed Fence verdict","tags":["Tags"],"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/telegram/link":{"delete":{"operationId":"deleteTelegramLink","summary":"Unlink Telegram","tags":["Telegram"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/telegram/link-code":{"post":{"operationId":"postTelegramLinkCode","summary":"A one-time code to link Telegram","tags":["Telegram"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/telegram/setup":{"post":{"operationId":"postTelegramSetup","summary":"Register the bot webhook (admin)","tags":["Telegram"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/telegram/status":{"get":{"operationId":"getTelegramStatus","summary":"Telegram link status","tags":["Telegram"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/verdicts/{digest}":{"get":{"operationId":"getVerdictsByDigest","summary":"Recompute and verify a Fence verdict","tags":["Verdicts"],"parameters":[{"name":"digest","in":"path","required":true,"schema":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/verdicts/verify":{"post":{"operationId":"postVerdictsVerify","summary":"Verify a verdict from a Fence and facts","tags":["Verdicts"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"digest":{"type":"string"},"fence":{"type":"object","additionalProperties":{},"description":"A lykia.fence/v1 document (see /v1/fence/templates)."},"facts":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"signer":{"type":"string","enum":["wallet","agent"]},"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"proposedByAgent":{"type":"boolean"},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":32},"kind":{"type":"string","maxLength":32},"venue":{"type":"string","maxLength":48},"usd":{"type":["string","null"],"pattern":"^\\d{1,15}(?:\\.\\d{1,8})?$"},"tokens":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string","maxLength":32},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"listed":{"type":"boolean"},"acquired":{"type":"boolean"},"scent":{"type":"string","enum":["verified","no-red-flags","caution","danger","unknown"]}},"required":["symbol","address","listed","acquired"]},"maxItems":8},"recipient":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"destination":{"type":"string","maxLength":32},"slippageBps":{"type":"integer","minimum":0,"maximum":10000},"healthFactorAfter":{"type":["string","null"],"maxLength":16},"fxDeviationBps":{"type":["integer","null"],"minimum":-10000,"maximum":10000}},"required":["id","kind","venue","usd","tokens"]},"maxItems":12},"spent":{"type":"object","properties":{"dayUsd":{"type":["string","null"],"pattern":"^\\d{1,15}(?:\\.\\d{1,8})?$"},"weekUsd":{"type":["string","null"],"pattern":"^\\d{1,15}(?:\\.\\d{1,8})?$"}},"required":["dayUsd","weekUsd"]},"now":{"type":"integer","exclusiveMinimum":0}},"required":["environment","signer","owner","steps"]}},"required":["digest","fence","facts"]}}}}}},"/v1/developers/webhooks":{"get":{"operationId":"getDevelopersWebhooks","summary":"Webhook endpoints and the events they can subscribe to","tags":["Webhooks"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]},"post":{"operationId":"postDevelopersWebhooks","summary":"Add a webhook endpoint (signing secret shown once)","tags":["Webhooks"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"projects":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"disabled":{"type":"boolean"},"secret":{"type":"string"}},"required":["id","url","events","projects","description","createdAt","disabled"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","maxLength":500},"events":{"type":"array","items":{"type":"string","minLength":3,"maxLength":64},"maxItems":64},"projects":{"type":"array","items":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"},"maxItems":20},"description":{"type":["string","null"],"maxLength":200}},"required":["url"],"additionalProperties":false}}}}}},"/v1/developers/webhooks/{id}":{"patch":{"operationId":"patchDevelopersWebhooksById","summary":"Change an endpoint's events, projects or description","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"projects":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"disabled":{"type":"boolean"},"secret":{"type":"string"}},"required":["id","url","events","projects","description","createdAt","disabled"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"string","minLength":3,"maxLength":64},"minItems":1,"maxItems":64},"projects":{"type":"array","items":{"type":"string","pattern":"^prj_[a-z0-9]{12}$"},"maxItems":20},"description":{"type":["string","null"],"maxLength":200}}}}}}}},"/v1/developers/webhooks/{id}/disable":{"post":{"operationId":"postDevelopersWebhooksByIdDisable","summary":"Disable an endpoint","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"projects":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"disabled":{"type":"boolean"},"secret":{"type":"string"}},"required":["id","url","events","projects","description","createdAt","disabled"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/developers/webhooks/{id}/enable":{"post":{"operationId":"postDevelopersWebhooksByIdEnable","summary":"Enable an endpoint again","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"projects":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"disabled":{"type":"boolean"},"secret":{"type":"string"}},"required":["id","url","events","projects","description","createdAt","disabled"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/developers/webhooks/{id}/rotate-secret":{"post":{"operationId":"postDevelopersWebhooksByIdRotateSecret","summary":"A new signing secret (shown once)","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"projects":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"disabled":{"type":"boolean"},"secret":{"type":"string"}},"required":["id","url","events","projects","description","createdAt","disabled"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/developers/webhooks/deliveries":{"get":{"operationId":"getDevelopersWebhooksDeliveries","summary":"Delivery log, newest first","tags":["Webhooks"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^-?\\d{1,15}$"}},{"name":"endpointId","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","delivered","failed"]}},{"name":"event","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"deliveries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"endpointId":{"type":"string"},"event":{"type":"string"},"eventId":{"type":"string"},"replayOf":{"type":["string","null"]},"attempts":{"type":"integer"},"status":{"type":"string","enum":["pending","delivered","failed"]},"lastStatusCode":{"type":["integer","null"]},"nextAttemptAt":{"type":["string","null"]},"createdAt":{"type":"string"},"attemptLog":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"statusCode":{"type":["integer","null"]},"durationMs":{"type":"integer"},"error":{"type":["string","null"]}},"required":["at","statusCode","durationMs","error"]}}},"required":["id","endpointId","event","attempts","status","lastStatusCode","nextAttemptAt","createdAt"]}}},"required":["deliveries"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/developers/webhooks/deliveries/{id}":{"get":{"operationId":"getDevelopersWebhooksDeliveriesById","summary":"One delivery with its attempts and body","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"endpointId":{"type":"string"},"event":{"type":"string"},"eventId":{"type":"string"},"replayOf":{"type":["string","null"]},"attempts":{"type":"integer"},"status":{"type":"string","enum":["pending","delivered","failed"]},"lastStatusCode":{"type":["integer","null"]},"nextAttemptAt":{"type":["string","null"]},"createdAt":{"type":"string"},"attemptLog":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"statusCode":{"type":["integer","null"]},"durationMs":{"type":"integer"},"error":{"type":["string","null"]}},"required":["at","statusCode","durationMs","error"]}},"payload":{"type":"object","properties":{}}},"required":["id","endpointId","event","attempts","status","lastStatusCode","nextAttemptAt","createdAt","payload"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/developers/webhooks/deliveries/{id}/replay":{"post":{"operationId":"postDevelopersWebhooksDeliveriesByIdReplay","summary":"Send a delivery again (same event id and body)","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"endpointId":{"type":"string"},"event":{"type":"string"},"eventId":{"type":"string"},"replayOf":{"type":["string","null"]},"attempts":{"type":"integer"},"status":{"type":"string","enum":["pending","delivered","failed"]},"lastStatusCode":{"type":["integer","null"]},"nextAttemptAt":{"type":["string","null"]},"createdAt":{"type":"string"},"attemptLog":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"statusCode":{"type":["integer","null"]},"durationMs":{"type":"integer"},"error":{"type":["string","null"]}},"required":["at","statusCode","durationMs","error"]}}},"required":["id","endpointId","event","attempts","status","lastStatusCode","nextAttemptAt","createdAt"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","x-lykia-idempotent":true,"security":[{"LykiaSession":[]},{"LykiaKey":[]}]}},"/v1/developers/webhooks/test":{"post":{"operationId":"postDevelopersWebhooksTest","summary":"Send a test event to one endpoint or all of them","tags":["Webhooks"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"sent":{"type":"integer"},"deliveries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"endpointId":{"type":"string"},"event":{"type":"string"},"eventId":{"type":"string"},"replayOf":{"type":["string","null"]},"attempts":{"type":"integer"},"status":{"type":"string","enum":["pending","delivered","failed"]},"lastStatusCode":{"type":["integer","null"]},"nextAttemptAt":{"type":["string","null"]},"createdAt":{"type":"string"},"attemptLog":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"statusCode":{"type":["integer","null"]},"durationMs":{"type":"integer"},"error":{"type":["string","null"]}},"required":["at","statusCode","durationMs","error"]}}},"required":["id","endpointId","event","attempts","status","lastStatusCode","nextAttemptAt","createdAt"]}}},"required":["sent","deliveries"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"session","x-lykia-scope":"admin","security":[{"LykiaSession":[]},{"LykiaKey":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"endpointId":{"type":"string","pattern":"^whe_[0-9a-f]{16}$"},"type":{"type":"string","minLength":3,"maxLength":64}}}}}}}},"/v1/webhooks/events":{"get":{"operationId":"getWebhooksEvents","summary":"The event catalogue: every event type, its group and older aliases","tags":["Webhooks"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"group":{"type":"string"},"description":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}}},"required":["type","group","description","aliases"]}}},"required":["events"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/x402/fence/evaluate":{"post":{"operationId":"postX402FenceEvaluate","summary":"Fence check, paid per call in USDC on Arc","tags":["x402"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"},{"name":"X-PAYMENT","in":"header","required":false,"description":"Base64 JSON x402 payment payload (EIP-3009 authorization in USDC on Arc).","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-idempotent":true,"security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fence":{},"facts":{"type":"object","properties":{"environment":{"type":"string","enum":["mainnet","testnet"]},"signer":{"type":"string","enum":["wallet","agent"]},"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"proposedByAgent":{"type":"boolean"},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":32},"kind":{"type":"string","maxLength":32},"venue":{"type":"string","maxLength":48},"usd":{"type":["string","null"],"pattern":"^\\d{1,15}(?:\\.\\d{1,8})?$"},"tokens":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string","maxLength":32},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"listed":{"type":"boolean"},"acquired":{"type":"boolean"},"scent":{"type":"string","enum":["verified","no-red-flags","caution","danger","unknown"]}},"required":["symbol","address","listed","acquired"]},"maxItems":8},"recipient":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"destination":{"type":"string","maxLength":32},"slippageBps":{"type":"integer","minimum":0,"maximum":10000},"healthFactorAfter":{"type":["string","null"],"maxLength":16},"fxDeviationBps":{"type":["integer","null"],"minimum":-10000,"maximum":10000}},"required":["id","kind","venue","usd","tokens"]},"maxItems":12},"spent":{"type":"object","properties":{"dayUsd":{"type":["string","null"],"pattern":"^\\d{1,15}(?:\\.\\d{1,8})?$"},"weekUsd":{"type":["string","null"],"pattern":"^\\d{1,15}(?:\\.\\d{1,8})?$"}},"required":["dayUsd","weekUsd"]},"now":{"type":"integer","exclusiveMinimum":0}},"required":["environment","signer","owner","steps"]}},"required":["facts"]}}}},"x-x402":{"scheme":"exact","amount":"10000","asset":"USDC","payTo":"0x8c5281055b197443ff01dbbdfbf29fd63946ca1e","networks":["eip155:5042","eip155:5042002"]}}},"/v1/x402/health":{"get":{"operationId":"getX402Health","summary":"Health of the paid x402 routes","tags":["x402"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}]}},"/v1/x402/quote":{"post":{"operationId":"postX402Quote","summary":"Route quote, paid per call","tags":["x402"],"parameters":[{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"$ref":"#/components/parameters/IdempotencyKey"},{"name":"X-PAYMENT","in":"header","required":false,"description":"Base64 JSON x402 payment payload (EIP-3009 authorization in USDC on Arc).","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","x-lykia-idempotent":true,"security":[{},{"LykiaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"kind":{"const":"swap"},"environment":{"type":"string","enum":["mainnet","testnet"]},"from":{"type":"string","minLength":2,"maxLength":10},"to":{"type":"string","minLength":2,"maxLength":10},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"}},"required":["kind","from","to","amount"]},{"type":"object","properties":{"kind":{"const":"earn"},"environment":{"type":"string","enum":["mainnet","testnet"]},"token":{"type":"string","minLength":2,"maxLength":10},"maxRisk":{"type":"string","enum":["low","medium","high"]}},"required":["kind","token"]},{"type":"object","properties":{"kind":{"const":"borrow"},"environment":{"type":"string","enum":["mainnet","testnet"]},"token":{"type":"string","minLength":2,"maxLength":10},"amount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"},"collateral":{"type":"string","minLength":2,"maxLength":10},"collateralAmount":{"type":"string","pattern":"^\\d{1,18}(?:\\.\\d{1,18})?$"},"minHealth":{"type":"string"},"account":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["kind","token","amount","account"]}]}}}},"x-x402":{"scheme":"exact","amount":"10000","asset":"USDC","payTo":"0x8c5281055b197443ff01dbbdfbf29fd63946ca1e","networks":["eip155:5042","eip155:5042002"]}}},"/v1/x402/scent/{token}":{"get":{"operationId":"getX402ScentByToken","summary":"Deep Scent report, paid per call","tags":["x402"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["mainnet","testnet"],"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},"description":"Arc network; defaults to the server's mode. Test keys are always testnet."},{"$ref":"#/components/parameters/LykiaVersion"},{"$ref":"#/components/parameters/AcceptLanguage"},{"name":"X-PAYMENT","in":"header","required":false,"description":"Base64 JSON x402 payment payload (EIP-3009 authorization in USDC on Arc).","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Lykia-Version":{"$ref":"#/components/headers/LykiaVersion"}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-lykia-auth":"public","security":[{},{"LykiaKey":[]}],"x-x402":{"scheme":"exact","amount":"10000","asset":"USDC","payTo":"0x8c5281055b197443ff01dbbdfbf29fd63946ca1e","networks":["eip155:5042","eip155:5042002"]}}}},"components":{"securitySchemes":{"LykiaKey":{"type":"apiKey","in":"header","name":"Lykia-Key","description":"API key. Scopes: read (Every GET: networks, venues, the Flock, Scent, intents, logs and usage.); quote (Quotes and checks that move nothing: route search, quotes, Fence evaluate and validate, sentence parsing.); build (Plans and unsigned transactions: create intents, prepare steps, Tag drafts, MCP.); execute (Record signed transactions and control running plans: submit, stop.); agents (The Pack and Lyko's agent: spawn, revoke, chat.); automation (Standing orders, limit orders, alerts and agent automations.); payouts (Business money movement: payouts, invoices and treasury flows.); admin (Account settings: keys, webhooks, projects, billing.); plan (Legacy: implies quote, build and execute.); webhooks (Legacy: manage webhook endpoints.)"},"LykiaSession":{"type":"apiKey","in":"header","name":"Lykia-Session","description":"Session token from POST /v1/auth/verify (SIWE on Arc)."},"X402":{"type":"apiKey","in":"header","name":"X-PAYMENT","description":"x402 payment (USDC on Arc) for paid routes and pay-as-you-go overage."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"description":"8 to 128 characters. Retries with the same key and body replay the first answer (Idempotent-Replayed: true); a different body is 409.","schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}},"AcceptLanguage":{"name":"Accept-Language","in":"header","required":false,"description":"The language owner-facing sentences come back in: answers, questions and their options, preflight findings, Fence reasons, plan step summaries, insights and error messages (error codes stay English constants). One of en, tr, es, pt-BR, zh-CN, fr (a close tag such as pt or zh-Hans matches); anything else is English. A `locale` field in the body of chat and plan routes wins over the header. The answer carries Content-Language.","schema":{"type":"string","example":"tr"}},"LykiaVersion":{"name":"Lykia-Version","in":"header","required":false,"description":"API version date. Defaults to the key's pinned version, else 2026-11-01.","schema":{"type":"string","enum":["2026-06-01","2026-11-01"]}}},"headers":{"RequestId":{"description":"Unique id of this request; quote it to support.","schema":{"type":"string"}},"RateLimitLimit":{"description":"Requests per minute allowed for this key.","schema":{"type":"integer"}},"RateLimitRemaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"LykiaVersion":{"description":"The API version that served the request.","schema":{"type":"string"}}},"schemas":{"PaymentRequired":{"type":"object","required":["x402Version","accepts"],"properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"const":"exact"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"extra":{"type":"object"}}}}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","pattern":"^[A-Z][A-Z0-9_]*$","examples":["INVALID_REQUEST","RATE_LIMITED"]},"message":{"type":"string"},"details":{"type":"object"},"requestId":{"type":"string"}}}}}},"responses":{"BadRequest":{"description":"Invalid request (details.issues lists each problem).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Missing, unknown or revoked credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The key lacks a scope, the IP or origin is not allowed, or a test key asked for mainnet (LIVE_MODE_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"IDEMPOTENCY_CONFLICT: the key was used with a different body, or the first request is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"RATE_LIMITED or QUOTA_EXCEEDED. Retry-After says when.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"PaymentRequired":{"description":"x402 payment required: { x402Version, error, accepts: [PaymentRequirements] }.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"ServerError":{"description":"An internal or upstream failure. Safe to retry GETs; retry POSTs with the same Idempotency-Key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"x-lykia-versions":["2026-06-01","2026-11-01"]}