Agent skill · software engineering · starchild-ai-agent
1inch
1inch DEX aggregator: same-chain EVM swaps, SOL↔EVM cross-chain, limit orders. Use when swapping tokens with best routing or placing limit orders (e.g. ETH→USDC on Base, SOL→ETH cross-chain, limit buy ARB at 0.80).
Why this skill is useful
Adds executable scripts for interacting with the 1inch API, enabling token swaps and limit orders that the AI cannot generate on its own.
What it needs
Requires python3 installed locally. Requires oneinch account access. About 5k tokens when loaded. Last updated 2026-08-06. 22 stars on the source repository.
What this skill does
1inch (Script-First, Install-and-Use) This skill is designed for your architecture: do not rely on platform-injected tools. ✅ Uses only skill-local scripts under skills/1inch/scripts/ ✅ Agent executes scripts via bash (python3 ...) ✅ No oneinch tool calls required --- Why this version fixes “tool not found” Old design depended on runtime tool registration (oneinchquote, oneinchswap, ...). If tool injection fails, agent is blocked. New design uses deterministic local scripts: 1. call 1inch HTTP API directly 2. call wallet service directly (OIDC via /.fly/api) 3. print JSON result So after install, the agent always has a runnable path. --- Files scripts/oneinchlib.py — shared client + wallet/OIDC helpers scripts/tokens.py — token search/list scripts/quote.py — quote only scripts/checkallowance.py — allowance check scripts/approve.py — approve tx broadcast scripts/swap.py — swap execution (optional auto-approve) scripts/runswapflow.py — one-command flow (quote + optional approve + swap + post-trade balance verification) --- Environment Required: ONEINCHAPIKEY WALLETSERVICEURL (default fallback exists) sc-proxy connectivity for 1inch API (mandatory) Assumptions: Running on Fly Machine with /.fly/api unix socket for OIDC token minting. sc-proxy requirement (critical) This skill enforces 1inch calls through sc-proxy. It reads proxy from HTTPPROXY/HTTPSPROXY first, else falls back to PROXYHOST + PROXYPORT. If no proxy env is found, scripts fail fast with a clear error instead of silently direct-connecting. --- Supported chains ethereum, arbitrum, base, optimism, polygon, bsc, avalanche, gnosis --- Agent execution rules (IMPORTANT) When user asks for 1inch actions, follow this exact pattern: 1. Never call oneinch tools 2. Run local scripts with bash + python3 skills/1inch/scripts/<script>.py ... 3. Parse JSON output and respond with concise summary 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills starchild-ai-agent/1inch