CryptoQuant API — Exchange Flows

naftiko: 1.0.0-alpha2
info:
  label: CryptoQuant API — Exchange Flows
  description: 'CryptoQuant API — Exchange Flows. 5 operations. Lead operation: Bitcoin exchange inflow. Self-contained Naftiko
    capability covering one Cryptoquant business surface.'
  tags:
  - Cryptoquant
  - Exchange Flows
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CRYPTOQUANT_API_KEY: CRYPTOQUANT_API_KEY
capability:
  consumes:
  - type: http
    namespace: cryptoquant-exchange-flows
    baseUri: https://api.cryptoquant.com/v1
    description: CryptoQuant API — Exchange Flows business capability. Self-contained, no shared references.
    resources:
    - name: btc-exchange-flows-inflow
      path: /btc/exchange-flows/inflow
      operations:
      - name: getbtcexchangeinflow
        method: GET
        description: Bitcoin exchange inflow
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: btc-exchange-flows-outflow
      path: /btc/exchange-flows/outflow
      operations:
      - name: getbtcexchangeoutflow
        method: GET
        description: Bitcoin exchange outflow
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: btc-exchange-flows-reserve
      path: /btc/exchange-flows/reserve
      operations:
      - name: getbtcexchangereserve
        method: GET
        description: Bitcoin exchange reserve
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: eth-exchange-flows-inflow
      path: /eth/exchange-flows/inflow
      operations:
      - name: getethexchangeinflow
        method: GET
        description: Ethereum exchange inflow
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: eth-exchange-flows-reserve
      path: /eth/exchange-flows/reserve
      operations:
      - name: getethexchangereserve
        method: GET
        description: Ethereum exchange reserve
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.CRYPTOQUANT_API_KEY}}'
  exposes:
  - type: rest
    namespace: cryptoquant-exchange-flows-rest
    port: 8080
    description: REST adapter for CryptoQuant API — Exchange Flows. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/btc/exchange-flows/inflow
      name: btc-exchange-flows-inflow
      description: REST surface for btc-exchange-flows-inflow.
      operations:
      - method: GET
        name: getbtcexchangeinflow
        description: Bitcoin exchange inflow
        call: cryptoquant-exchange-flows.getbtcexchangeinflow
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/btc/exchange-flows/outflow
      name: btc-exchange-flows-outflow
      description: REST surface for btc-exchange-flows-outflow.
      operations:
      - method: GET
        name: getbtcexchangeoutflow
        description: Bitcoin exchange outflow
        call: cryptoquant-exchange-flows.getbtcexchangeoutflow
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/btc/exchange-flows/reserve
      name: btc-exchange-flows-reserve
      description: REST surface for btc-exchange-flows-reserve.
      operations:
      - method: GET
        name: getbtcexchangereserve
        description: Bitcoin exchange reserve
        call: cryptoquant-exchange-flows.getbtcexchangereserve
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/eth/exchange-flows/inflow
      name: eth-exchange-flows-inflow
      description: REST surface for eth-exchange-flows-inflow.
      operations:
      - method: GET
        name: getethexchangeinflow
        description: Ethereum exchange inflow
        call: cryptoquant-exchange-flows.getethexchangeinflow
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/eth/exchange-flows/reserve
      name: eth-exchange-flows-reserve
      description: REST surface for eth-exchange-flows-reserve.
      operations:
      - method: GET
        name: getethexchangereserve
        description: Ethereum exchange reserve
        call: cryptoquant-exchange-flows.getethexchangereserve
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cryptoquant-exchange-flows-mcp
    port: 9090
    transport: http
    description: MCP adapter for CryptoQuant API — Exchange Flows. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: bitcoin-exchange-inflow
      description: Bitcoin exchange inflow
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cryptoquant-exchange-flows.getbtcexchangeinflow
      outputParameters:
      - type: object
        mapping: $.
    - name: bitcoin-exchange-outflow
      description: Bitcoin exchange outflow
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cryptoquant-exchange-flows.getbtcexchangeoutflow
      outputParameters:
      - type: object
        mapping: $.
    - name: bitcoin-exchange-reserve
      description: Bitcoin exchange reserve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cryptoquant-exchange-flows.getbtcexchangereserve
      outputParameters:
      - type: object
        mapping: $.
    - name: ethereum-exchange-inflow
      description: Ethereum exchange inflow
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cryptoquant-exchange-flows.getethexchangeinflow
      outputParameters:
      - type: object
        mapping: $.
    - name: ethereum-exchange-reserve
      description: Ethereum exchange reserve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cryptoquant-exchange-flows.getethexchangereserve
      outputParameters:
      - type: object
        mapping: $.