# Ophis

> Ophis is an intent-based, MEV-protected DEX aggregator built for the agent era. Describe a trade in natural language; Ophis parses the intent, fetches a best-execution quote, and batch-settles it MEV-protected on supported EVM chains, with Solana and Bitcoin destinations via NEAR Intents. Autonomous agents can trade through a public MCP server.

Ophis is a CoW Protocol fork supporting 13 EVM chains: Ethereum, Arbitrum One, Avalanche, Base, BNB Smart Chain, Gnosis Chain, Ink, Linea, Optimism, Plasma, Polygon, Robinhood Chain, and Unichain. Orders are gasless, off-chain, EIP-712-signed intents with a hard limit price: an agent signs a *bounded capability*, not an arbitrary transaction, and it can never be settled below its signed limit. On the Ophis-operated networks Optimism (chain 10), Unichain (chain 130), and Robinhood Chain (chain 4663), settlement uses Ophis's own GPv2Settlement at a non-canonical address (NOT CoW's canonical address). Agents MUST resolve the per-chain settlement domain (and orderbook host) via the `@ophis/sdk` helpers or the MCP `list_chains` tool before signing; signing against CoW's canonical address yields a domain the deployed contract rejects.

## Pricing

- Ophis-operated pricing: Optimism, Unichain, and Robinhood Chain charge a 1 bp base on every path, plus 80% of reference-quote improvement on volatile pairs (50 bps cap) or 50% on stable pairs (20 bps cap).
- CoW-hosted pricing: the existing 10 bps retail, 5 bps partner, and 1 bp stablecoin Ophis rates remain, with CoW Protocol fees applying upstream.
- Integrator own-fees: onboarded integrators may stack their own ERC-20 fee on top; Ophis takes 0% of that markup. See https://docs.ophis.fi/partners.
- Surplus: traders receive the price improvement remaining after the applicable capped protocol capture.
- APIs: the public MCP server and the Intent API are free. The Intent API is rate-limited to 30 requests per minute per IP.
- Worked example: a $100,000 volatile trade with 20 bps of improvement pays a $10 base plus $160 of captured improvement on an Ophis-operated chain. A stablecoin trade with the same improvement pays $10 plus $100.

Intent API example (free, 30 req/min per IP):

```
curl -X POST https://swap.ophis.fi/api/intent \
  -H 'Content-Type: application/json' \
  -d '{"text": "swap 100 USDC for ETH on Optimism"}'
```

## For agents

- [MCP server](https://mcp.ophis.fi/mcp): a Streamable-HTTP Model Context Protocol server. Tools: `parse_intent` (natural language -> structured swap), `resolve_token` (symbol -> canonical address, fails closed / anti-spoof), `get_quote` (best-execution quote), `build_order` (a bounded, ready-to-sign EIP-712 order with the receiver pinned to the owner), `submit_order` (relay a pre-signed order), `lookup_tier` (fee-rebate tier), `get_integrator_earnings` (integrator fee earnings), `list_chains`, `get_balances` (wallet balances on a chain), `get_portfolio` (cross-chain balances), `get_gas` (chain gas price), `get_token_chart` (OHLCV chart), `expected_surplus` (beat-the-market estimate), `validate_order` (preflight order validation). Public, unauthenticated, and keyless: it never holds keys or signs; the agent signs with its own key.
- [Intent API](https://swap.ophis.fi/api/intent): `POST {"text": "swap 100 USDC for ETH on Optimism"}` returns `{ok: true, data: {intent, entities}}` where entities are `{type: sellToken|buyToken|amount|chain, value, raw, start, end}`. Machine-readable spec: [OpenAPI](https://ophis.fi/openapi.json).
- Discovery manifests: [`/.well-known/mcp.json`](https://ophis.fi/.well-known/mcp.json) (MCP server + tools), [`/.well-known/ai-plugin.json`](https://ophis.fi/.well-known/ai-plugin.json) (plugin manifest).
- [Agent skills](https://ophis.fi/.well-known/agent-skills/index.json): markdown skill family for shell-capable agents (curl/jq/cast), sha256-digested per file: `ophis` (umbrella with a machine-readable per-chain contract-pinning policy: settlement, vault relayer, EIP-712 domains, orderbook hosts, slippage latches) plus `ophis-quote`, `ophis-swap`, `ophis-order-status`, `ophis-cancel`, `ophis-surplus-report`. Umbrella: https://ophis.fi/.well-known/agent-skills/ophis/SKILL.md

## Product

- [Swap app](https://swap.ophis.fi/): the trading interface: start from a natural-language intent.
- [Learn guides](https://ophis.fi/learn/): evergreen explainers on intent-based trading and MEV protection (sandwich attacks, solvers, coincidence of wants, slippage vs signed limits, surplus, MEV blockers vs batch auctions), plus an agent-builder cluster: safe agent swaps, agent custody, the trading MCP server, API keys vs wallet signatures, and EIP-712 typed-data signing.
- [Pricing](https://ophis.fi/pricing/): the canonical fee page: rates per path, all-in cost per chain, integrator terms, worked examples.
- [Supported chains](https://ophis.fi/supported-chains/): the canonical chain list with chain IDs and the settlement mode per chain.
- [Security](https://ophis.fi/security/): custody model, audits, agent-safety rules, vulnerability disclosure.
- [Docs](https://docs.ophis.fi/): protocol design, Intent API reference, SDK, security audits.
- [SDK](https://github.com/ophis-fi/ophis/tree/main/packages/sdk): `@ophis/sdk`: agent-safety helpers for building bounded CoW orders on Ophis (correct per-chain settlement domain, flat volume partner fee, receiver pinning).

## Optional

- [GitHub](https://github.com/ophis-fi/ophis): full source.
- [Full docs text](https://docs.ophis.fi/llms-full.txt): the entire documentation concatenated into one file for LLM context windows.
- Fee model: Ophis-operated chains charge 1 bp plus capped reference-improvement capture (80% volatile/50 bps cap; 50% stable/20 bps cap). CoW-hosted paths retain 10 bps retail, 5 bps partner, and 1 bp stable rates plus upstream CoW fees.
- Surplus: traders receive the remainder after the applicable capped capture.