naftiko: 1.0.0-alpha2
info:
  label: "Backpack Exchange \u2014 Capital"
  description: "Backpack Exchange API \u2014 Capital. 9 operations. Self-contained Naftiko capability covering one Backpack business surface."
  tags:
  - Backpack
  - Exchange
  - Capital
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    BACKPACK_API_KEY: BACKPACK_API_KEY
    BACKPACK_API_SECRET: BACKPACK_API_SECRET
capability:
  consumes:
  - type: http
    namespace: backpack-capital
    baseUri: https://api.backpack.exchange
    description: Backpack Exchange Capital business capability. ED25519 signed requests.
    resources:
    - name: api-v1-account-convertdust
      path: /api/v1/account/convertDust
      operations:
      - name: convert-dust
        method: POST
        description: Convert a dust balance.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-capital
      path: /api/v1/capital
      operations:
      - name: get-balances
        method: GET
        description: Get balances.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-v1-capital-collateral
      path: /api/v1/capital/collateral
      operations:
      - name: get-collateral
        method: GET
        description: Get collateral.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: wapi-v1-capital-deposits
      path: /wapi/v1/capital/deposits
      operations:
      - name: get-deposits
        method: GET
        description: Get deposits.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: wapi-v1-capital-deposit-address
      path: /wapi/v1/capital/deposit/address
      operations:
      - name: get-deposit-address
        method: GET
        description: Get deposit address.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: wapi-v1-capital-withdrawals
      path: /wapi/v1/capital/withdrawals
      operations:
      - name: get-withdrawals
        method: GET
        description: Get withdrawals.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: request-withdrawal
        method: POST
        description: Request withdrawal.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: wapi-v1-history-dust
      path: /wapi/v1/history/dust
      operations:
      - name: get-dust-history
        method: GET
        description: Get dust conversion history.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: wapi-v1-history-settlement
      path: /wapi/v1/history/settlement
      operations:
      - name: get-settlement-history
        method: GET
        description: Get settlement history.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{env.BACKPACK_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: backpack-capital-rest
    port: 8080
    description: "REST adapter for Backpack Exchange \u2014 Capital."
    resources:
    - path: /api/v1/account/convertDust
      name: api-v1-account-convertdust
      description: REST surface for api-v1-account-convertdust.
      operations:
      - method: POST
        name: convert-dust
        description: Convert a dust balance.
        call: backpack-capital.convert-dust
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /api/v1/capital
      name: api-v1-capital
      description: REST surface for api-v1-capital.
      operations:
      - method: GET
        name: get-balances
        description: Get balances.
        call: backpack-capital.get-balances
        outputParameters:
        - type: object
          mapping: $.
    - path: /api/v1/capital/collateral
      name: api-v1-capital-collateral
      description: REST surface for api-v1-capital-collateral.
      operations:
      - method: GET
        name: get-collateral
        description: Get collateral.
        call: backpack-capital.get-collateral
        outputParameters:
        - type: object
          mapping: $.
    - path: /wapi/v1/capital/deposits
      name: wapi-v1-capital-deposits
      description: REST surface for wapi-v1-capital-deposits.
      operations:
      - method: GET
        name: get-deposits
        description: Get deposits.
        call: backpack-capital.get-deposits
        outputParameters:
        - type: object
          mapping: $.
    - path: /wapi/v1/capital/deposit/address
      name: wapi-v1-capital-deposit-address
      description: REST surface for wapi-v1-capital-deposit-address.
      operations:
      - method: GET
        name: get-deposit-address
        description: Get deposit address.
        call: backpack-capital.get-deposit-address
        outputParameters:
        - type: object
          mapping: $.
    - path: /wapi/v1/capital/withdrawals
      name: wapi-v1-capital-withdrawals
      description: REST surface for wapi-v1-capital-withdrawals.
      operations:
      - method: GET
        name: get-withdrawals
        description: Get withdrawals.
        call: backpack-capital.get-withdrawals
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: request-withdrawal
        description: Request withdrawal.
        call: backpack-capital.request-withdrawal
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /wapi/v1/history/dust
      name: wapi-v1-history-dust
      description: REST surface for wapi-v1-history-dust.
      operations:
      - method: GET
        name: get-dust-history
        description: Get dust conversion history.
        call: backpack-capital.get-dust-history
        outputParameters:
        - type: object
          mapping: $.
    - path: /wapi/v1/history/settlement
      name: wapi-v1-history-settlement
      description: REST surface for wapi-v1-history-settlement.
      operations:
      - method: GET
        name: get-settlement-history
        description: Get settlement history.
        call: backpack-capital.get-settlement-history
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: backpack-capital-mcp
    port: 9090
    transport: http
    description: "MCP adapter for Backpack Exchange \u2014 Capital."
    tools:
    - name: backpack-convert-dust
      description: Convert a dust balance.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: backpack-capital.convert-dust
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: backpack-get-balances
      description: Get balances.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: backpack-capital.get-balances
      outputParameters:
      - type: object
        mapping: $.
    - name: backpack-get-collateral
      description: Get collateral.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: backpack-capital.get-collateral
      outputParameters:
      - type: object
        mapping: $.
    - name: backpack-get-deposits
      description: Get deposits.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: backpack-capital.get-deposits
      outputParameters:
      - type: object
        mapping: $.
    - name: backpack-get-deposit-address
      description: Get deposit address.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: backpack-capital.get-deposit-address
      outputParameters:
      - type: object
        mapping: $.
    - name: backpack-get-withdrawals
      description: Get withdrawals.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: backpack-capital.get-withdrawals
      outputParameters:
      - type: object
        mapping: $.
    - name: backpack-request-withdrawal
      description: Request withdrawal.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: backpack-capital.request-withdrawal
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: backpack-get-dust-history
      description: Get dust conversion history.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: backpack-capital.get-dust-history
      outputParameters:
      - type: object
        mapping: $.
    - name: backpack-get-settlement-history
      description: Get settlement history.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: backpack-capital.get-settlement-history
      outputParameters:
      - type: object
        mapping: $.