naftiko: 1.0.0-alpha2
info:
  label: GoldRush Hyperliquid Info API — Markets
  description: Market-level Hyperliquid info types (metaAndAssetCtxs, spotMetaAndAssetCtxs, outcomeMeta) served from hypercore.goldrushdata.com. Self-contained Naftiko capability.
  tags:
  - Covalent
  - GoldRush
  - Hyperliquid
  - Markets
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    GOLDRUSH_API_KEY: GOLDRUSH_API_KEY
capability:
  consumes:
  - type: http
    namespace: hyperliquid-markets
    baseUri: https://hypercore.goldrushdata.com
    description: GoldRush-hosted Hyperliquid Info endpoint for market-level info types.
    resources:
    - name: info
      path: /info
      operations:
      - name: queryMetaAndAssetCtxs
        method: POST
        description: 'Query Hyperliquid metaAndAssetCtxs.'
        outputRawFormat: json
        inputParameters:
        - { name: body, in: body, type: object, required: true, description: 'JSON body with type=metaAndAssetCtxs.' }
      - name: querySpotMetaAndAssetCtxs
        method: POST
        description: 'Query Hyperliquid spotMetaAndAssetCtxs.'
        outputRawFormat: json
        inputParameters:
        - { name: body, in: body, type: object, required: true, description: 'JSON body with type=spotMetaAndAssetCtxs.' }
      - name: queryOutcomeMeta
        method: POST
        description: 'Query Hyperliquid outcomeMeta (HIP-4 outcome markets).'
        outputRawFormat: json
        inputParameters:
        - { name: body, in: body, type: object, required: true, description: 'JSON body with type=outcomeMeta.' }
    authentication:
      type: apikey
      key: Authorization
      value: 'Bearer {{env.GOLDRUSH_API_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: hyperliquid-markets-mcp
    port: 9090
    transport: http
    description: MCP adapter exposing Hyperliquid market info tools.
    tools:
    - { name: goldrush-hl-meta-and-asset-ctxs, description: 'Perp meta and asset contexts.', hints: { readOnly: true, idempotent: true }, call: hyperliquid-markets.queryMetaAndAssetCtxs }
    - { name: goldrush-hl-spot-meta-and-asset-ctxs, description: 'Spot meta and asset contexts.', hints: { readOnly: true, idempotent: true }, call: hyperliquid-markets.querySpotMetaAndAssetCtxs }
    - { name: goldrush-hl-outcome-meta, description: 'HIP-4 outcome market metadata.', hints: { readOnly: true, idempotent: true }, call: hyperliquid-markets.queryOutcomeMeta }