# CounterpartyCheck

> CounterpartyCheck is a paid API for AI agents from counterparty.lonestaroracle.xyz, paid per call via x402, $0.25/call, status unknown (last checked 2026-11-18).

Screens a crypto wallet address and/or entity name against OFAC sanctions lists, assesses wallet risk, and returns a signed compliance verdict in one call.

## Facts

- Endpoint: GET https://counterparty.lonestaroracle.xyz/screen?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/counterpartycheck-e0930e80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_56QcigTn39hEmR_N6ZNvi

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 counterpartycheck-e0930e80
```

Example prompt: Before we send payment to 0x1aB2cD3... on Ethereum, can you run a full counterparty screen on them — check OFAC sanctions on the wallet and the company name 'Acme Trading Ltd' and give me the signed verdict?

## When to prefer this

Use this endpoint when you need a single-call, all-in-one counterparty compliance check that combines OFAC sanctions screening (both wallet and name), wallet risk scoring, and a cryptographically signed verdict suitable for audit trails. Prefer it over separate OFAC or risk APIs when you need a verifiable, signed receipt for compliance records, or when operating an autonomous agent that must clear counterparties before executing payments or trades on EVM chains.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain identifier returns an error
- No wallet or name provided may return a minimal or error response
- Network timeout or upstream data provider outage causes failure
- Very new wallets with no on-chain history may have incomplete profiles

## How this service works

One-call counterparty screen: OFAC wallet + name, wallet risk, wallet profile, signed verdict

## Output

Returns a structured JSON object including: OFAC wallet listing status, OFAC name match results with confidence score, wallet risk score and risk flags (e.g. address poisoning, mixer usage), a wallet profile with transaction count, portfolio value, top holdings, and first-seen date, a human-readable verdict (PASS/FAIL), reasons and warnings, and a cryptographically signed receipt (secp256k1-EIP191) from the oracle's known signer address for audit purposes.

## Request schema (JSON Schema)

```json
{
 "name": "CounterpartyCheck",
 "tags": [
  "counterparty",
  "sanctions",
  "ofac",
  "compliance",
  "kyc"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "compliance",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string",
       "title": "Name",
       "description": "Optional company, exchange, agent or person name to screen against OFAC"
      },
      "chain": {
       "type": "string",
       "title": "Chain",
       "default": "auto",
       "description": "auto (default: checks Ethereum and Base, profiles the active one), eth, base, arb, poly, bsc"
      },
      "wallet": {
       "type": "string",
       "title": "Wallet",
       "description": "Counterparty wallet address (EVM 0x... or any OFAC-listed crypto address)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "profile": {
      "chain": "ETH",
      "tx_count": 5129,
      "top_holdings": [
       {
        "symbol": "USDC",
        "value_usd": 30977.44
       }
      ],
      "portfolio_usd": 78827.72,
      "first_seen_utc": "2023-11-29T18:40:11.000Z",
      "exchange_interactions": []
     },
     "reasons": [
      "no OFAC wallet or name match and no high-risk wallet flags"
     ],
     "receipt": {
      "receipt": {
       "service": "CounterpartyCheck",
       "verdict": "PASS",
       "checked_at": "2026-11-05T01:50:00Z"
      },
      "signature": {
       "alg": "secp256k1-eip191",
       "sig": "0x...",
       "signer": "0x54aB6b8Ddbedc057F230D1b78E6cd4677d304E18"
      }
     },
     "verdict": "PASS",
     "warnings": [
      "address poisoning: 7 recent transfer(s) of fake look-alike tokens; copy this wallet's counterparties from a trusted source, not from its transaction history"
     ],
     "sanctions": {
      "ofac_name": {
       "matches": [],
       "confidence": "none",
       "sanctioned": false
      },
      "ofac_wallet": {
       "listed": false
      }
     },
     "checked_at": "2026-11-05T01:50:00Z",
     "wallet_risk": {
      "chain": "eth",
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/counterpartycheck-e0930e80/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from counterparty.lonestaroracle.xyz](https://www.zero.xyz/host/counterparty.lonestaroracle.xyz/llms.txt)
