openapi: 3.0.3
info:
title: Clawdia Agent Gateway API
description: 'Unified API gateway providing 40+ services for AI agents. Web scraping, screenshots, code execution, crypto
data, agent memory, file storage, and more.
**Authentication**: Free tier (200 credits, no key needed). For higher volume: create an API key via `POST /api/keys/create`,
then pass it as `X-API-Key` header or `?key=` query param.
**x402 Payments**: All endpoints support [x402](https://www.x402.org/) micropayments (USDC on Base). Send a request without
auth to get a 402 response with payment details.'
version: 1.0.0
contact:
name: Clawdia
url: https://api-catalog-three.vercel.app
license:
name: MIT
servers:
- url: https://agent-gateway-kappa.vercel.app
description: Production gateway
security:
- {}
- ApiKeyHeader: []
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyHeader:
type: apiKey
in: header
name: X-API-Key
description: API key passed in header
ApiKeyQuery:
type: apiKey
in: query
name: key
description: API key passed as query parameter
schemas:
Error:
type: object
properties:
error:
type: string
message:
type: string
tags:
- name: Gateway
description: Gateway-level endpoints (auth, payments, analytics)
- name: Blockchain
description: 2 services
- name: Communication
description: 1 services
- name: Compute
description: 4 services
- name: Data & Analytics
description: 7 services
- name: DeFi & Crypto
description: 4 services
- name: Gaming
description: 1 services
- name: Agent Infrastructure
description: 12 services
- name: Security
description: 1 services
- name: Utility
description: 5 services
paths:
/v1/poison-guard/api/analyze:
post:
tags:
- Security
summary: "Poison Guard \u2014 /api/analyze"
description: Address poisoning detection for EVM wallets. Detects dust transactions, similarity attacks, and risk scoring.
operationId: poison-guard_post_api_analyze
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/poison-guard/api/check/{address}:
get:
tags:
- Security
summary: "Poison Guard \u2014 /api/check/:address"
description: Part of Poison Guard
operationId: poison-guard_get_api_check_address
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
parameters:
- name: address
in: path
required: true
schema:
type: string
/v1/fair-games/api/games/dice:
post:
tags:
- Gaming
summary: "Provably Fair Games \u2014 /api/games/dice"
description: Cryptographically provable fair games API. HMAC-SHA256 proofs on every outcome. Dice, coinflip, roulette,
cards, lottery.
operationId: fair-games_post_api_games_dice
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/fair-games/api/games/coinflip:
post:
tags:
- Gaming
summary: "Provably Fair Games \u2014 /api/games/coinflip"
description: Part of Provably Fair Games
operationId: fair-games_post_api_games_coinflip
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/fair-games/api/games/roulette:
post:
tags:
- Gaming
summary: "Provably Fair Games \u2014 /api/games/roulette"
description: Part of Provably Fair Games
operationId: fair-games_post_api_games_roulette
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-wallet/api/wallets/create:
post:
tags:
- DeFi & Crypto
summary: "Agent Wallet \u2014 /api/wallets/create"
description: Non-custodial multi-chain wallet API. Create wallets, check balances, send transactions across 7 chains.
operationId: agent-wallet_post_api_wallets_create
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-wallet/api/wallets/{id}/balance:
get:
tags:
- DeFi & Crypto
summary: "Agent Wallet \u2014 /api/wallets/:id/balance"
description: Part of Agent Wallet
operationId: agent-wallet_get_api_wallets_id_balance
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
parameters:
- name: id
in: path
required: true
schema:
type: string
/v1/agent-wallet/api/wallets/{id}/send:
post:
tags:
- DeFi & Crypto
summary: "Agent Wallet \u2014 /api/wallets/:id/send"
description: Part of Agent Wallet
operationId: agent-wallet_post_api_wallets_id_send
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
/v1/defi-trading/api/markets:
get:
tags:
- DeFi & Crypto
summary: "DeFi Trading Proxy \u2014 /api/markets"
description: REST API wrapper around Hyperliquid DEX. 229 perpetual futures markets. Market orders, limit orders, positions.
operationId: defi-trading_get_api_markets
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/defi-trading/api/orders:
post:
tags:
- DeFi & Crypto
summary: "DeFi Trading Proxy \u2014 /api/orders"
description: Part of DeFi Trading Proxy
operationId: defi-trading_post_api_orders
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/defi-trading/api/positions:
get:
tags:
- DeFi & Crypto
summary: "DeFi Trading Proxy \u2014 /api/positions"
description: Part of DeFi Trading Proxy
operationId: defi-trading_get_api_positions
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/onchain-analytics/api/tokens/{address}:
get:
tags:
- Data & Analytics
summary: "On-Chain Analytics \u2014 /api/tokens/:address"
description: Token analytics via DexScreener + GeckoTerminal. Price, volume, liquidity, holders across 8 chains.
operationId: onchain-analytics_get_api_tokens_address
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
parameters:
- name: address
in: path
required: true
schema:
type: string
/v1/onchain-analytics/api/search:
get:
tags:
- Data & Analytics
summary: "On-Chain Analytics \u2014 /api/search"
description: Part of On-Chain Analytics
operationId: onchain-analytics_get_api_search
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/onchain-analytics/api/trending:
get:
tags:
- Data & Analytics
summary: "On-Chain Analytics \u2014 /api/trending"
description: Part of On-Chain Analytics
operationId: onchain-analytics_get_api_trending
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/defi-mcp/mcp/tools/call:
post:
tags:
- DeFi & Crypto
summary: "DeFi MCP Server \u2014 /mcp/tools/call"
description: Model Context Protocol server for DeFi operations. 12 tools for token research, prices, and analytics.
operationId: defi-mcp_post_mcp_tools_call
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/defi-mcp/mcp/tools/list:
get:
tags:
- DeFi & Crypto
summary: "DeFi MCP Server \u2014 /mcp/tools/list"
description: Part of DeFi MCP Server
operationId: defi-mcp_get_mcp_tools_list
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/crypto-feeds/ws/ticker:
ws:
tags:
- Data & Analytics
summary: "Crypto Data Feeds \u2014 /ws/ticker"
description: Real-time WebSocket price feeds via Bybit. 40 trading pairs. Ticker, klines, orderbook, trades.
operationId: crypto-feeds_ws_ws_ticker
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/crypto-feeds/ws/kline:
ws:
tags:
- Data & Analytics
summary: "Crypto Data Feeds \u2014 /ws/kline"
description: Part of Crypto Data Feeds
operationId: crypto-feeds_ws_ws_kline
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/crypto-feeds/api/prices:
get:
tags:
- Data & Analytics
summary: "Crypto Data Feeds \u2014 /api/prices"
description: Part of Crypto Data Feeds
operationId: crypto-feeds_get_api_prices
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/contract-deployer/api/compile:
post:
tags:
- Other
summary: "Smart Contract Deployer \u2014 /api/compile"
description: Compile and deploy Solidity contracts. 9 chains, 5 templates (ERC-20, ERC-721, etc.). Built-in solc 0.8.x.
operationId: contract-deployer_post_api_compile
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/contract-deployer/api/deploy:
post:
tags:
- Other
summary: "Smart Contract Deployer \u2014 /api/deploy"
description: Part of Smart Contract Deployer
operationId: contract-deployer_post_api_deploy
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/contract-deployer/api/templates:
get:
tags:
- Other
summary: "Smart Contract Deployer \u2014 /api/templates"
description: Part of Smart Contract Deployer
operationId: contract-deployer_get_api_templates
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/agent-registry/api/services/register:
post:
tags:
- Agent Infrastructure
summary: "Agent Registry & Discovery \u2014 /api/services/register"
description: Service registry for AI agents. Register, discover, search, rate, and monitor agent services.
operationId: agent-registry_post_api_services_register
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-registry/api/services/search:
get:
tags:
- Agent Infrastructure
summary: "Agent Registry & Discovery \u2014 /api/services/search"
description: Part of Agent Registry & Discovery
operationId: agent-registry_get_api_services_search
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/agent-registry/api/services/{id}:
get:
tags:
- Agent Infrastructure
summary: "Agent Registry & Discovery \u2014 /api/services/:id"
description: Part of Agent Registry & Discovery
operationId: agent-registry_get_api_services_id
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
parameters:
- name: id
in: path
required: true
schema:
type: string
/v1/agent-identity/api/identities/create:
post:
tags:
- Agent Infrastructure
summary: "Agent Identity Service \u2014 /api/identities/create"
description: Disposable identities for AI agents. Ed25519 signing, DIDs, attestations, challenge-response auth.
operationId: agent-identity_post_api_identities_create
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-identity/api/identities/{id}/sign:
post:
tags:
- Agent Infrastructure
summary: "Agent Identity Service \u2014 /api/identities/:id/sign"
description: Part of Agent Identity Service
operationId: agent-identity_post_api_identities_id_sign
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-identity/api/auth/challenge:
post:
tags:
- Agent Infrastructure
summary: "Agent Identity Service \u2014 /api/auth/challenge"
description: Part of Agent Identity Service
operationId: agent-identity_post_api_auth_challenge
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-referral/api/programs/create:
post:
tags:
- Agent Infrastructure
summary: "Agent Referral Network \u2014 /api/programs/create"
description: Referral tracking for agent-to-agent commissions. Programs, affiliates, click/conversion tracking, leaderboards.
operationId: agent-referral_post_api_programs_create
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-referral/api/track/click:
post:
tags:
- Agent Infrastructure
summary: "Agent Referral Network \u2014 /api/track/click"
description: Part of Agent Referral Network
operationId: agent-referral_post_api_track_click
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-referral/api/track/conversion:
post:
tags:
- Agent Infrastructure
summary: "Agent Referral Network \u2014 /api/track/conversion"
description: Part of Agent Referral Network
operationId: agent-referral_post_api_track_conversion
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/token-launchpad/api/tokens/create:
post:
tags:
- Other
summary: "Token Launchpad \u2014 /api/tokens/create"
description: Deploy ERC-20 tokens. 5 templates, 7 chains. Built-in solc compilation and on-chain deployment.
operationId: token-launchpad_post_api_tokens_create
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/token-launchpad/api/templates:
get:
tags:
- Other
summary: "Token Launchpad \u2014 /api/templates"
description: Part of Token Launchpad
operationId: token-launchpad_get_api_templates
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/token-launchpad/api/deployments:
get:
tags:
- Other
summary: "Token Launchpad \u2014 /api/deployments"
description: Part of Token Launchpad
operationId: token-launchpad_get_api_deployments
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/agent-memory/api/kv/set:
post:
tags:
- Agent Infrastructure
summary: "Agent Memory \u2014 /api/kv/set"
description: Persistent key-value storage + vector search for AI agents. 128d embeddings, conversations, namespaces.
operationId: agent-memory_post_api_kv_set
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-memory/api/kv/get/{key}:
get:
tags:
- Agent Infrastructure
summary: "Agent Memory \u2014 /api/kv/get/:key"
description: Part of Agent Memory
operationId: agent-memory_get_api_kv_get_key
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
parameters:
- name: key
in: path
required: true
schema:
type: string
/v1/agent-memory/api/vectors/search:
post:
tags:
- Agent Infrastructure
summary: "Agent Memory \u2014 /api/vectors/search"
description: Part of Agent Memory
operationId: agent-memory_post_api_vectors_search
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-taskqueue/api/tasks/enqueue:
post:
tags:
- Agent Infrastructure
summary: "Agent Task Queue \u2014 /api/tasks/enqueue"
description: Distributed job queue for AI agents. Workers, priorities, workflows, DLQ, webhook callbacks.
operationId: agent-taskqueue_post_api_tasks_enqueue
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-taskqueue/api/tasks/dequeue:
post:
tags:
- Agent Infrastructure
summary: "Agent Task Queue \u2014 /api/tasks/dequeue"
description: Part of Agent Task Queue
operationId: agent-taskqueue_post_api_tasks_dequeue
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-taskqueue/api/tasks/{id}:
get:
tags:
- Agent Infrastructure
summary: "Agent Task Queue \u2014 /api/tasks/:id"
description: Part of Agent Task Queue
operationId: agent-taskqueue_get_api_tasks_id
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
parameters:
- name: id
in: path
required: true
schema:
type: string
/v1/agent-secrets/api/vaults/create:
post:
tags:
- Agent Infrastructure
summary: "Agent Secrets Vault \u2014 /api/vaults/create"
description: Encrypted secret storage. AES-256-GCM encryption, vault namespaces, versioning, audit logs.
operationId: agent-secrets_post_api_vaults_create
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-secrets/api/secrets/set:
post:
tags:
- Agent Infrastructure
summary: "Agent Secrets Vault \u2014 /api/secrets/set"
description: Part of Agent Secrets Vault
operationId: agent-secrets_post_api_secrets_set
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
requestBody:
content:
application/json:
schema:
type: object
/v1/agent-secrets/api/secrets/get:
get:
tags:
- Agent Infrastructure
summary: "Agent Secrets Vault \u2014 /api/secrets/get"
description: Part of Agent Secrets Vault
operationId: agent-secrets_get_api_secrets_get
responses:
'200':
description: Successful response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required (x402)
'429':
description: Rate limit exceeded
/v1/agent-schedu
# --- truncated at 32 KB (113 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/frostbyte/refs/heads/main/openapi/frostbyte-agent-gateway-openapi.yml