Paginated, filterable directory of x402 servers — discover services, check status, and build catalogs.
What it does
The `get_available_resources` endpoint from t54.ai's x402-secure platform provides a searchable, paginated directory of x402-protocol servers. It aggregates data from two sources: the official Coinbase Bazaar registry and the community-driven x402scan scanner. Callers can filter by server status (active, inactive, unknown), data source, and payment-address presence, as well as sort by overall score, creation date, last validation time, or name. Each request costs $0.01 USDC on the Base network, paid via the standard x402 payment-challenge flow.
The endpoint accepts POST requests with a JSON body. All fields are optional: `page` and `page_size` control pagination (default 50 items, max 100), `q` performs case-insensitive partial matching on server name or URL, and `source`, `status`, `has_payto`, `order_by`, and `order_dir` provide filtering and sorting. The response returns the current page metadata (`page`, `page_size`, `total`, `total_pages`, `has_next`) and a `resources` array containing the matched server entries.
x402-secure is an open-source SDK and proxy layer built on top of the x402 protocol. It adds pre-transaction risk assessment via its Trustline engine and is compatible with both Base and Solana chains. The directory endpoint is one of several tools exposed through this platform. No OpenAPI spec or dedicated documentation page was found for this specific endpoint; the schema details come entirely from the x402 challenge's `outputSchema`.
Capabilities
Use cases
- —Discovering available x402-protocol services for agent integration
- —Building a catalog of active x402 servers with payment addresses
- —Monitoring the validation status of known x402 endpoints
- —Searching for specific x402 services by name or URL
- —Comparing x402 servers by score or recency
Fit
Best for
- —AI agent developers looking for x402-compatible services to integrate
- —Platform builders aggregating x402 ecosystem data
- —Researchers monitoring the health and growth of the x402 network
Not for
- —Making payments or executing transactions on x402 servers (this is read-only discovery)
- —Non-crypto or non-x402 service discovery
Quick start
curl -X POST https://x402-secure-api.t54.ai/x402/tools/get_available_resources \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <base64-encoded-payment-payload>" \
-d '{"page": 1, "page_size": 10, "status": "active", "order_by": "overall_score", "order_dir": "desc"}'Example
Request
{
"q": "weather",
"page": 1,
"source": "bazaar",
"status": "active",
"order_by": "overall_score",
"has_payto": true,
"order_dir": "desc",
"page_size": 10
}Response
{
"page": 1,
"total": 42,
"has_next": true,
"page_size": 10,
"resources": [
{
"url": "https://example.com/weather",
"name": "Weather API",
"source": "bazaar",
"status": "active",
"has_payto": true,
"overall_score": 0.95
}
],
"total_pages": 5
}Endpoint
Quality
The x402 challenge is live and provides a detailed outputSchema with all input fields, enums, and output shape. However, no OpenAPI spec, dedicated docs, or example responses were found — the response resource object fields are inferred. Pricing is clear from the challenge.
Warnings
- —No OpenAPI spec or dedicated API documentation found (crawled /docs, /api, /pricing, /README all returned 404).
- —The exact shape of objects in the 'resources' array is not documented — the example response is inferred.
- —Response field names beyond the top-level pagination metadata are speculative.
Citations
- —Endpoint returns 402 with x402 payment challenge on POST, confirming it is live.https://x402-secure-api.t54.ai/x402/tools/get_available_resources
- —Price is $0.01 USDC per page on Base network (maxAmountRequired: 10000 = 0.01 USDC with 6 decimals).https://x402-secure-api.t54.ai/x402/tools/get_available_resources
- —x402-secure is an open-source SDK and proxy supporting Base and Solana chains.https://x402-secure-api.t54.ai
- —Data sources include 'bazaar' (official Coinbase registry) and 'x402scan' (community scanner).https://x402-secure-api.t54.ai/x402/tools/get_available_resources
- —Payment goes to address 0x0495d60c927B97d67D5018C6AA65C9b2bebaeED9 using USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base.https://x402-secure-api.t54.ai/x402/tools/get_available_resources