Flutterwave Wallets API — Wallets

naftiko: 1.0.0-alpha2
info:
  label: Flutterwave Wallets API — Wallets
  description: Flutterwave multi-currency wallet balance and statement endpoints. 3 operations.
  tags: [Flutterwave, Wallets, Balances]
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys: { FLUTTERWAVE_ACCESS_TOKEN: FLUTTERWAVE_ACCESS_TOKEN }
capability:
  consumes:
  - type: http
    namespace: wallets-wallets
    baseUri: https://api.flutterwave.cloud/f4b/production
    description: Flutterwave Wallets business capability.
    resources:
    - name: wallet-balances
      path: /wallet-balances
      operations:
      - { name: listwalletbalances, method: GET, description: Flutterwave Fetch Wallet Balance For Multiple Currencies,
          outputRawFormat: json, outputParameters: [{ name: result, type: object, value: $. }] }
    - name: wallet-balances-currency
      path: /wallet-balances/{currency}
      operations:
      - { name: getwalletbalance, method: GET, description: Flutterwave Fetch A Currency Wallet Balance,
          outputRawFormat: json, outputParameters: [{ name: result, type: object, value: $. }] }
    - name: wallets-statement
      path: /wallets/statement
      operations:
      - { name: getwalletstatement, method: GET, description: Flutterwave Retrieve Wallet Statement,
          outputRawFormat: json, outputParameters: [{ name: result, type: object, value: $. }] }
    authentication: { type: bearer, value: '{{env.FLUTTERWAVE_ACCESS_TOKEN}}', placement: header }
  exposes:
  - type: rest
    namespace: wallets-wallets-rest
    port: 8080
    description: REST adapter for Flutterwave Wallets.
    resources:
    - path: /v4/wallet-balances
      name: wallet-balances
      operations:
      - { method: GET, name: listwalletbalances, description: Flutterwave Fetch Wallet Balance For Multiple Currencies,
          call: wallets-wallets.listwalletbalances, outputParameters: [{ type: object, mapping: $. }] }
    - path: /v4/wallet-balances/{currency}
      name: wallet-balances-currency
      operations:
      - { method: GET, name: getwalletbalance, description: Flutterwave Fetch A Currency Wallet Balance,
          call: wallets-wallets.getwalletbalance, outputParameters: [{ type: object, mapping: $. }] }
    - path: /v4/wallets/statement
      name: wallets-statement
      operations:
      - { method: GET, name: getwalletstatement, description: Flutterwave Retrieve Wallet Statement,
          call: wallets-wallets.getwalletstatement, outputParameters: [{ type: object, mapping: $. }] }
  - type: mcp
    namespace: wallets-wallets-mcp
    port: 9090
    transport: http
    description: MCP adapter for Flutterwave Wallets.
    tools:
    - { name: flutterwave-list-wallet-balances, description: Flutterwave Fetch Wallet Balance For Multiple Currencies,
        hints: { readOnly: true, destructive: false, idempotent: true },
        call: wallets-wallets.listwalletbalances, outputParameters: [{ type: object, mapping: $. }] }
    - { name: flutterwave-get-wallet-balance, description: Flutterwave Fetch A Currency Wallet Balance,
        hints: { readOnly: true, destructive: false, idempotent: true },
        call: wallets-wallets.getwalletbalance, outputParameters: [{ type: object, mapping: $. }] }
    - { name: flutterwave-get-wallet-statement, description: Flutterwave Retrieve Wallet Statement,
        hints: { readOnly: true, destructive: false, idempotent: true },
        call: wallets-wallets.getwalletstatement, outputParameters: [{ type: object, mapping: $. }] }