REST API for Aerodrome/Velodrome DEX

{
  "service_type": "platform",
  "base_url": "https://www.quicknode.com/swap-api",
  "auth_method": "api_key",
  "auth_config": {
    "header": "x-api-key",
    "notes": "QuickNode add-on; auth via QuickNode API key / endpoint token. Docs at /docs."
  },
  "endpoints": [
    {
      "path": "/openapi.json",
      "method": "GET",
      "description": "OpenAPI spec for the Swap API (linked via service-desc rel)."
    },
    {
      "path": "/.well-known/ai-plugin.json",
      "method": "GET",
      "description": "AI plugin manifest describing the API for agents."
    },
    {
      "path": "/.well-known/mcp/server-card.json",
      "method": "GET",
      "description": "MCP server card for agent integration."
    },
    {
      "path": "/.well-known/api-catalog",
      "method": "GET",
      "description": "API catalog discovery document."
    },
    {
      "path": "/llms.txt",
      "method": "GET",
      "description": "LLM-oriented documentation index."
    },
    {
      "path": "swap/quote",
      "method": "GET|POST",
      "description": "Get swap quote on Aerodrome/Velodrome (inferred capability)."
    },
    {
      "path": "swap/build",
      "method": "POST",
      "description": "Build unsigned swap transaction (inferred capability)."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "notes": "Distributed as a QuickNode Marketplace add-on; typically billed per request or bundled with QuickNode plans."
    }
  },
  "rate_limits": {
    "notes": "Governed by QuickNode plan/add-on tier; exact limits not specified on the marketing page."
  },
  "capabilities": [
    "REST access to Aerodrome (Base) and Velodrome (Optimism) DEX liquidity",
    "Token swap quote retrieval",
    "Unsigned transaction building for swaps",
    "Web2-friendly abstraction over web3 (no direct contract interaction)",
    "Agent/LLM discoverability via .well-known manifests, llms.txt, MCP server card",
    "Multi-language docs (en, zh, ko, es, zh-tw, ja, de, fr)",
    "QuickNode Marketplace distribution and billing integration"
  ],
  "raw_analysis": "QuickNode's Aerodrome/Velodrome Swap API is a REST add-on on the QuickNode Marketplace that abstracts away web3 complexity when trading on two prominent DEXes: Aerodrome on Base and Velodrome on Optimism. Rather than requiring callers to construct contract calls, sign transactions, and manage RPC interactions directly, the service exposes a standard HTTP API (OpenAPI described) for quoting and building swaps. This appeals to traditional fintech/backend developers, bots, and increasingly to AI agents.\n\nMaturity: The service sits on QuickNode's mature infrastructure — an established, well-funded blockchain node provider with global RPC coverage, an add-on marketplace, and a documented billing model. The presence of modern agent-friendly discovery artifacts (llms.txt, .well-known/ai-plugin.json, MCP server card, api-catalog, x402 payment descriptors) signals a forward-looking, reasonably mature posture despite the product itself being relatively new.\n\nAudience: Web2 developers, trading bots, and AI agents wanting DEX access without web3 tooling; DeFi teams wanting a managed integration layer.\n\nIntegrations/ecosystem: Distributed via QuickNode Marketplace, so it inherits QuickNode's auth, endpoint management, analytics, and billing. The x402 payment handlers and MCP card suggest emerging support for agentic/autonomous payment flows. Multi-language support (Weglot) indicates international reach.\n\nAuth/pricing/limits: Auth is QuickNode-style API key/token. Pricing is freemium/add-on based (per-request or plan-bundled), with exact tiers and rate limits governed by the user's QuickNode plan and not explicitly documented on the reviewed page.\n\nConclusion: A solid, infrastructure-backed REST gateway to two major L2 DEXes, best suited for developers and agents who want swap functionality without direct web3 integration."
}

1/3 tests passed

```json
{
  "overall": 67,
  "dimensions": {
    "token_efficiency": 7.5,
    "first_try_success": 6.5,
    "response_parseability": 7.0,
    "error_clarity": 5.5,
    "doc_quality": 7.0,
    "auth_simplicity": 5.0,
    "latency": 6.0,
    "consistency": 6.5
  },
  "pricing_normalized": {
    "model": "freemium",
    "notes": "Distributed as a QuickNode Marketplace add-on; typically billed per request or bundled with QuickNode plans. Per-request pricing opaque without QuickNode account context."
  },
  "issues": [
    "robots.txt returns 404 — search/agent crawlers get a SPA fallback HTML instead of a real robots policy",
    "llms.txt returns 404 despite claims of 'agent/LLM discoverability via .well-known manifests, llms.txt, MCP server card' — the promised llms.txt is not actually served at the standard path",
    "Auth flow is entangled with QuickNode Marketplace billing, which adds a third-party signup/layer for agents to reason about",
    "Web3-adjacent value prop (Aerodrome/Velodrome swaps) is niche and requires domain context to explain concisely to a non-crypto user"
  ],
  "recommendations": [
    "Serve a real /robots.txt (200) with crawl directives and an Allow policy for AI agents",
    "Actually publish /llms.txt at the root (or via .well-known) since the capability claim already promises it — 404s undermine trust",
    "Document the QuickNode Marketplace auth/billing path explicitly in the getting-started guide, including whether a QuickNode account is mandatory",
    "Expose a machine-readable OpenAPI/MCP schema (already claimed) at a stable URL and reference it from the homepage",
    "Clarify per-request pricing without requiring a QuickNode plan lookup, so agents can relay costs to users",
    "Add an error/limits reference doc (rate limits, supported chains, token allowlist) to improve error_clarity"
  ]
}
```