Claude
Skills
Sign in
Back

htx-settlement

Included with Lifetime
$97 forever

Settlement and insurance fund data for HTX USDT-M perpetuals — estimated next-settlement price, historical settlement records, and insurance fund balance/history. Public, no API key.

Backend & APIs

What this skill does


# HTX Settlement & Insurance Fund

Reference data for HTX USDT-M perpetual **settlements** (the periodic mark-to-market events that net unrealized PnL into wallets) and the **insurance fund** (the contract platform's reserve for socialized loss prevention).

## When to use this skill

Load this skill when the user asks about:

- "When is the next settlement on BTC perpetual?"
- "Estimated settlement price right now"
- "Historical settlement records for ETH"
- "How big is HTX's insurance fund?"
- "Insurance fund balance trend"
- "Has the insurance fund been paid out recently?"

## Underlying tool

Drives `htx-cli`. Binary on `$PATH` or `$HTX_CLI_BIN`. Always pass `--json`.

## Endpoint catalog (4)

| # | Method | Endpoint | CLI invocation | Description |
|---|--------|----------|----------------|-------------|
| 1 | GET | `/linear-swap-api/v1/swap_estimated_settlement_price` | `htx-cli futures call GET /linear-swap-api/v1/swap_estimated_settlement_price [--query contract_code=<code>] --json` | Estimated price for the next settlement |
| 2 | GET | `/linear-swap-api/v1/swap_settlement_records` | `htx-cli futures call GET /linear-swap-api/v1/swap_settlement_records --query contract_code=<code>&start_time=<ms>&end_time=<ms> --json` | Historical settlement records (per-contract) |
| 3 | GET | `/v1/insurance_fund_info` | `htx-cli futures call GET /v1/insurance_fund_info --json` | Current insurance fund balance per asset |
| 4 | GET | `/v1/insurance_fund_history` | `htx-cli futures call GET /v1/insurance_fund_history --json` | Historical insurance fund balance time series |

## Concept reference

| Term | Meaning |
|------|---------|
| **Settlement** | Periodic netting event where unrealized PnL becomes realized. HTX USDT-M settles **continuously** via mark price PnL — the "settlement records" endpoint refers to delivery-style settlements for any quarterly contracts. |
| **Estimated settlement price** | Forward-looking price that would clear positions if settlement happened now. Useful for risk monitoring of margin levels. |
| **Insurance fund** | Reserve pool funded by liquidation surplus. When a liquidated position can't be auctioned at the bankruptcy price, the fund covers the gap. Drawdowns indicate platform stress. |

## Contract code format

USDT-M perpetual codes follow `<BASE>-USDT` (e.g. `BTC-USDT`).

## Typical queries → CLI

| User question | CLI command |
|---------------|-------------|
| "BTC estimated settlement price" | `htx-cli futures call GET /linear-swap-api/v1/swap_estimated_settlement_price --query contract_code=BTC-USDT --json` |
| "ETH settlement records last 30d" | `htx-cli futures call GET /linear-swap-api/v1/swap_settlement_records --query contract_code=ETH-USDT --json` |
| "HTX insurance fund right now" | `htx-cli futures call GET /v1/insurance_fund_info --json` |
| "Insurance fund last 90 days" | `htx-cli futures call GET /v1/insurance_fund_history --json` |

## Output guidance

For insurance fund queries:
- Show balance per asset (USDT main; ETH/BTC for COIN-M if relevant)
- Show 30d / 90d change
- Flag if fund has **decreased > 10%** in 7d (stress signal)

For settlement queries:
- Show next settlement time (UTC + local)
- Show estimated price + delta from current mark
- For historical records: aggregate by contract, count of settlements

## Related skills

- `https://github.com/htx-exchange/htx-skills-hub/funding-rate` — settlements happen alongside funding events
- `https://github.com/htx-exchange/htx-skills-hub/liquidation-stream` — liquidations feed the insurance fund
- `https://github.com/htx-exchange/htx-skills-hub/derivatives-analyst` — *(planned Layer 2)* multi-signal pressure scoring

Related in Backend & APIs