<p align="center">
  <img src="https://raw.githubusercontent.com/Dexter-DAO/dexter-x402-sdk/main/assets/dexter-wordmark.svg" alt="Dexter" width="360">
</p>

<h1 align="center">dexter-lobster-skill</h1>

<p align="center">
  <strong>x402 API marketplace skill for lobster.cash agents. Pay-per-call access to a continuously growing catalog of verified APIs.</strong>
</p>

<p align="center">
  <a href="https://dexter.cash/marketplace"><strong>Browse the marketplace →</strong></a> · <a href="https://lobster.cash"><strong>Get a wallet →</strong></a> · <a href="https://lobster.cash/docs/skill-compatibility-guide"><strong>Compatibility guide →</strong></a>
</p>

---

## Quick Start

### 1. Install the lobster.cash wallet (if you haven't already)

```bash
openclaw plugins install @crossmint/lobster.cash
```

Then tell your agent: *"Set up my wallet"* — open the consent link and approve.

### 2. Install the Dexter marketplace skill

```bash
openclaw plugins install @dexterai/dexter-lobster
```

### 3. Start using paid APIs

Ask your agent:

- *"What smart money wallets are buying right now?"*
- *"Scan this token contract for honeypots"*
- *"Get Polymarket odds on the next election"*
- *"Run this prompt through Claude via OpenRouter"*

The skill searches the Dexter bazaar, shows you pricing, and when you want to call an endpoint, lobster.cash handles the payment through the Dexter facilitator.

## How It Works

```
Agent → dexter-lobster skill → Dexter Bazaar (search / pricing)
                              → lobster.cash  (payment delegation)
                              → x402.dexter.cash (settlement)
                              → Solana (on-chain)
```

**Search** and **pricing** are free. When the agent calls a paid endpoint, it describes the payment intent and [lobster.cash](https://lobster.cash) handles execution through the Dexter facilitator. The skill never touches private keys, never builds transactions, never signs anything.

## What's Available

The Dexter bazaar indexes x402 endpoints from across the ecosystem. Featured providers include Nansen, Alchemy, Allium, CoinGecko, OpenRouter, Exa, Dome, Quick Intel, Quicknode, Laso Finance, and many more -- covering DeFi analytics, AI/LLM inference, prediction markets, blockchain infrastructure, security scanning, person/company intelligence, payments, and document parsing.

The catalog grows automatically. New endpoints are crawled from facilitator discovery feeds every 2 hours, auto-named by AI, and quality-verified with paid test calls every 24 hours. Run `./scripts/x402.sh categories` to see the current breakdown.

## Get Your API Listed

Any x402-enabled endpoint can appear in the Dexter bazaar. Here's how:

1. **Make your API x402-compliant** — return HTTP 402 with an `accepts` array containing your pricing, asset (USDC), network, and `payTo` wallet. Use `@dexterai/x402` server middleware or any x402-compatible stack.

2. **Facilitate through a known facilitator** — endpoints that settle through [x402.dexter.cash](https://x402.dexter.cash), [Coinbase CDP](https://api.cdp.coinbase.com), [PayAI](https://facilitator.payai.network), or [Ultraviolet](https://facilitator.ultravioletadao.xyz) are automatically crawled every 2 hours.

3. **Wait for ingestion** — once crawled, Dexter's AI auto-namer generates a display name, description, and category for your endpoint. The quality verifier then pays for a real call, generates realistic test inputs using AI, scores the response quality (0–100), and writes detailed notes.

4. **Pass quality verification** — endpoints scoring 75+ are auto-approved for the marketplace. Below 50 gets flagged for review. The verifier re-tests every 24 hours so quality stays current.

5. **Optional: register directly** — submit your endpoint URL via `POST /api/x402/resources/register` on `api.dexter.cash` to skip waiting for the next crawl cycle.

## Facilitator

Settlement runs through [x402.dexter.cash](https://x402.dexter.cash):

- **Gas-sponsored** — you pay $0 in SOL/ETH
- **Smart wallet support** — PDA wallets (Crossmint, Squads) via simulation-based CPI verification
- **Multi-network** — Solana, Base, Polygon, Arbitrum, Optimism, SKALE
- **x402 v1 + v2** — backward-compatible with both protocol versions

## lobster.cash Compatibility

Built to the [lobster.cash skill compatibility guide](https://lobster.cash/docs/skill-compatibility-guide):

- Wallet precheck before every payment
- Payment intent description — not execution
- Full error handling (insufficient balance, wallet not configured, payment failure)
- Zero key handling — all wallet operations delegated to lobster.cash

## Repo Structure

```
skills/SKILL.md           ← what the agent reads
openclaw.plugin.json      ← plugin manifest
_meta.json                ← registry metadata
scripts/x402.sh           ← CLI for search & pricing
references/
  api-endpoints.md        ← bazaar API docs
  categories.md           ← category breakdown
```

## Links

| | |
|---|---|
| **Marketplace** | [dexter.cash/marketplace](https://dexter.cash/marketplace) |
| **Facilitator** | [x402.dexter.cash](https://x402.dexter.cash) |
| **Agent Wallet** | [lobster.cash](https://lobster.cash) |
| **x402 SDK** | [@dexterai/x402](https://www.npmjs.com/package/@dexterai/x402) |
| **Register an API** | `POST api.dexter.cash/api/x402/resources/register` |
| **Compatibility Guide** | [lobster.cash/docs/skill-compatibility-guide](https://lobster.cash/docs/skill-compatibility-guide) |
