x402dash — AI agent integration guide

Service identity

x402dash (also known as x402market) is a liveness monitoring and discovery index for the x402 payment protocol ecosystem.

It tracks 7000+ API endpoints registered in the Coinbase CDP Bazaar, checks their availability every 30 minutes, computes a liveness score (0–100), and enriches metadata with AI classification and tags.

Primary use case for agents

An AI agent that needs to call external APIs (data feeds, DeFi, oracles, AI services) can use /v1/search to discover which x402 endpoints are currently alive, what they cost, and whether they are ready to call — before spending USDC on the wrong endpoint.

Base URLs

https://api.x402dash.com primary
https://api.x402market.shop fallback

HTTPS only. All responses are JSON. CORS open. No API key required for free endpoints.

Payment capabilities

GET https://api.x402dash.com/.well-known/x402

Returns the x402 protocol manifest: paid endpoints, accepted asset (USDC on Base), prices, and payTo address. Always check this first — prices may change.

LLM discovery file

GET https://x402dash.com/llms.txt

Structured Markdown summary of the service for LLM context injection. Lists all API endpoints with signatures, payment model, and agent-ready query examples.

Ecosystem stats

GET https://api.x402dash.com/v1/ecosystem

Live aggregate: total endpoints indexed, average liveness score, readiness breakdown (ready_now / needs_payload / not_ready), last crawl time.

Search categories

GET /v1/categories
→ { "items": [{ "category": "DeFi / Crypto", "count": 4200 }, ...] }

Get all category names and endpoint counts. Use these values as the category filter in search.

Browse endpoints

GET /v1/endpoints
  ?limit=50 &offset=0
  &q=oracle
  &category=DeFi%2FCrypto
  &provider=example.com
→ { "items": [...], "total": 312 }

Paginated listing. Includes liveness_score, integration_readiness, ai_category, ai_tags, avg_latency_ms.

Single endpoint detail

GET /v1/liveness?endpoint=<id-or-url>
→ full record with accepts[], ai_description,
  ai_tags, all L1-L3 scores, price_usd

Full record for one endpoint. Use this to read the payment spec before calling it.

Provider list

GET /v1/providers
  ?limit=100 &q=hostname
→ { "items": [{ "provider": "api.example.com",
    "endpoint_count": 5, "avg_score": 82.3,
    "categories": ["DeFi / Crypto"] }] }

Groups endpoints by host. Useful for evaluating a provider's overall reliability before querying individual endpoints.

Health check

GET /v1/health
→ { "status": "ok", "latest_run": {...} }

Confirms the service is operational and shows the most recent crawl run metadata.

Full-text search $0.002/query

GET /v1/search
  ?q=defi+oracle          (required)
  &limit=20               (max 100)
  &offset=0
  &category=DeFi%2FCrypto
  &min_score=50.0
  &integration_readiness=ready_now
  &network=eip155%3A8453
  &max_price_usd=0.01
→ { "items": [...], "total": 47, "filters": {...} }

FTS5/BM25 ranked search. Each result includes accepts[] inline — payment spec for that endpoint — so no second call is needed. AI-enriched descriptions when available.

Agent-optimized filters: integration_readiness=ready_now to exclude unreliable endpoints, network=eip155:8453 for Base-only, max_price_usd=0.01 to stay within budget.

Liveness history $0.003/query

GET /v1/history
  ?endpoint=<id-or-url>  (required)
  &limit=100              (max 500)
→ { "items": [{ "timestamp": "...",
    "alive": true, "latency_ms": 234,
    "http_status": 200, "error": null }],
  "endpoint_id": "..." }

Complete check history in chronological order. Use to assess reliability trends before committing to an endpoint.

liveness_score (0–100)

Composite reliability score: L1 response rate (47%), L2 metadata completeness (29%), L3 stability over time (24%). Use min_score=60 to filter for high-quality endpoints.

integration_readiness

ready_now — endpoint is alive and callable with a minimal request.
needs_payload — alive but requires a specific request body.
not_ready — unreliable or dead.
Use ready_now in search to only surface immediately callable endpoints.

accepts[] (in search + liveness)

Payment spec for the indexed endpoint itself — not for x402dash. Contains network, payTo, asset, maxAmountRequired. Populated from the endpoint's x402 metadata.

ai_description / ai_tags

LLM-assigned description and keyword tags (updated hourly). More accurate than raw metadata. Factored into FTS index for better search relevance.

price_usd / network

The cost to call the indexed endpoint (not x402dash). Use max_price_usd in search to stay within agent budget constraints.

liveness_confidence

high ≥20 checks, medium ≥5 checks, low <5 checks. Newer endpoints have low confidence — factor this into decision logic.

Payment constants

Network:  eip155:8453 (Base mainnet)
USDC:     0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
payTo:    0x8c751d62141c9DF97292815B7ba5F1cAdEBBCE32
/v1/search:   maxAmountRequired "2000" ($0.002)
/v1/history:  maxAmountRequired "3000" ($0.003)
USDC decimals: 6

x402 client libraries

The x402 protocol is open. Reference implementations and facilitator docs: x402.org. CDP-compatible wallets support EIP-3009 signing natively.

The x402 Python SDK and TypeScript SDK both support automatic payment retry when a 402 is received.

Find a DeFi oracle on Base

GET /v1/search
  ?q=defi+price+oracle
  &integration_readiness=ready_now
  &network=eip155%3A8453
  &max_price_usd=0.005
  &min_score=50
  &limit=5
+ X-Payment: <signed $0.002 USDC>

→ Pick item[0], read accepts[0].payTo
  and maxAmountRequired to call it.

Verify reliability before spending

# Free: check current liveness
GET /v1/liveness?endpoint=<id>
→ liveness_score, integration_readiness

# Paid: check history if score borderline
GET /v1/history?endpoint=<id>&limit=50
+ X-Payment: <signed $0.003 USDC>
→ count alive/total, check error patterns

Discover all AI-related endpoints

GET /v1/search
  ?q=AI+inference+model
  &integration_readiness=ready_now
  &min_score=40
+ X-Payment: <signed $0.002 USDC>

# Also try category browse (free):
GET /v1/endpoints
  ?category=AI%20%2F%20Compute
  &limit=50

Full discovery pipeline

1. GET /v1/ecosystem   → total counts, avg score
2. GET /v1/categories  → available category names
3. GET /v1/search?q=...  → targeted search (paid)
4. GET /v1/liveness?endpoint=... → full details
5. Call the endpoint using its accepts[] spec

Crawl cadence

All endpoints are probed every 30 minutes. Liveness data is never more than 30 minutes old. Last crawl time is available in /v1/ecosystem.latest_run and /v1/health.latest_run.

AI enrichment

Descriptions and tags are enriched by LLM every hour for endpoints without AI data (50 endpoints per run). Fields: ai_description, ai_category, ai_tags, ai_enriched_at.

Data source

Endpoints are sourced from the Coinbase CDP Bazaar (public registry). Data reflects publicly listed x402 endpoints only. No private APIs are indexed.

Payments are final

x402 payments settle on-chain. Each paid request is a separate transaction. The service never pre-authorizes or batches charges. If a query returns 402 with no data, no USDC was spent.

Free endpoints

10 requests/minute per IP. Sufficient for discovery and integration testing. HTTP 429 + Retry-After on violation.

Paid endpoints

60 requests/minute per IP. Full production throughput for paying agents. Payment is enforced independently of rate limits.

Hard thresholds

IPs generating >500 requests in 10 minutes or >2000/hour may be automatically suspended. See Terms/AUP for full policy.