Developer Platform API

Docs for bots.

Developer Platform API

Base URL: https://api.icme.io/v1

Authentication: X-API-Key: sk-smt-{username}-{uuid}

---

Endpoints

POST /v1/createUser

Create an account. No API key required. $5.00 USDC one-time fee via x402.

Body

json

{"username": "string", "stripe_payment_intent_id": "string (optional)"}

---

POST /v1/topUp

Add credits to your account. Call with empty body to see tiers. $5–$100 USDC via x402.

Body

json

{"amount_usd": 10, "stripe_payment_intent_id": "string (optional)"}
```

**Tiers**
```
$5   →   500 credits
$10  → 1,050 credits  (+5%)
$25  → 2,750 credits  (+10%)
$50  → 5,750 credits  (+15%)
$100 → 12,000 credits (+20%)

---

POST /v1/makeRules

Compile a natural language policy to formal logic. Streams via SSE. 300 credits.

Body

json

{"policy": "string"}

Response (streaming)

json

{"step": "done", "policy_id": "uuid", "rule_count": 2}

---

POST /v1/checkIt

Check an agent action against a compiled policy. Streams via SSE. 5 credits.

Body

json

{"policy_id": "uuid", "action": "string (max 2000 chars)"}

Response

json

{"result": "UNSAT", "reason": "Transfer amount exceeds policy limit."}

---

POST /v1/verify

Check structured values directly against a policy. No LLM extraction. 5 credits.

Body

json

{"policy_id": "uuid", "values": {"amount": 500, "approved": false}}

---

POST /v1/verifyPaid

Check any policy with no account. $0.10 USDC per call via x402. No API key required.

Body

json

{"policy_id": "uuid", "action": "string (max 2000 chars)"}
```

---

## x402 Payment Flow

All payments are USDC on Base (network: `eip155:8453`).

1. Call endpoint without `stripe_payment_intent_id` → receive `402` with `payTo` address and `stripePaymentIntentId`
2. Send exact USDC amount to `payTo` on Base
3. Retry request with `stripe_payment_intent_id` set

Amounts must be exact. Each PaymentIntent is single-use.

---

## Error Codes
```
INSUFFICIENT_CREDITS   402   Top up via /v1/topUp
PAYMENT_REQUIRED       402   Follow x402 flow
PAYMENT_PROCESSING     202   Confirming on Base — retry shortly
PAYMENT_ALREADY_USED   409   PaymentIntent already used
ACTION_TOO_LONG        400   Action exceeds 2,000 characters
INVALID_UUID           400   Invalid policy_id
NOT_FOUND              404   Policy not found

---

Live Demo Policy

Policy ID: d73134e6-05d6-46ba-9852-376c53fd7651

Try /v1/verifyPaid against this policy for $0.10 USDC. No account needed.