---
title: Search for Service
description: Search and browse the x402 bazaar marketplace for paid API services
---

# Search for Service

Discover and inspect paid API endpoints available on the x402 bazaar marketplace. No authentication or balance is required for searching.

---

## Commands

### Search the Bazaar

Find paid services by keyword using BM25 relevance search:

```bash
npx agnic@latest x402 bazaar search <query> [-k <n>] [--force-refresh] [--json]
```

| Option | Description |
|--------|-------------|
| `-k, --top <n>` | Number of results (default: 5) |
| `--force-refresh` | Re-fetch resource index from CDP API |
| `--json` | Output as JSON |

Results are cached locally at `~/.config/agnic/bazaar/` and auto-refresh after 12 hours.

### List Bazaar Resources

Browse all available resources:

```bash
npx agnic@latest x402 bazaar list [--network <network>] [--full] [--json]
```

| Option | Description |
|--------|-------------|
| `--network <name>` | Filter by network (`base`, `base-sepolia`) |
| `--full` | Show complete details including schemas |
| `--json` | Output as JSON |

### Inspect x402 Requirements

Check an endpoint's x402 requirements without transacting:

```bash
npx agnic@latest x402 details <url> [--json]
```

Auto-detects the correct HTTP method by trying each until it gets a 402 response, then displays price, accepted authorization schemes, network, and input/output schemas.

---

## Examples

```bash
# Search for weather-related paid APIs
npx agnic@latest x402 bazaar search "weather"

# Search with more results
npx agnic@latest x402 bazaar search "sentiment analysis" -k 10

# Browse all bazaar resources with full details
npx agnic@latest x402 bazaar list --full

# Check what an endpoint costs
npx agnic@latest x402 details https://example.com/api/weather
```

---

## Prerequisites

- No authentication needed for search, list, or details commands

---

## Error Handling

| Error | Solution |
|-------|----------|
| "CDP API returned 429" | Rate limited; cached data will be used if available |
| "No X402 requirements found" | URL may not be an x402 endpoint |
| No results | Try broadening the search query or using different keywords |

---

## Next Steps

<Cards>
  <Card title="Pay for Service" href="/docs/agentic-wallet/skills/pay-for-service">
    Make a paid request to an x402 endpoint
  </Card>
  <Card title="Skills Overview" href="/docs/agentic-wallet/skills">
    Browse all available skills
  </Card>
</Cards>