search-for-service
coinbase/agentic-wallet-skills
Search and browse the x402 bazaar marketplace for paid API services.
What is search-for-service?
Discover available paid APIs and services on the x402 bazaar without authentication. Use this skill to find external services by keyword, browse all available resources, or inspect an endpoint's pricing and requirements before making a paid request.
- Search the bazaar by keyword using vector search with customizable filters (network, price, payment scheme)
- List all available bazaar resources with optional full details including schemas
- Inspect any endpoint's x402 payment requirements, pricing, and input/output schemas without paying
- Filter results by blockchain network (Base, Polygon, Solana) and payment asset
- No authentication or balance required for searching, listing, or inspecting endpoints
How to install search-for-service
npx skills add https://github.com/coinbase/agentic-wallet-skills --skill search-for-serviceHow to use search-for-service
- 1.Run `npx awal@2.10.0 x402 bazaar search <query>` to find services by keyword (e.g., 'weather', 'sentiment analysis')
- 2.Use filters like `-k 10` for result count, `--max-price 0.01` for budget, or `--network base` for specific chains
- 3.Run `npx awal@2.10.0 x402 bazaar list --full` to browse all available resources with complete details
- 4.Use `npx awal@2.10.0 x402 details <url>` to inspect a specific endpoint's pricing and requirements
- 5.Once you've found a service, use the pay-for-service skill to make a paid request to the endpoint
Use cases
- Find a weather API or sentiment analysis service when you need external data processing
- Discover what paid services are available on x402 before deciding which to use
- Check the cost and payment requirements of a specific API endpoint
- Browse all available resources to understand the marketplace offerings
- Filter services by maximum price to find affordable options within budget
- Developers building agents that need external API services
- Users exploring what paid services are available on the x402 marketplace
- Anyone evaluating API costs before committing to a paid request
- Agents needing to discover services when no other skill matches the request
search-for-service FAQ
No. Search, list, and details commands require no authentication or balance. You only need to pay when actually making a request through the pay-for-service skill.
Base, Base Sepolia, Polygon, Solana, and Solana Devnet. Filter results using the `--network` option.
Use the `--max-price <price>` option (e.g., `--max-price 0.01`) to show only services within your budget in USD.
The API is rate limited. The tool will use cached data if available. Wait a moment and retry.
Use `npx awal@2.10.0 x402 details <url>` to inspect the endpoint's payment requirements, pricing, and schemas without making a payment.
Full instructions (SKILL.md)
Source of truth, from coinbase/agentic-wallet-skills.
name: search-for-service description: Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches — search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar". user-invocable: true disable-model-invocation: false allowed-tools: ["Bash(npx awal@2.10.0 x402 bazaar *)", "Bash(npx awal@2.10.0 x402 details *)"]
Searching the x402 Bazaar
Use the npx awal@2.10.0 x402 commands to 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 CDP's vector search:
npx awal@2.10.0 x402 bazaar search <query> [-k <n>] [--network <network>] [--scheme <scheme>] [--max-price <price>] [--json]
| Option | Description |
|---|---|
-k, --top <n> | Number of results, 1–20 (default: 20) |
--network <name> | Filter by chain (base, base-sepolia, polygon, solana, solana-devnet) |
--scheme <scheme> | Filter by payment scheme: exact or upto |
--max-price <price> | Maximum price in USD (e.g. 0.01) |
--asset <address> | Filter by payment asset address |
--pay-to <address> | Filter by recipient wallet address |
--extensions <type> | Filter by extension type (e.g. outputSchema, bazaar) |
--json | Output as JSON |
List Bazaar Resources
Browse all available resources:
npx awal@2.10.0 x402 bazaar list [--network <network>] [--full] [--refresh] [--json]
| Option | Description |
|---|---|
--network <name> | Filter by chain (base, base-sepolia, polygon, solana, solana-devnet) |
--full | Show complete details including schemas |
--refresh | Re-fetch resource index from CDP API |
--json | Output as JSON |
Discover Payment Requirements
Inspect an endpoint's x402 payment requirements without paying:
npx awal@2.10.0 x402 details <url> [--json]
Auto-detects the correct HTTP method (GET, POST, PUT, DELETE, PATCH) by trying each until it gets a 402 response, then displays price, accepted payment schemes, network, and input/output schemas.
Examples
# Search for weather-related paid APIs
npx awal@2.10.0 x402 bazaar search "weather"
# Search with more results
npx awal@2.10.0 x402 bazaar search "sentiment analysis" -k 10
# Browse all bazaar resources with full details
npx awal@2.10.0 x402 bazaar list --full
# Check what an endpoint costs
npx awal@2.10.0 x402 details https://example.com/api/weather
Prerequisites
- No authentication needed for search, list, or details commands
Next Steps
Once you've found a service you want to use, use the pay-for-service skill to make a paid request to the endpoint.
Error Handling
- "CDP API returned 429" - Rate limited; cached data will be used if available
- "No X402 payment requirements found" - URL may not be an x402 endpoint
Related skills
More from coinbase/agentic-wallet-skills and the wider catalog.
send-usdc
Send USDC, ETH, POL, or SOL to any address or ENS name on Base, Polygon, or Solana.
trade
Swap or trade tokens on Base or Polygon networks via the CDP Swap API.
x402
Search and call paid APIs using the x402 payment protocol with automatic USDC payments on Base.
agentic-wallet
Crypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API calls, monetize an API, or query onchain data. Use whenever the user mentions signing in, login, authentication, wallet status, balance, address, sending money, paying someone, transferring tokens, ENS names, swapping/trading/converting tokens, funding/topping up/onramp, USDC, ETH, POL, SOL, the x402 bazaar, paid APIs, monetizing an endpoint, or querying onchain data on Base.
add-lang
Add tree-sitter language support to codegraph end-to-end — wire the grammar + extractor, write tests, then benchmark extraction quality and retrieval value on 3 popular real-world repos. Use when the user runs /add-lang <language> or asks to add/support a new language (e.g. Lua, Elixir, Zig, OCaml) in codegraph.
agent-eval
Benchmark CodeGraph retrieval quality on a real codebase by comparing agent behavior with vs without CodeGraph. Use when the user runs /agent-eval or asks to test, benchmark, audit, or validate a codegraph version (the local dev build or a published npm version) against a language's repo.