# HaoskiOnChain Crypto Derivatives Risk Oracle

> HaoskiOnChain Crypto Derivatives Risk Oracle is a paid API for AI agents from haoskionchain.xyz, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-15).

Answers specialized questions about crypto derivatives risk, margin mechanics, liquidation logic, collateral management, LTV ratios, oracle pricing, and exchange architecture via a retrieval-augmented knowledge base.

## Facts

- Endpoint: POST https://haoskionchain.xyz/query
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/haoskionchain-xyz-183b3abd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dq_dboX_XorZwDeT5Rwpe

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 haoskionchain-xyz-183b3abd -d '<json body>'
```

Example prompt: Can you explain how liquidation price is calculated for a cross-margin BTC perpetual position, including how the oracle price feed and maintenance margin rate interact — pull from the top 8 most relevant knowledge chunks?

## When to prefer this

Choose this endpoint when an AI agent needs deep, specialized knowledge about crypto derivatives risk management — including margin mechanics, liquidation cascades, LTV collateral rules, oracle price feed design, or exchange-specific risk architecture — rather than general crypto price data or portfolio tracking.

## Known failure modes

- HTTP 422 if top_k is outside the 1–20 range
- Vague or unanswerable query may return low-confidence or generic passages
- Payment not included or insufficient results in HTTP 402 rejection
- Highly novel or product-specific exchange mechanics may not be covered in the knowledge base

## How this service works

Crypto derivatives risk, margin, liquidation, collateral, and exchange architecture specialist.

## Output

Returns a synthesized answer to the derivatives/risk question, grounded in up to top_k retrieved knowledge passages covering topics like margin formulas, liquidation thresholds, collateral rules, oracle mechanics, and exchange architecture.

## Example request

```json
{
 "query": "How is the liquidation price calculated for a cross-margin BTC perpetual position, and how do the oracle price feed and maintenance margin rate interact in this calculation?",
 "top_k": 8,
 "caller": "qa-agent"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "buyer": {
   "type": "string",
   "description": "Optional buyer/caller identifier for pass purchases."
  },
  "query": {
   "type": "string",
   "description": "Exchange-risk, margin, liquidation, collateral, LTV, oracle, venue formula, or product-risk question."
  },
  "top_k": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "Number of retrieved knowledge chunks/passages used as answer context. Optional; defaults to 5. Min 1, max 20. Values outside 1-20 are rejected with HTTP 422 after request validation. Does not change the per-query price."
  },
  "caller": {
   "type": "string",
   "description": "Optional caller or agent identifier."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/haoskionchain-xyz-183b3abd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from haoskionchain.xyz](https://www.zero.xyz/host/haoskionchain.xyz/llms.txt)