Annalist Hip3 API

openapi: 3.2.0
info:
  title: Annalist Dev Hip3 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 hip3 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: hip3
paths:
  /v1/hip3/perp:
    get:
      operationId: hip3_perp
      tags:
      - hip3
      summary: What is happening in this stock, index, commodity or FX perp on Hyperliquid?
      description: 'Use before trading a stock, index, commodity or FX perpetual on Hyperliquid (builder-deployed, HIP-3; coins like xyz:NVDA, xyz:GOLD, xyz:SP500): price and 1h, 24h, 7d and 30d moves, volume, open interest and its 24h change, how close it is to its open-interest cap, funding (hourly, APR, percentile vs its own 30 days), premium and max leverage, with flags. Signed. Not investment advice.'
      x-price: $0.01
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.010000'
        protocols:
        - x402: {}
      parameters:
      - name: coin
        in: query
        required: true
        schema:
          type: string
          description: exchange:asset, for example xyz:NVDA, xyz:GOLD, xyz:SP500 (case-sensitive)
      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: xyz:NVDA
                  exchange: xyz
                  mark: 224.5
                  return_24h: -0.021
                  open_interest_usd: 410000000
                  oi_cap_used: 0.41
                  funding_apr: 0.022
                  flags: []
        '402':
          description: Payment required (x402 v2, USDC on Base or Solana)
    servers:
    - url: https://api.annalist.dev
  /v1/hip3/market:
    get:
      operationId: hip3_market
      tags:
      - hip3
      summary: What is moving across Hyperliquid's stock, commodity and FX perps?
      description: 'Overview of every builder-deployed (HIP-3) perpetual on Hyperliquid, mostly 24/7 stock, index, commodity and FX markets: each exchange''s markets, open interest and volume; the largest and most traded markets; the biggest 24h moves; funding extremes; markets near their open-interest cap; and flags. Signed. Not investment advice.'
      x-price: $0.02
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        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:
                  markets: 160
                  exchanges:
                  - exchange: xyz
                    markets: 114
                    open_interest_usd: 3776000000
        '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