GoldRush Streaming API — OHLCV

naftiko: 1.0.0-alpha2
info:
  label: GoldRush Streaming API — OHLCV
  description: One-shot OHLCV pairs and tokens queries via the Streaming API GraphQL endpoint. Self-contained Naftiko capability.
  tags:
  - Covalent
  - GoldRush
  - Streaming
  - OHLCV
  - GraphQL
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    GOLDRUSH_API_KEY: GOLDRUSH_API_KEY
capability:
  consumes:
  - type: http
    namespace: streaming-ohlcv
    baseUri: https://streaming.goldrush.dev
    description: GoldRush Streaming GraphQL endpoint (OHLCV queries).
    resources:
    - name: graphql
      path: /graphql
      operations:
      - name: queryOhlcvPairs
        method: POST
        description: 'OHLCV Pairs Query — historical candles for a pair.'
        outputRawFormat: json
        inputParameters:
        - { name: body, in: body, type: object, required: true, description: 'GraphQL request body with operationName `ohlcvPairs`.' }
      - name: queryOhlcvTokens
        method: POST
        description: 'OHLCV Tokens Query — historical candles for a token.'
        outputRawFormat: json
        inputParameters:
        - { name: body, in: body, type: object, required: true, description: 'GraphQL request body with operationName `ohlcvTokens`.' }
      - name: queryTokenSearch
        method: POST
        description: 'Token Search Query.'
        outputRawFormat: json
        inputParameters:
        - { name: body, in: body, type: object, required: true }
      - name: queryTopTraderWallets
        method: POST
        description: 'Top Trader Wallets For Token Query.'
        outputRawFormat: json
        inputParameters:
        - { name: body, in: body, type: object, required: true }
      - name: queryWalletPnl
        method: POST
        description: 'Wallet PnL By Token Query.'
        outputRawFormat: json
        inputParameters:
        - { name: body, in: body, type: object, required: true }
    authentication:
      type: apikey
      key: Authorization
      value: 'Bearer {{env.GOLDRUSH_API_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: streaming-ohlcv-mcp
    port: 9090
    transport: http
    description: MCP adapter exposing Streaming OHLCV queries.
    tools:
    - { name: goldrush-streaming-ohlcv-pairs, description: 'OHLCV candles for a DEX pair.', hints: { readOnly: true, idempotent: true }, call: streaming-ohlcv.queryOhlcvPairs }
    - { name: goldrush-streaming-ohlcv-tokens, description: 'OHLCV candles for a token.', hints: { readOnly: true, idempotent: true }, call: streaming-ohlcv.queryOhlcvTokens }
    - { name: goldrush-streaming-token-search, description: 'Search tokens across chains.', hints: { readOnly: true, idempotent: true }, call: streaming-ohlcv.queryTokenSearch }
    - { name: goldrush-streaming-top-traders, description: 'Top trader wallets for a token.', hints: { readOnly: true, idempotent: true }, call: streaming-ohlcv.queryTopTraderWallets }
    - { name: goldrush-streaming-wallet-pnl, description: 'PnL for a wallet by token.', hints: { readOnly: true, idempotent: true }, call: streaming-ohlcv.queryWalletPnl }