# EVM Proxy by Quoraxis

> Agent-first multi-chain EVM API. 16 chains. Composite endpoints. MEV detection. Tx decoding. Cross-chain queries. MCP server.

Operated by Quoraxis LLC (Wyoming, USA).

## Get Started (for agents)

Register for an API key (no browser needed):

```
POST https://evm.quoraxis.com/auth/agent/register
Content-Type: application/json

{"name": "my-agent"}
```

Response: `{"success": true, "api_key": "evmq_...", "rate_limit": 60}`

Use your key: `?apikey=evmq_...` or header `X-API-Key: evmq_...`

## Agent-Optimized Endpoints (v1)

- Wallet overview: GET /v1/wallet/{address}?chain=eth (or chain=all for all 16 chains)
- Multi-chain balances: GET /v1/wallet/{address}/balances
- Transaction decoder: GET /v1/tx/{hash}?chain=eth (human-readable description)
- Batch tx decode: POST /v1/tx/batch (up to 20 txs)
- Cross-chain gas: GET /v1/gas (all 16 chains)
- Cross-chain blocks: GET /v1/blocks
- Chain status: GET /v1/chains (with latency)
- Contract info: GET /v1/contract/{address}?chain=eth
- Cross-chain contract: GET /v1/contract/{address}/chains

## Tool Schemas (no auth)

- All formats: GET /tools
- OpenAI functions: GET /tools/openai
- Anthropic tools: GET /tools/anthropic
- MCP tools: GET /tools/mcp

## MCP Server

Configure in Claude Code:
```json
{
  "mcpServers": {
    "evm-proxy": {
      "command": "node",
      "args": ["dist/mcp.js"],
      "env": { "EVM_PROXY_URL": "https://evm.quoraxis.com", "EVM_PROXY_API_KEY": "evmq_..." }
    }
  }
}
```

## Legacy Endpoints

- Etherscan-compatible: GET /api?module=account&action=balance&address=0x...&chain=eth&apikey=KEY
- JSON-RPC proxy: POST /rpc/{chain} (drop-in Alchemy/Infura replacement)
- MEV detection: GET /api?module=mev&action=check&txhash=0x...&chain=eth&apikey=KEY
- Validator info: GET /validator/{index_or_pubkey} (no key needed)
- Chain list: GET /chains (no key needed)
- Usage stats: GET /auth/agent/usage?apikey=KEY

## Supported Chains

eth, base, arbitrum, optimism, polygon, polygon-zkevm, zksync, scroll, linea, blast, mantle, gnosis, celo, bsc, avalanche, fantom

## Machine-Readable Docs

- OpenAPI 3.1 spec: https://evm.quoraxis.com/openapi.json
- Full reference: https://evm.quoraxis.com/llms-full.txt
- Plugin manifest: https://evm.quoraxis.com/.well-known/ai-plugin.json
- Agent protocol: https://evm.quoraxis.com/.well-known/agent.json

## Pricing

Free tier: 60 requests/minute, all chains, all features.
Paid: Usage-based via Stripe. See GET /pricing for details.