# Venym DeFi — the agent layer for DeFi

> Onchain execution for autonomous AI agents: cross-chain liquidity across 70+ networks and a perpetuals DEX with multi-venue routing, exposed as one REST API, an MCP server, and typed SDKs (TypeScript + Python). Public market data is open; execution uses a scoped `venym_sk_` agent key with risk limits enforced server-side before any order reaches a venue. API base: https://defi.venym.io/api

## Start
- [Overview](https://defi.venym.io/docs): What the agent layer is and what it exposes.
- [Quickstart](https://defi.venym.io/docs/quickstart): Key → first data call → first trade in 5 minutes.
- [Authentication](https://defi.venym.io/docs/authentication): Agent API keys, scopes, and per-key risk limits.

## Harnesses
- [Claude Code](https://defi.venym.io/docs/harnesses#claude-code): Add the Venym MCP server via .mcp.json (stdio or HTTP).
- [Codex CLI](https://defi.venym.io/docs/harnesses#codex): Add via ~/.codex/config.toml [mcp_servers.venym].
- [OpenCode](https://defi.venym.io/docs/harnesses#opencode): Add via opencode.json mcp (local or remote).
- [Hermes Agent](https://defi.venym.io/docs/harnesses#hermes): Add via ~/.hermes/config.yaml mcp_servers.
- [OpenClaw](https://defi.venym.io/docs/harnesses#openclaw): Add via ~/.openclaw/openclaw.json mcp.servers.

## SDKs
- [TypeScript](https://defi.venym.io/docs/sdk#typescript): @venym/sdk — install, auth, examples per capability.
- [Python](https://defi.venym.io/docs/sdk#python): venym — install, auth, examples per capability.

## MCP & Skills
- [MCP server](https://defi.venym.io/docs/mcp): Local stdio (npx @venym/mcp) and remote HTTP.
- [Tool reference](https://defi.venym.io/docs/mcp#tools): Every MCP tool, its inputs, and required scope.
- [Agent skills](https://defi.venym.io/docs/skills): Drop-in SKILL.md skills for analysis, trading, pairs, and swaps.

## REST API
- [Reference](https://defi.venym.io/docs/api): Every endpoint: market data, streaming, orders, pair trades, swaps, keys.

## Guides
- [Recipes](https://defi.venym.io/docs/recipes): Stream prices, smart-routed trade, pair trade, cross-chain swap, agent loop.
- [Safety](https://defi.venym.io/docs/safety): Risk gates, scopes, idempotency, custody, errors, rate limits.

## Quick start
- Local MCP server (works in Claude Code, Codex, OpenCode, Hermes, OpenClaw): `npx -y @venym/mcp` — set `VENYM_API_KEY` for execution.
- Remote MCP server: https://defi.venym.io/mcp (send `Authorization: Bearer venym_sk_...`).
- TypeScript SDK: `npm i @venym/sdk`  ·  Python SDK: `pip install venym`

## Optional
- [Full reference](https://defi.venym.io/llms-full.txt): every endpoint and MCP tool, inlined.
- [OpenAPI 3.1 spec](https://defi.venym.io/openapi.json): machine-readable API description.