Check Endpoint Status
Check the health, uptime, and pricing details of a specific x402-enabled API endpoint.
Usage
npx @zauthx402/cli@latest status <url> --json
Example
npx @zauthx402/cli@latest status https://mesh.heurist.xyz/x402/solana/agents/BaseUSDCForensicsAgent/usdc_top_funders --json
Interpreting the response
| Field | Meaning |
|---|---|
status | Current health — WORKING (healthy), FAILING (errors), FLAKY (intermittent issues), UNTESTED (never checked), OVER_BUDGET (too expensive to test) |
successRate | Percentage of successful calls (0-100). Above 95% is excellent. |
uptime | Overall uptime percentage |
verified | Whether the endpoint belongs to a verified provider |
priceUsdc | Cost per API call in USDC |
network | Blockchain network used for payment |
totalCalls | Total recorded invocations |
lastTested | When the endpoint was last health-checked |
lastWorking | When the endpoint last returned a successful response |
Decision guide
- WORKING + verified + high successRate → Safe to use, recommend to user
- FLAKY → Warn user about intermittent issues, suggest retries
- FAILING → Do not recommend. Search for alternatives using
discover-x402-services - UNTESTED → No reliability data. Inform user it hasn't been tested yet
- OVER_BUDGET → Endpoint exists but is too expensive for automated testing