運
Yokai Oracle · x402 Protocol · Base Network

御籤
MIKUJI

Japan's trending yokai spirits speak through the x402 payment protocol. One USDC micropayment. One personalized fortune. No accounts, no keys, no friction.

Try the Oracle
$0.001 USDC per fortune
on Base · instant · forever
一二三四五
Protocol

How It Works

01
Call the API
GET /fortune with your name and question. Receive a 402 Payment Required with payment details.
02
Pay 0.001 USDC
Send exactly 0.001 USDC on Base to the payout address. No account. No subscription. Just the transaction.
03
Include Proof
Re-call with your tx hash in the X-Payment header. The oracle verifies on-chain and delivers your fortune.
04
Receive Fortune
JSON response: fortune level, yokai guardian, personalized wisdom, lucky color, and lucky number.
Integration

API Reference

# Step 1: Request fortune — receive 402
curl -i https://mikuji.mid-air.ai/fortune \
  -G -d "name=Tanaka" \
     -d "question=should+I+launch+this+week"

# → HTTP 402 Payment Required
# → X-Payment-Required: {"scheme":"exact","network":"base",
# "asset":"USDC","amount":"1000","payTo":"0x4D64...D8a"}

# Step 2: Pay 0.001 USDC on Base, then retry with proof
curl https://mikuji.mid-air.ai/fortune \
  -G -d "name=Tanaka" \
     -d "question=should+I+launch+this+week" \
  -H "X-Payment: 0xabc...def"
{
  "yokai": "Inari",
  "level": "大吉",
  "level_en": "Great Fortune",
  "wisdom": "The fox god of abundance walks where gratitude has been planted...",
  "lucky_color": "#FF8C00",
  "lucky_number": 5,
  "payment_verified": true,
  "network": "base",
  "timestamp": "2026-03-08T12:00:00Z"
}
Yokai Roster

30 Spirits. 30 Fortunes.

Kirin
大吉
Great Fortune
"The phantom beast moves through still water. Your silence today will echo louder than any announcement."
Kitsune
吉
Fortune
"Nine tails carry nine truths. You already know the answer — stop searching in the wrong forest."
Ryu
大吉
Great Fortune
"The eastern dragon does not fight the current — it becomes the current. Release one plan today."
Try It

Consult the Oracle

Demo mode — no payment required. In production, each call costs $0.001 USDC via x402.

$0.001
USDC per fortune · Base network

Pricing & Specs

Protocolx402 / USDC on Base
Price per call0.001 USDC (1000 μUSDC)
Payout address0x4D64...D8a
Fortune pool30 yokai spirits
Response formatJSON
Auth requiredNone — pay & call