# Crypto Microdata Test/Validation Endpoint (x402)

> Crypto Microdata Test/Validation Endpoint (x402) is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-31).

Validates x402 micropayment connectivity and returns a receipt plus a menu of available crypto data endpoints for AI agents to call next.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/x402/test?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-microdata-test-validation-endpoint-x402-5314d53d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GGqwuXa080qY6fD2szbzN

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 crypto-microdata-test-validation-endpoint-x402-5314d53d
```

Example prompt: Run a quick x402 test call against the crypto microdata service with my correlation ID 'agent-run-007' so I can confirm my USDC micropayment on Base goes through and see which data endpoints I can call next.

## When to prefer this

Use this endpoint when you need to verify that your x402 micropayment infrastructure (USDC on Base) is correctly wired up before committing to real paid crypto data calls. It is the cheapest possible validation ($0.001 USDC) and doubles as a service discovery call that returns the menu of available data endpoints. Prefer this over calling a paid data endpoint blind when you are setting up a new agent, testing a new wallet, or running a pre-flight check before a production deployment.

## Known failure modes

- x402 payment not included or invalid → 402 Payment Required with payment details
- USDC balance insufficient on Base → payment fails, 402 returned
- Invalid or malformed query parameters → 400 Bad Request
- echo or testRunId exceed character limits (64/100) → validation error
- Worker unavailable or cold-start timeout → 503 or timeout
- Payment received but not yet confirmed on-chain → delayed or failed paymentVerified flag

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

Returns a JSON object confirming paymentVerified=true, a unique receiptId, the echoed testRunId, a timestamp, and a 'next' array listing available paid crypto data endpoint paths (e.g. /crypto/base-gas, /crypto/simulate, /crypto/liquidations) plus a nextAction hint indicating the agent should proceed to call paid data endpoints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "echo": {
       "type": "string",
       "examples": [
        "my-agent-1"
       ],
       "maxLength": 64,
       "description": "Optional string echoed back (correlate your test call)"
      },
      "testRunId": {
       "type": "string",
       "examples": [
        "run-001"
       ],
       "maxLength": 100,
       "description": "Optional caller-supplied correlation ID for a bounded validation run (echoed back)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "t": "2026-10-28T14:00:00Z",
  "ok": true,
  "next": [
   "/crypto/simulate",
   "/crypto/ens",
   "/crypto/liquidations?coin=BTC",
   "/crypto/base-gas"
  ],
  "receiptId": "rcpt_0b9f6c1e2a7d4c55",
  "testRunId": "run-001",
  "nextAction": "call_paid_data",
  "paymentVerified": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-microdata-test-validation-endpoint-x402-5314d53d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)
