# UnyKorn Genesis402 Credit Top-Up ($5 USDC)

> UnyKorn Genesis402 Credit Top-Up ($5 USDC) is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $5/call, status unknown (last checked 2026-10-02).

Purchase $5 USDC of prepaid credit on the Genesis402/UnyKorn platform, returning a one-time credit token and balance URL for subsequent pay-per-call API usage.

## Facts

- Endpoint: POST https://twin.unykorn.org/credits/5?utm_source=zero.xyz
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/unykorn-genesis402-credit-top-up-5-usdc-76c13ca0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mtBlclSF43Zx7UOZHkrH7

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 unykorn-genesis402-credit-top-up-5-usdc-76c13ca0 -d '<json body>'
```

Example prompt: Top up my Genesis402 account with $5 USDC so I have credits ready to run counterparty compliance checks — give me the credit token and balance URL once it goes through.

## When to prefer this

Choose this endpoint when you need to pre-purchase a block of Genesis402 API credits (rather than paying per-call inline) and want a reusable credit token for subsequent calls, especially when orchestrating multiple downstream Genesis402/UnyKorn API calls (compliance screening, DeFi data, crypto prices) in a single session. Prefer per-call x402 payment if you only need one or two calls.

## Known failure modes

- Payment not received or insufficient USDC — x402 payment challenge returned instead of credit token
- Invalid or malformed x402 payment header — 402 or 400 error
- Network or blockchain confirmation delay — timeout or pending state
- Duplicate payment detected — idempotency conflict
- Endpoint unavailable — 503 from operator network

## How this service works

Pay-per-call endpoints over x402 v2 and MPP (the "Payment" HTTP auth scheme, method usdc). Includes counterparty compliance checks: /report/counterparty (company + registered parents + UN/OFAC/EU/UK sanctions, signed and verifiable), /screen/name and /screen/entity. Free: /health, /.well-known/x402, /receipts, /prove/keys, /prove/stats.

## Output

Returns a JSON object with: ok (true/false), type ('credits'), the header name for submitting credits (X-Genesis402-Credit), a receipt object with tx_hash, amount_usd, and receipt_id, a credit_id, a balance_url for checking remaining balance, the current balance in USD as a string, and a one-time-visible credit_token (g402c_ prefix, 43 chars) to authenticate future API calls.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {}
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "credits",
  "header": "X-Genesis402-Credit",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 5,
   "receipt_id": "g402-<16hex>"
  },
  "credit_id": "cr_<12hex>",
  "balance_url": "/credits/balance",
  "balance_usd": "5.000000",
  "credit_token": "g402c_<43 chars, shown once>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/unykorn-genesis402-credit-top-up-5-usdc-76c13ca0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)