Fireblocks Transactions — Transactions

naftiko: 1.0.0-alpha2
info:
  label: "Fireblocks Transactions \u2014 Transactions"
  description: Fireblocks Transactions business capability. 19 operations against the Fireblocks REST API v1.
  tags:
  - Fireblocks
  - Transactions
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    FIREBLOCKS_API_KEY: FIREBLOCKS_API_KEY
    FIREBLOCKS_API_SECRET: FIREBLOCKS_API_SECRET
capability:
  consumes:
  - type: http
    namespace: transactions
    baseUri: https://api.fireblocks.io/v1
    description: Fireblocks Transactions REST capability. JWT-signed using API key + RSA private key.
    resources:
    - name: gettransactions
      path: /transactions
      operations:
      - name: gettransactions
        method: GET
        description: Get transaction history
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createtransaction
      path: /transactions
      operations:
      - name: createtransaction
        method: POST
        description: Create a new transaction
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: estimatetransactionfee
      path: /transactions/estimate_fee
      operations:
      - name: estimatetransactionfee
        method: POST
        description: Estimate transaction fee
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: gettransaction
      path: /transactions/{txId}
      operations:
      - name: gettransaction
        method: GET
        description: Get a specific transaction by Fireblocks transaction ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: gettransactionbyexternalid
      path: /transactions/external_tx_id/{externalTxId}
      operations:
      - name: gettransactionbyexternalid
        method: GET
        description: Get a specific transaction by external transaction ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: settransactionconfirmationthreshold
      path: /transactions/{txId}/set_confirmation_threshold
      operations:
      - name: settransactionconfirmationthreshold
        method: POST
        description: Set confirmation threshold by Fireblocks Transaction ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: droptransaction
      path: /transactions/{txId}/drop
      operations:
      - name: droptransaction
        method: POST
        description: Drop ETH (EVM) transaction by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: canceltransaction
      path: /transactions/{txId}/cancel
      operations:
      - name: canceltransaction
        method: POST
        description: Cancel a transaction
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: freezetransaction
      path: /transactions/{txId}/freeze
      operations:
      - name: freezetransaction
        method: POST
        description: Freeze a transaction
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: unfreezetransaction
      path: /transactions/{txId}/unfreeze
      operations:
      - name: unfreezetransaction
        method: POST
        description: Unfreeze a transaction
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: setconfirmationthresholdbytransactionhash
      path: /txHash/{txHash}/set_confirmation_threshold
      operations:
      - name: setconfirmationthresholdbytransactionhash
        method: POST
        description: Set confirmation threshold by transaction hash
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getapprovalrequest
      path: /tags/approval_requests/{id}
      operations:
      - name: getapprovalrequest
        method: GET
        description: Get an approval request by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: cancelapprovalrequest
      path: /tags/approval_requests/{id}/cancel
      operations:
      - name: cancelapprovalrequest
        method: POST
        description: Cancel an approval request by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getjobs
      path: /batch/jobs
      operations:
      - name: getjobs
        method: GET
        description: Return a list of jobs belonging to tenant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getjob
      path: /batch/{jobId}
      operations:
      - name: getjob
        method: GET
        description: Get job details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pausejob
      path: /batch/{jobId}/pause
      operations:
      - name: pausejob
        method: POST
        description: Pause a job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: continuejob
      path: /batch/{jobId}/continue
      operations:
      - name: continuejob
        method: POST
        description: Continue a paused job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: canceljob
      path: /batch/{jobId}/cancel
      operations:
      - name: canceljob
        method: POST
        description: Cancel a running job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getjobtasks
      path: /batch/{jobId}/tasks
      operations:
      - name: getjobtasks
        method: GET
        description: Return a list of tasks for given job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{env.FIREBLOCKS_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: transactions-rest
    port: 8080
    description: REST adapter for Fireblocks Transactions.
    resources:
    - path: /v1/transactions
      name: gettransactions
      description: Get transaction history
      operations:
      - method: GET
        name: gettransactions
        description: Get transaction history
        call: transactions.gettransactions
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/transactions
      name: createtransaction
      description: Create a new transaction
      operations:
      - method: POST
        name: createtransaction
        description: Create a new transaction
        call: transactions.createtransaction
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/transactions/estimate_fee
      name: estimatetransactionfee
      description: Estimate transaction fee
      operations:
      - method: POST
        name: estimatetransactionfee
        description: Estimate transaction fee
        call: transactions.estimatetransactionfee
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/transactions/{txId}
      name: gettransaction
      description: Get a specific transaction by Fireblocks transaction ID
      operations:
      - method: GET
        name: gettransaction
        description: Get a specific transaction by Fireblocks transaction ID
        call: transactions.gettransaction
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/transactions/external_tx_id/{externalTxId}
      name: gettransactionbyexternalid
      description: Get a specific transaction by external transaction ID
      operations:
      - method: GET
        name: gettransactionbyexternalid
        description: Get a specific transaction by external transaction ID
        call: transactions.gettransactionbyexternalid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/transactions/{txId}/set_confirmation_threshold
      name: settransactionconfirmationthreshold
      description: Set confirmation threshold by Fireblocks Transaction ID
      operations:
      - method: POST
        name: settransactionconfirmationthreshold
        description: Set confirmation threshold by Fireblocks Transaction ID
        call: transactions.settransactionconfirmationthreshold
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/transactions/{txId}/drop
      name: droptransaction
      description: Drop ETH (EVM) transaction by ID
      operations:
      - method: POST
        name: droptransaction
        description: Drop ETH (EVM) transaction by ID
        call: transactions.droptransaction
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/transactions/{txId}/cancel
      name: canceltransaction
      description: Cancel a transaction
      operations:
      - method: POST
        name: canceltransaction
        description: Cancel a transaction
        call: transactions.canceltransaction
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/transactions/{txId}/freeze
      name: freezetransaction
      description: Freeze a transaction
      operations:
      - method: POST
        name: freezetransaction
        description: Freeze a transaction
        call: transactions.freezetransaction
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/transactions/{txId}/unfreeze
      name: unfreezetransaction
      description: Unfreeze a transaction
      operations:
      - method: POST
        name: unfreezetransaction
        description: Unfreeze a transaction
        call: transactions.unfreezetransaction
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/txHash/{txHash}/set_confirmation_threshold
      name: setconfirmationthresholdbytransactionhash
      description: Set confirmation threshold by transaction hash
      operations:
      - method: POST
        name: setconfirmationthresholdbytransactionhash
        description: Set confirmation threshold by transaction hash
        call: transactions.setconfirmationthresholdbytransactionhash
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/tags/approval_requests/{id}
      name: getapprovalrequest
      description: Get an approval request by id
      operations:
      - method: GET
        name: getapprovalrequest
        description: Get an approval request by id
        call: transactions.getapprovalrequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tags/approval_requests/{id}/cancel
      name: cancelapprovalrequest
      description: Cancel an approval request by ID
      operations:
      - method: POST
        name: cancelapprovalrequest
        description: Cancel an approval request by ID
        call: transactions.cancelapprovalrequest
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/batch/jobs
      name: getjobs
      description: Return a list of jobs belonging to tenant
      operations:
      - method: GET
        name: getjobs
        description: Return a list of jobs belonging to tenant
        call: transactions.getjobs
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/batch/{jobId}
      name: getjob
      description: Get job details
      operations:
      - method: GET
        name: getjob
        description: Get job details
        call: transactions.getjob
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/batch/{jobId}/pause
      name: pausejob
      description: Pause a job
      operations:
      - method: POST
        name: pausejob
        description: Pause a job
        call: transactions.pausejob
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/batch/{jobId}/continue
      name: continuejob
      description: Continue a paused job
      operations:
      - method: POST
        name: continuejob
        description: Continue a paused job
        call: transactions.continuejob
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/batch/{jobId}/cancel
      name: canceljob
      description: Cancel a running job
      operations:
      - method: POST
        name: canceljob
        description: Cancel a running job
        call: transactions.canceljob
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/batch/{jobId}/tasks
      name: getjobtasks
      description: Return a list of tasks for given job
      operations:
      - method: GET
        name: getjobtasks
        description: Return a list of tasks for given job
        call: transactions.getjobtasks
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: transactions-mcp
    port: 9090
    transport: http
    description: MCP adapter for Fireblocks Transactions. One tool per consumed operation.
    tools:
    - name: fireblocks-gettransactions
      description: Get transaction history
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: transactions.gettransactions
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createtransaction
      description: Create a new transaction
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.createtransaction
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-estimatetransactionfee
      description: Estimate transaction fee
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.estimatetransactionfee
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-gettransaction
      description: Get a specific transaction by Fireblocks transaction ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: transactions.gettransaction
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-gettransactionbyexternalid
      description: Get a specific transaction by external transaction ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: transactions.gettransactionbyexternalid
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-settransactionconfirmationthreshold
      description: Set confirmation threshold by Fireblocks Transaction ID
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.settransactionconfirmationthreshold
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-droptransaction
      description: Drop ETH (EVM) transaction by ID
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.droptransaction
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-canceltransaction
      description: Cancel a transaction
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.canceltransaction
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-freezetransaction
      description: Freeze a transaction
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.freezetransaction
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-unfreezetransaction
      description: Unfreeze a transaction
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.unfreezetransaction
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-setconfirmationthresholdbytransactionhash
      description: Set confirmation threshold by transaction hash
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.setconfirmationthresholdbytransactionhash
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getapprovalrequest
      description: Get an approval request by id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: transactions.getapprovalrequest
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-cancelapprovalrequest
      description: Cancel an approval request by ID
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.cancelapprovalrequest
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getjobs
      description: Return a list of jobs belonging to tenant
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: transactions.getjobs
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getjob
      description: Get job details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: transactions.getjob
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-pausejob
      description: Pause a job
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.pausejob
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-continuejob
      description: Continue a paused job
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.continuejob
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-canceljob
      description: Cancel a running job
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: transactions.canceljob
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getjobtasks
      description: Return a list of tasks for given job
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: transactions.getjobtasks
      outputParameters:
      - type: object
        mapping: $.