# Tollex Merchant Health Check

> Tollex Merchant Health Check is a paid API for AI agents from api.tollex.org, paid per call via x402, $0.0079/call, status unknown (last checked 2026-10-11).

Checks whether a merchant API endpoint is healthy, reachable, and capable of accepting x402-based payments before committing budget

## Facts

- Endpoint: POST https://api.tollex.org/tools/merchant_health?utm_source=zero.xyz
- Price: $0.0079/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tollex-merchant-health-check-5921e2bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dJbIeI7yXHCRkXR7h8uQC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tollex-merchant-health-check-5921e2bf -d '<json body>'
```

Example prompt: Before I let my agent start spending on it, can you check if the merchant endpoint at https://merchant.example/v1/quote is healthy and ready to accept x402 payments?

## When to prefer this

Use this endpoint when you need to pre-flight a merchant URL before committing agent budget, adding a vendor to an approved policy list, or gating an autonomous workflow on merchant availability. Prefer this over general HTTP ping tools when you specifically need to verify x402 payment compatibility, not just TCP/HTTP reachability.

## Known failure modes

- URL does not resolve or is unreachable — returns connectivity failure
- Merchant endpoint is reachable but does not support x402 payment headers — returns payment capability mismatch
- Malformed or non-HTTP/HTTPS URL rejected by pattern validation
- Merchant returns unexpected status codes — health marked degraded or unknown
- Network timeout on probe — returns timeout error

## How this service works

Tollex lets software agents buy APIs and tools under rules you set: it finds a capability that fits, checks your policy before anything is signed, pays with x402 in USDC on Base or USDG on Robinhood Chain, reconciles uncertain payments and returns a signed receipt.

## Output

Returns a health assessment for the given merchant URL, indicating whether the endpoint is reachable, responsive, and capable of participating in x402 payment flows. Likely includes status flags for connectivity and payment readiness, helping an agent or policy engine decide whether to proceed with this merchant.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "pattern": "^https?://",
   "examples": [
    "https://merchant.example/v1/quote"
   ],
   "maxLength": 2048
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": {
   "id": "merchant_health",
   "version": "1.0.0",
   "provider": "tollex.robinhood-chain"
  },
  "result": {
   "error": null,
   "origin": "https://api.example.com",
   "healthHttp": 200,
   "challengeValid": true,
   "healthLatencyMs": 95,
   "challengeLatencyMs": 140
  },
  "evidence": [],
  "untrustedOutput": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tollex-merchant-health-check-5921e2bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tollex.org](https://www.zero.xyz/host/api.tollex.org/llms.txt)