# Ophis

> Ophis is an intent-based DEX aggregator. You describe a swap in plain English ("swap 100 USDC for ETH on Base"), a network of solvers competes to fill it MEV-protected, and you sign the resulting order with your own wallet. 0% fees on ordinary trades — Ophis only earns when a solver beats your quoted price (positive-slippage rebates). Ophis is a fork of CoW Protocol's frontend with an added natural-language intent-parsing layer; the full source is at github.com/ophis-fi/ophis.

## Core principles

- **Intent-based**, not router-based: users sign their *desired outcome*, solvers compete on *how* to deliver it.
- **MEV-protected**: orders settle off-chain via a batch auction; sandwich attacks are structurally absent, not best-effort.
- **Self-custodial**: Ophis never holds funds. Every order is signed by the user's wallet (EIP-712 or ERC-1271).
- **Free for ordinary trades**: 0% protocol fee on standard swaps. Ophis earns only via positive-slippage capture; if execution doesn't beat your quote, you pay nothing extra.
- **Open**: full frontend, intent-parser proxy, and infra runbooks are public.

## Routes

- [/](https://ophis.fi/): Landing — entry point, brand surfaces, language-first swap intent input.
- [/#/swap](https://ophis.fi/#/swap): Trade — standard swap UI (token A → token B, instant fill via solver auction).
- [/#/limit](https://ophis.fi/#/limit): Limit orders — sign-once orders that solvers fill when your target price is reachable.
- [/#/advanced](https://ophis.fi/#/advanced): Advanced trading — TWAP / programmable order types.
- [/#/yield](https://ophis.fi/#/yield): Yield — token-to-yield-bearing-token routes.
- [/#/about](https://ophis.fi/#/about): About — what Ophis is and isn't.
- [/#/institutional](https://ophis.fi/#/institutional): Institutional — agents/treasuries/funds, intent API integration patterns.
- [/#/tiers](https://ophis.fi/#/tiers): Fee tiers — positive-slippage rebate schedule by 30-day volume.
- [/#/profile](https://ophis.fi/#/profile): Profile — wallet-scoped lifetime stats (trades, rebates, savings).
- [/#/missions](https://ophis.fi/#/missions): Missions — discoverable in-protocol challenges (no points, no airdrop fishing).
- [/#/earn](https://ophis.fi/#/earn): Earn — explicit rebate mechanics + tier ladder.
- [/#/learn](https://ophis.fi/#/learn): Learn — primers on intents, solvers, MEV, batch auctions.
- [https://docs.ophis.fi](https://docs.ophis.fi): Full docs — protocol overview, intent API spec, architecture, AI-agent integration guide, audits.
- [https://business.ophis.fi](https://business.ophis.fi): Business portal — integration playbook for institutional desks, custodians, and AI agents.

## APIs

- [POST /api/intent](https://ophis.fi/api/intent): Plain-English → structured `ParsedIntent`. Backed by LibertAI Qwen 3.6 27B; CF Pages Function proxies, browser never sees the LLM key. Rate-limited 30 req/min/IP. Response shape: `{ ok: true, data: { intent: 'swap'|'unknown', entities: [{type, value, raw, start, end}] } }` or `{ ok: false, error: { code, message } }` with codes `TIMEOUT | UPSTREAM | INVALID_JSON | BAD_INPUT | RATE_LIMITED | FORBIDDEN`. Same-origin only (Origin allowlist enforced). Full spec: [/openapi.yaml](https://ophis.fi/openapi.yaml).

## For AI agents

Ophis is designed to be agent-friendly. The intent endpoint above accepts free-form natural language; the response is structured JSON your agent can map directly to a pre-filled swap URL. Recommended flow:

1. POST your user's request (or your agent-generated trade idea) to `/api/intent`.
2. Receive `ParsedIntent` with normalized `sellToken`, `buyToken`, `amount`, `chain` entities.
3. Construct a deep-link: `https://ophis.fi/#/<chainId>/swap/<sellTokenSymbol>/<buyTokenSymbol>?inputCurrency=<amount>`.
4. Open the link for the user to review and sign. Ophis never auto-signs — every order requires explicit wallet approval.

Agents that submit orders programmatically should use the CoW Protocol orderbook API directly. Ophis surfaces 11 EVM source/destination chains in the network selector — Ethereum, Arbitrum One, Avalanche, Base, BNB Smart Chain, Gnosis Chain, Ink, Linea, Optimism, Plasma, Polygon — plus Sepolia for integration testing. Orderbook endpoints for the CoW-aligned chains live at `api.cow.fi`; Ophis-specific orderbook deployments (currently Optimism mainnet via `optimism-mainnet.ophis.fi`) follow the same schema. See [https://docs.cow.fi/cow-protocol/reference/apis/orderbook](https://docs.cow.fi/cow-protocol/reference/apis/orderbook) for the API contract.

Ophis intentionally does NOT implement x402 (HTTP-native payments). The wallet-sign model is the trust boundary; bypassing it for payment automation would compromise self-custody.

## Trust, audits, custody

- **Custody**: Ophis is non-custodial. The protocol cannot move user funds without an EIP-712 signature from the user's wallet.
- **Smart contracts**: Ophis uses unmodified CoW Protocol settlement contracts on Optimism mainnet. Original audits: [github.com/cowprotocol/contracts/tree/main/docs](https://github.com/cowprotocol/contracts/tree/main/docs).
- **Ophis-specific code**: Frontend fork, intent-parser CF Pages Function, rebate-indexer service. Source: [github.com/ophis-fi/ophis](https://github.com/ophis-fi/ophis).
- **Operator**: contact@3615crypto.com.

## Optional

- [github.com/ophis-fi/ophis](https://github.com/ophis-fi/ophis): Full source code (frontend, intent proxy, indexer, infra runbooks).
- [github.com/cowprotocol/contracts](https://github.com/cowprotocol/contracts): Underlying settlement contracts (Ophis runs these unmodified on OP mainnet).
- [docs.cow.fi/cow-protocol](https://docs.cow.fi/cow-protocol): CoW Protocol docs — the settlement primitives Ophis is built on.