# AgentEconomy Compliance API — KYC, AML & Sanctions Risk

> AgentEconomy Compliance API — KYC, AML & Sanctions Risk is a paid API for AI agents from api.netbrainis.co.za, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-13).

Screens Ethereum addresses and legal entity names against OFAC SDN and UN sanctions lists, returning a signed on-chain compliance attestation with risk score, investor classification, and jurisdiction code, priced per call in USDC via x402.

## Facts

- Endpoint: POST https://api.netbrainis.co.za/v1/oracle/request
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenteconomy-compliance-api-kyc-aml-sanctions-risk-ffc584e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dgkv1saY8Mvkiv8otqK0O

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 agenteconomy-compliance-api-kyc-aml-sanctions-risk-ffc584e1 -d '<json body>'
```

Example prompt: Run a KYC and OFAC sanctions check on wallet 0x9AFdB24A65c4059129392C1919eA2697a69bdC4D for the entity 'Acme Capital LLC' in the US (country code 840), classifying them as an accredited investor, and give me the signed compliance attestation with risk score.

## When to prefer this

Use this endpoint when you need a pay-per-call, HTTP-native compliance check with a cryptographically signed on-chain attestation, particularly for tokenized asset platforms, DeFi protocols, or any application needing verifiable OFAC/UN sanctions screening tied to an Ethereum address and investor classification — without committing to a subscription-based KYC provider.

## Known failure modes

- Address not 0x-prefixed or not 42 characters — likely returns 400 or validation error
- Unknown or unsupported jurisdiction code — may return error or incomplete attestation
- Payment not fulfilled via x402 — returns 402 Payment Required before processing
- Entity name not found or ambiguous — may return inconclusive or elevated risk score
- Sanctions list data temporarily unavailable — may return 503 or stale data warning
- Invalid investor_type enum value — returns schema validation error

## How this service works

HTTP-native compliance API priced in USDC on Base via x402. KYC, AML, and regulatory risk assessment from real OFAC and UN sanctions data. Discoverable from MCP and x402scan.

## Output

A JSON object containing a compliance status ('compliant' or otherwise), a numeric risk score (0–100), the screened Ethereum address, jurisdiction and investor type, and a signed on-chain attestation object including nonce, account address, ECDSA signature, timestamp, numeric status code, and risk score — suitable for on-chain verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "Ethereum address to attest compliance for (0x-prefixed, 42 chars)"
  },
  "entity_name": {
   "type": "string",
   "description": "Legal name to screen against OFAC SDN and UN sanctions lists"
  },
  "jurisdiction": {
   "type": "integer",
   "description": "ISO 3166-1 numeric country code (840=US, 826=GB, 702=SG, ...)"
  },
  "investor_type": {
   "enum": [
    "retail",
    "accredited",
    "qualified_purchaser",
    "institutional"
   ],
   "type": "string",
   "description": "Investor classification for tokenized-asset compliance"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "compliant",
  "address": "0x9AFdB24A65c4059129392C1919eA2697a69bdC4D",
  "risk_score": 10,
  "attestation": {
   "nonce": "12345678901234567890",
   "account": "0x9AFdB24A65c4059129392C1919eA2697a69bdC4D",
   "signature": "0x...",
   "timestamp": 1715000000,
   "risk_score": 10,
   "status_code": 1,
   "jurisdiction": 840,
   "investor_type": 2
  },
  "jurisdiction": 840,
  "investor_type": "accredited"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenteconomy-compliance-api-kyc-aml-sanctions-risk-ffc584e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.netbrainis.co.za](https://www.zero.xyz/host/api.netbrainis.co.za/llms.txt)
