![\"Dexter\"](\"https://raw.githubusercontent.com/Dexter-DAO/dexter-x402-sdk/main/assets/dexter-wordmark.svg\")
\n\n \n
\n x402 payments and discovery for OpenClaw agents.
\n Search the OpenDexter working set, preview pricing, and auto-pay with local wallet keys.\n
\n ![\"npm\"](\"https://img.shields.io/npm/v/@dexterai/clawdexter.svg\")
\n ![\"Node\"](\"https://img.shields.io/badge/node-%3E=18-brightgreen.svg\"){kind=icon}
\n ![\"Marketplace\"](\"https://img.shields.io/badge/Marketplace-dexter.cash-blueviolet\"){kind=icon}
![\"License\"](\"https://img.shields.io/badge/license-MIT-green.svg\"){kind=icon}
\n
\n Browse paid APIs →\n
\n\n---\n\n## What is Clawdexter?\n\nClawdexter is an **OpenClaw plugin**, not a hosted Claude MCP server.\n\nIt brings the OpenDexter x402 workflow into OpenClaw with five tools:\n\n- `x402_search`\n- `x402_check`\n- `x402_fetch`\n- `x402_pay`\n- `x402_wallet`\n\nUse it when you want OpenClaw agents to discover and pay for x402 resources with locally configured wallet keys.\n\n## What is x402?\n\n[x402](https://www.x402.org) is an open protocol for HTTP-native micropayments. When a server returns **402 Payment Required**, the client signs a USDC payment and retries — the server verifies and serves the response. No API keys, no subscriptions, no invoices.\n\nClawDexter brings x402 to every OpenClaw agent. It ships five tools that let agents discover paid APIs, check prices, pay automatically, and track spending — all with a single OpenClaw wallet configuration.\n\n## Install\n\nClawDexter is an OpenClaw plugin. Install it from the OpenClaw plugin registry or add it directly:\n\n```bash\nopenclaw plugins install @dexterai/clawdexter\n```\n\nThen configure your wallet in `~/.openclaw/openclaw.json`:\n\n```json\n{\n \"plugins\": {\n \"clawdexter\": {\n \"svmPrivateKey\": \"base58_solana_private_key\",\n \"evmPrivateKey\": \"0x_hex_evm_private_key\",\n \"maxPaymentUSDC\": \"0.50\"\n }\n }\n}\n```\n\nYou can configure one wallet or both. Solana keys are base58-encoded, EVM keys are hex with `0x` prefix.\n\n## Tools\n\n### x402_search\n\nSearch the OpenDexter marketplace for x402-enabled paid APIs. Returns quality-ranked results with pricing, verification status, seller reputation, and settlement volume.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `query` | string | No | Search term (e.g. \"token analysis\", \"image generation\") |\n| `network` | string | No | Filter by network: `solana`, `base`, `polygon`, `arbitrum`, `optimism`, `avalanche` |\n| `verified` | boolean | No | Only show quality-verified endpoints |\n| `category` | string | No | Filter by category (e.g. \"api\", \"creative\") |\n| `maxPriceUsdc` | number | No | Maximum price per call in USDC |\n| `sort` | string | No | Sort: `marketplace` (default), `relevance`, `quality_score`, `settlements`, `volume`, `recent` |\n| `limit` | number | No | Max results (default 20, max 50) |\n\n```\n\"Search for Solana analytics APIs under $0.10\"\n```\n\n### x402_fetch\n\nCall any x402-protected endpoint with automatic payment. This is the recommended tool for making paid API calls — the agent gets the response directly along with a payment receipt.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `url` | string | Yes | The x402 resource URL |\n| `method` | string | No | HTTP method (default `GET`) |\n| `body` | string | No | JSON body for POST/PUT requests |\n\n```\n\"Use x402_fetch to call https://x402.dexter.cash/api/tools/solscan/trending\"\n```\n\n**How it works:**\n\n1. Sends the request to the URL\n2. Receives `402 Payment Required` with payment terms\n3. Signs a USDC payment matching the requested amount and chain\n4. Retries with the payment proof header\n5. Returns the API response and spend receipt\n\n### x402_pay\n\nExplicit payment-oriented version of the same x402 flow.\n\nUse `x402_pay` when you want the calling pattern to be framed as:\n\n1. search\n2. check\n3. pay and call\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `url` | string | Yes | The x402 endpoint URL |\n| `method` | string | No | HTTP method (default `GET`) |\n| `params` | object | No | Query params (GET) or JSON body (POST) |\n| `headers` | object | No | Custom HTTP headers |\n\nUse `x402_fetch` for most calls. Use `x402_pay` when you need custom headers, query parameters on GET requests, or non-JSON payloads.\n\n### x402_check\n\nProbe an endpoint for payment requirements without paying. Returns pricing per chain, accepted networks, pay-to addresses, and the x402 protocol version.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `url` | string | Yes | The URL to check |\n| `method` | string | No | HTTP method to probe (default `GET`) |\n\n```\n\"Use x402_check to see what https://x402.dexter.cash/api/jupiter/quote costs\"\n```\n\nReturns `requiresPayment: false` for free endpoints, or a list of `paymentOptions` with per-chain pricing.\n\n### x402_wallet\n\nShow which local wallets are configured, the default network, and the per-call spending limit.\n\nNo parameters. Returns configured wallet types, active network, and `maxPaymentUsdc`.\n\n## Configuration\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `svmPrivateKey` | string | — | Solana private key (base58) for Solana payments |\n| `evmPrivateKey` | string | — | EVM private key (hex, `0x`-prefixed) for Base/Polygon/Arbitrum/Optimism/Avalanche |\n| `defaultNetwork` | string | `\"solana\"` | Preferred payment network |\n| `maxPaymentUSDC` | string | `\"0.50\"` | Maximum USDC per request (e.g. `\"1.00\"` = $1) |\n| `marketplaceUrl` | string | Dexter API | Override marketplace search endpoint |\n| `directoryUrl` | string | Dexter API | Override x402 directory endpoint |\n| `disableTelemetry` | boolean | `false` | Disable anonymous usage telemetry |\n\n## Supported Networks\n\n| Network | Chain ID (CAIP-2) | Asset |\n|---------|-------------------|-------|\n| Solana | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` | USDC (SPL) |\n| Base | `eip155:8453` | USDC (ERC-20) |\n| Polygon | `eip155:137` | USDC (ERC-20) |\n| Arbitrum | `eip155:42161` | USDC (ERC-20) |\n| Optimism | `eip155:10` | USDC (ERC-20) |\n| Avalanche | `eip155:43114` | USDC (ERC-20) |\n\nSolana requires `svmPrivateKey`. All EVM chains share `evmPrivateKey`.\n\n## Architecture\n\n```\n┌───────────────┐ ┌──────────────────────┐\n│ OpenClaw │ │ x402-enabled APIs │\n│ Agent │────────►│ (OpenDexter market) │\n│ │ fetch │ │\n└───────┬───────┘ └──────────┬───────────┘\n │ │\n │ 402 Payment Required │ 200 OK + data\n │◄───────────────────────────│\n │ │\n │ USDC payment signature │\n │───────────────────────────►│\n │ │\n ▼ ▼\n┌───────────────┐ ┌──────────────────────┐\n│ @dexterai/ │ │ Dexter Marketplace │\n│ x402 SDK │ │ dexter.cash │\n│ (payment │ │ (search, rankings, │\n│ signing) │ │ verification) │\n└───────────────┘ └──────────────────────┘\n```\n\nThe plugin uses [`@dexterai/x402`](https://www.npmjs.com/package/@dexterai/x402) to sign USDC payments client-side. No funds are custodied — the wallet keys stay local and payments are signed on-device.\n\n## Troubleshooting\n\n### \"No wallet configured\"\n\nSet at least one key in plugin config:\n\n```json\n{\n \"plugins\": {\n \"clawdexter\": {\n \"svmPrivateKey\": \"your_solana_key\"\n }\n }\n}\n```\n\n### Payment rejected (amount_exceeds_max)\n\nThe endpoint costs more than your `maxPaymentUSDC` limit. Increase it:\n\n```json\n{\n \"maxPaymentUSDC\": \"1.00\"\n}\n```\n\n### Insufficient balance\n\nFund your wallet with USDC on the appropriate network. Solana wallets need SPL USDC, EVM wallets need ERC-20 USDC on the target chain.\n\n### Tools not appearing\n\nVerify the plugin is enabled:\n\n```bash\nopenclaw plugins list\n```\n\n## Dependencies\n\n| Package | Purpose |\n|---------|---------|\n| [`@dexterai/x402`](https://www.npmjs.com/package/@dexterai/x402) | x402 payment signing (client SDK) |\n| [`@sinclair/typebox`](https://github.com/sinclairzx81/typebox) | Runtime type validation for tool schemas |\n\n## Links\n\n- [OpenDexter Marketplace](https://dexter.cash/opendexter) — Browse and discover paid APIs\n- [x402 Protocol](https://www.x402.org) — Protocol specification\n- [Dexter](https://dexter.cash) — Dexter AI platform\n- [OpenClaw](https://github.com/openclaw/openclaw) — AI agent framework\n- [@dexterai/x402 SDK](https://www.npmjs.com/package/@dexterai/x402) — Seller SDK for publishing x402 endpoints\n- [@dexterai/opendexter](https://www.npmjs.com/package/@dexterai/opendexter) — Standalone MCP server with session wallets\n- [Discord](https://discord.gg/dexter) — Community support\n\n## License\n\nMIT\n","readmeFilename":"README.md"}