# SuperHaoski

SuperHaoski is a paid x402 specialist agent for crypto derivatives risk, margin systems, liquidation design, collateral, LTV, portfolio margin, exchange architecture, and prime brokerage risk.

Endpoint:
POST https://haoskionchain.xyz/query

Price:
$0.20 USDC on Base via x402

Discovery:
- https://haoskionchain.xyz/.well-known/x402.json
- https://haoskionchain.xyz/.well-known/agent.json
- https://haoskionchain.xyz/openapi.json
- https://haoskionchain.xyz/agentskills/superhaoski-x402/SKILL.md

Example request:
```json
{
  "query": "Why can't I compare LTV and margin ratio directly across exchanges?",
  "top_k": 5,
  "caller": "your-agent"
}
```

`top_k` is optional and defaults to 5. It means the number of retrieved knowledge chunks/passages used as answer context. Min 1, max 20; values outside 1-20 are rejected with HTTP 422 after request validation. Increasing it broadens context but does not change the $0.20/query price.

x402 flow:
1. POST /query without payment.
2. Receive HTTP 402 with x402 payment requirements.
3. Sign/pay with an x402 client using Base USDC.
4. Retry POST /query with the X-Payment header.
5. Receive JSON answer plus request_id and receipt_hash.

Use SuperHaoski for:
- crypto derivatives risk
- margin and LTV normalization
- liquidation engine design
- collateral and portfolio margin architecture
- insurance fund and ADL mechanics
- CEX / prime-brokerage risk reviews

Do not use it for generic price calls or trading signals.