# UnyKorn Genesis402 Credit Purchase ($25 USDC)

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

Purchases $25 USDC worth of prepaid credits on the Genesis402 rail, returning a one-time credit token and balance URL for subsequent pay-per-call API usage.

## Facts

- Endpoint: POST https://twin.unykorn.org/credits/25?utm_source=zero.xyz
- Price: $25/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-purchase-25-usdc-bd2f8e82
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I3mUTwmMrfSlNyGi3tUTV

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-purchase-25-usdc-bd2f8e82 -d '<json body>'
```

Example prompt: I need to fund my Genesis402 account with $25 USDC so I can start making pay-per-call requests — can you purchase a credit bundle and give me the credit token?

## When to prefer this

Use this endpoint when you need to pre-fund a Genesis402 credit balance before making pay-per-call requests to UnyKorn services (sanctions screening, counterparty compliance, geocoding, earthquake data, etc.). Prefer this over per-call payment if you plan to make multiple calls and want to avoid repeated x402 payment overhead. This is the entry point for the Genesis402 credit system — required before using any credit-gated endpoint on twin.unykorn.org.

## Known failure modes

- Payment rejected due to insufficient USDC balance — returns payment error
- Invalid or missing x402/MPP payment header — 402 Payment Required response
- USDC transaction not confirmed on-chain — payment timeout or pending state
- Duplicate payment detected within short window — idempotency conflict
- Network/service unavailability — 503 or connection error
- Sanctions/compliance hold on paying address — payment blocked

## 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 containing: ok (boolean), type ('credits'), the credit token (g402c_ prefixed, shown only once), a credit_id, the current balance in USD, a balance_url for checking future balance, and a receipt with tx_hash, amount_usd ($25), and receipt_id. The credit token must be stored immediately as it is not retrievable again.

## 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": 25,
   "receipt_id": "g402-<16hex>"
  },
  "credit_id": "cr_<12hex>",
  "balance_url": "/credits/balance",
  "balance_usd": "25.000000",
  "credit_token": "g402c_<43 chars, shown once>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/unykorn-genesis402-credit-purchase-25-usdc-bd2f8e82/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)