Spot Advanced Swap Orders
Place crypto limit orders on any supported DEX — gasless, non-custodial, and oracle-protected across 8 EVM chains. Use this skill when the agent needs to turn user intent into a final Spot order payload on a supported EVM chain. It covers order-shape selection, param normalization, typed-data population, approval guidance, signing, submission, query, and cancellation. This bundle is instruction-only: build everything locally from the bundled markdown and JSON assets, then submit only the final signed payload. Execution remains decentralized, non-custodial, oracle-protected, immutable, audited, and battle-tested onchain.
Supported Chains
- Ethereum -
1- adapter0xC1bB4d5071Fe7109ae2D67AE05826A3fe9116cfc - BNB Chain -
56- adapter0x67Feba015c968c76cCB2EEabf197b4578640BE2C - Polygon -
137- adapter0x75A3d70Fa6d054d31C896b9Cf8AB06b1c1B829B8 - Sonic -
146- adapter0xD87ee28806bc0060789C4789F123647f4Df25A6C - Base -
8453- adapter0xc64d6E64A713EfbbCcB14413479c56461F9c0b77 - Arbitrum One -
42161- adapter0x6F1002141Fcb5d3A3aA8b12A49e6e7DCE5661ae9 - Avalanche -
43114- adapter0xc64d6E64A713EfbbCcB14413479c56461F9c0b77 - Linea -
59144- adapter0x55E4da2cd634729064bEb294EC682Dc94f5c3f24
Relay
- Submit signed orders with
POST https://agents-sink.orbs.network/orders/new. - Query orders with
GET https://agents-sink.orbs.network/orders; see references/lifecycle.md for filters, polling, and cancellation follow-up.
Workflow
- Read references/quickstart.md for the minimum end-to-end flow.
- Use references/params.md to map user intent into params, defaults, validation, and order-shape fields.
- Use references/sign.md to fill the template, handle approval, sign, and submit.
- Use references/lifecycle.md for relay query semantics, status polling, and cancellation.
- Use references/examples.md only when the final relay payload shape is still unclear.
- Use assets/token-addressbook.md only for optional token alias lookup on supported chains.
- Use assets/repermit.template.json as the canonical typed-data shape.
- Treat
## Supported Chainsas the authoritative source for chain support and per-chain adapters. - Treat
## Relayas the authoritative relay endpoint list.
Guardrails
## Supported Chainsis authoritative for chain support and per-chain adapters.## Relayis authoritative for relay endpoints.- assets/token-addressbook.md is a convenience alias list only. It does not expand chain support or override explicit user-provided addresses.
- This skill is instruction-only. Do not fetch or execute external helper code.
- Normalize params with references/params.md before touching the template.
- Replace only the
<...>placeholders in assets/repermit.template.json. Keep the fixed protocol fields already in the template unchanged. - Default approval guidance is exact
approve(..., input.maxAmount). StandingmaxUint256approval is opt-in convenience for repeat use, not the default suggestion. - Submit only the final signed payload as described in references/sign.md.
Agent Contract
- Turn the user request into a params JSON object using references/params.md.
- Normalize params locally, including defaults, rounding, and order-shape fields.
- Confirm
chainIdis listed in## Supported Chains, then populate assets/repermit.template.json from the normalized params and replace<ADAPTER>with that chain's listed adapter. - Handle approval, signing, and submission exactly as described in references/sign.md, and forward the returned signature unchanged.
- Query and cancel exactly as described in references/lifecycle.md.