# Public Wallet Risk Sample — Address Risk Dataset Preview

> Public Wallet Risk Sample — Address Risk Dataset Preview is a paid API for AI agents from base-agent-preflight.bytoken2023.workers.dev, paid per call via x402, $0.005/call, status down (last checked 2026-09-15).

Returns a sample of blockchain wallet risk records (sanctions, labels, confidence scores) from the public-wallet-risk dataset for evaluation or testing purposes.

## Facts

- Endpoint: GET https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/address-risk/sample
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-wallet-risk-sample-address-risk-dataset-preview-99351eb1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yZrZnkneiSUsihHdB6q1o

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 public-wallet-risk-sample-address-risk-dataset-preview-99351eb1
```

Example prompt: Can you pull 5 sample records from the public wallet risk dataset so I can see what the address, chain, risk type, confidence, and evidence fields look like before I decide whether to use it?

## When to prefer this

Use this endpoint when you need to preview the schema and content quality of the public wallet risk dataset before committing to full usage. It is specifically suited for agents evaluating whether this data product meets their AML, sanctions-screening, or on-chain risk requirements. Prefer it over the full paid endpoint when you only need a sample for schema validation or integration testing.

## Known failure modes

- Invalid limit parameter (must be integer 1–10): returns 400 validation error
- Payment not attached or insufficient USDC: returns 402 Payment Required
- Upstream dataset unavailable: returns 503 or empty records array
- Rate limiting on the Cloudflare Worker: returns 429 Too Many Requests

## How this service works

Pay-per-request identity, risk, authorization, execution-preflight and evidence APIs for autonomous agents.

## Output

Returns a JSON object containing dataset metadata (batch_key, source_count, active_labels) and an array of sample risk records. Each record includes the blockchain address, chain (e.g. ETH), risk_type (e.g. sanction), confidence level (high/medium/low), source_key, and an evidence_url. The product name and sample_size are also included.

## 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",
     "required": [],
     "properties": {
      "limit": {
       "type": "string",
       "pattern": "^[1-9]$|^10$",
       "description": "Number of sample JSONL records to return, from 1 to 10. Defaults to 5."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "hit": {
       "type": "boolean"
      },
      "chain": {
       "type": "string"
      },
      "labels": {
       "type": "array"
      },
      "address": {
       "type": "string"
      },
      "dataset": {
       "type": "object"
      },
      "product": {
       "type": "string"
      },
      "provenance": {
       "type": "object"
      },
      "risk_level": {
       "type": "string"
      },
      "risk_score": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "dataset": {
   "batch_key": "2026-W27",
   "source_count": 28,
   "active_labels": 25357
  },
  "product": "public-wallet-risk-sample",
  "records": [
   {
    "chain": "ETH",
    "label": "example schema record",
    "address": "0x0000000000000000000000000000000000000000",
    "risk_type": "sanction",
    "confidence": "high",
    "source_key": "example-source",
    "evidence_url": "https://example.com/source"
   }
  ],
  "sample_size": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-wallet-risk-sample-address-risk-dataset-preview-99351eb1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base-agent-preflight.bytoken2023.workers.dev](https://www.zero.xyz/host/base-agent-preflight.bytoken2023.workers.dev/llms.txt)