Annalist Liq API

openapi: 3.2.0
info:
  title: Annalist Dev Liq API
  version: 0.9.0
  x-guidance: 'Annalist sells signed data for agents, priced per call over x402 (USDC on Base or Solana). Start with the free GET /v1/catalog: every paid route with the question it answers, its price and an example. Hyperliquid in one call: GET /v1/perp/full?coin=BTC (crowd state, smart-money positioning, liquidation levels). Before paying an x402 service: GET /v1/checks/service?host=, or the free GET /v1/verify/attestation?host=. Before connecting an MCP server: GET /v1/mcp/server?url=, or the free GET /v1/verify/mcp?url=. Before an agent shops on a site: the free GET /v1/verify/store?domain=, or GET /v1/web/readiness?domain=. Every answer is Ed25519-signed; the key is at /.well-known/annalist-key.json. Not investment advice.'
  description: 'Operations tagged liq across 2 of this provider''s published API definitions: annalist-dev-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.annalist.dev
tags:
- name: liq
paths:
  /v1/liq/perp:
    get:
      operationId: liq_perp
      tags:
      - liq
      summary: Where would liquidations hit for this perp, and can the order book absorb them?
      description: 'Use before opening, sizing or holding a Hyperliquid perpetual position to see where forced selling or buying would hit: known longs liquidating within 1 to 20% below the mark and shorts above it, the biggest clusters, and coverage of open interest, set against order-book depth, spread and slippage as cascade ratios. Flags long_cascade_risk, short_squeeze_risk, thin_book. From large accounts'' public positions. Aggregates only. Signed. Not investment advice.'
      x-price: $0.02
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        protocols:
        - x402: {}
      parameters:
      - name: coin
        in: query
        required: true
        schema:
          type: string
          description: Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE
      responses:
        '200':
          description: Signed data
          content:
            application/json:
              schema:
                type: object
                required:
                - as_of
                - data
                - signature
                properties:
                  as_of:
                    type: string
                    format: date-time
                  data:
                    type: object
                  method:
                    type: object
                  request_id:
                    type: string
                  stale:
                    type: boolean
                  sources:
                    type: array
                    items:
                      type: string
                  notice:
                    type: string
                  key_id:
                    type: string
                  signature:
                    type: string
                    description: Ed25519 over RFC 8785 canonical JSON of {as_of, data, method, request_id}
                  signature_info:
                    type: string
              example:
                data:
                  coin: BTC
                  longs_liquidating_below:
                  - within_pct: 5
                    usd: 12400000
                    positions: 9
                  long_clusters:
                  - price: 77480
                    usd: 25200000
                  flags: []
        '402':
          description: Payment required (x402 v2, USDC on Base or Solana)
    servers:
    - url: https://api.annalist.dev
  /v1/liq/market:
    get:
      operationId: liq_market
      tags:
      - liq
      summary: Which Hyperliquid perps have the most liquidations close to the price?
      description: 'Liquidation pressure across Hyperliquid''s largest perps: for each, the known longs liquidating within 5% below the mark and shorts within 5% above it, cascade ratios against order-book depth, 2% depth, how much of open interest the known positions cover, and flags; plus the coins with the most liquidations nearby. Aggregates only. Signed. Not investment advice.'
      x-price: $0.03
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.030000'
        protocols:
        - x402: {}
      parameters: []
      responses:
        '200':
          description: Signed data
          content:
            application/json:
              schema:
                type: object
                required:
                - as_of
                - data
                - signature
                properties:
                  as_of:
                    type: string
                    format: date-time
                  data:
                    type: object
                  method:
                    type: object
                  request_id:
                    type: string
                  stale:
                    type: boolean
                  sources:
                    type: array
                    items:
                      type: string
                  notice:
                    type: string
                  key_id:
                    type: string
                  signature:
                    type: string
                    description: Ed25519 over RFC 8785 canonical JSON of {as_of, data, method, request_id}
                  signature_info:
                    type: string
              example:
                data:
                  wallets_watched: 1000
                  most_longs_liquidating_within_5pct:
                  - coin: XYZ
                    usd_within_5pct: 3100000
                  flagged:
                    XYZ:
                    - long_cascade_risk
        '402':
          description: Payment required (x402 v2, USDC on Base or Solana)
    servers:
    - url: https://api.annalist.dev
x-refined-from:
- annalist-dev-openapi.json
- openapi.json