Back to Details

search-for-service

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Searching the x402 Bazaar

搜索x402 Bazaar

Use the 
npx awal@latest x402
commands to discover and inspect paid API endpoints available on the x402 bazaar marketplace. No authentication or balance is required for searching.
使用
npx awal@latest x402
命令来发现和查看x402 bazaar市场中可用的付费API端点。搜索无需身份验证或余额。

Commands

命令

Search the Bazaar

搜索市场

Find paid services by keyword using BM25 relevance search:
bash
npx awal@latest x402 bazaar search <query> [-k <n>] [--force-refresh] [--json]
OptionDescription
-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/awal/bazaar/
and auto-refresh after 12 hours.
使用BM25相关性搜索，按关键词查找付费服务：
bash
npx awal@latest x402 bazaar search <query> [-k <n>] [--force-refresh] [--json]
选项说明
-k, --top <n>
结果数量（默认值：5）
--force-refresh
从CDP API重新获取资源索引
--json
以JSON格式输出
结果会缓存在本地
~/.config/awal/bazaar/
目录下，12小时后自动刷新。

List Bazaar Resources

列出市场资源

Browse all available resources:
bash
npx awal@latest x402 bazaar list [--network <network>] [--full] [--json]
OptionDescription
--network <name>
Filter by network (base, base-sepolia)
--full
Show complete details including schemas
--json
Output as JSON
浏览所有可用资源：
bash
npx awal@latest x402 bazaar list [--network <network>] [--full] [--json]
选项说明
--network <name>
按网络筛选（base、base-sepolia）
--full
显示完整详情，包括模式（schemas）
--json
以JSON格式输出

Discover Payment Requirements

查看支付要求

Inspect an endpoint's x402 payment requirements without paying:
bash
npx awal@latest 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.
无需付费即可查看端点的x402支付要求：
bash
npx awal@latest x402 details <url> [--json]
通过尝试每种HTTP方法（GET、POST、PUT、DELETE、PATCH）直到收到402响应，自动检测正确的HTTP方法，然后显示价格、接受的支付方案、网络以及输入/输出模式。

Examples

示例

bash
undefined
bash
undefined

Search for weather-related paid APIs

搜索与天气相关的付费API

npx awal@latest x402 bazaar search "weather"
npx awal@latest x402 bazaar search "weather"

Search with more results

搜索并获取更多结果

npx awal@latest x402 bazaar search "sentiment analysis" -k 10
npx awal@latest x402 bazaar search "sentiment analysis" -k 10

Browse all bazaar resources with full details

浏览市场所有资源并查看完整详情

npx awal@latest x402 bazaar list --full
npx awal@latest x402 bazaar list --full

Check what an endpoint costs

查看某个端点的费用

npx awal@latest x402 details https://example.com/api/weather
undefined
npx awal@latest x402 details https://example.com/api/weather
undefined

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.
找到想要使用的服务后，使用
pay-for-service
skill向该端点发起付费请求。

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
  • "CDP API returned 429" - 触发速率限制；如果有缓存数据，将使用缓存数据
  • "No X402 payment requirements found" - 该URL可能不是x402端点