Fireblocks Integration

BlockchainAnalysis.io integrates with Fireblocks as a co-signer, enabling automated pre-transaction compliance screening for all outgoing transactions from your Fireblocks-managed wallets. Transactions to high-risk or sanctioned addresses are automatically blocked before signing.

How It Works

1. Transaction Initiated — A user or automated process initiates a transaction in Fireblocks.
2. Co-Signer Triggered — Fireblocks sends the transaction details to the BlockchainAnalysis.io co-signer callback handler.
3. Compliance Screening — The destination address is screened in real-time against the BlockchainAnalysis.io database and sanctions lists.
4. Decision Returned — Based on the risk score and your configured policy, the co-signer returns an APPROVE, REJECT, or PENDING_REVIEW decision to Fireblocks.
5. Transaction Proceeds or Halts — Fireblocks either signs and broadcasts the transaction or blocks it, depending on the decision.

Prerequisites

Before setting up the integration, ensure you have:

• A Fireblocks workspace with API access
• Co-Signer configured in your Fireblocks environment
• A BlockchainAnalysis.io Enterprise account with API access enabled
• Your BlockchainAnalysis.io API key

Setup Guide

Step 1: Generate API Credentials

1. Log in to the BlockchainAnalysis.io dashboard.
2. Navigate to Settings > API Keys.
3. Click Create Key and select the Fireblocks Co-Signer scope.
4. Copy the API key and store it securely.

Step 2: Configure the Co-Signer Callback

In your Fireblocks Co-Signer configuration, set the callback URL to:

https://api.blockchainanalysis.io/v1/integrations/fireblocks/cosigner

Step 3: Set the API Key

Add your BlockchainAnalysis.io API key to the co-signer environment:

export BA_API_KEY="your_api_key_here"
export BA_COSIGNER_URL="https://api.blockchainanalysis.io/v1/integrations/fireblocks/cosigner"

Step 4: Configure Screening Policy

In the BlockchainAnalysis.io dashboard, navigate to Integrations > Fireblocks and configure your screening policy:

| Setting | Description | Default | |---|---|---| | Auto-Reject Threshold | Risk score at or above which transactions are automatically rejected | 80 | | Auto-Approve Threshold | Risk score at or below which transactions are automatically approved | 30 | | Review Range | Risk scores between the two thresholds trigger manual review | 31--79 | | Sanctions Policy | Action when a sanctions match is detected | Reject | | Timeout Action | Action if the screening does not complete within the timeout | Reject | | Timeout Duration | Maximum time to wait for screening results | 30 seconds |

Step 5: Test the Integration

1. In Fireblocks, initiate a small test transaction to a known low-risk address.
2. Verify that the transaction is approved and the screening result appears in the BlockchainAnalysis.io dashboard.
3. Initiate a test transaction to a known sanctioned address to verify that the transaction is rejected.

Supported Chains

The Fireblocks integration supports screening on all chains that are supported by both Fireblocks and BlockchainAnalysis.io. This includes Ethereum, Bitcoin, Polygon, Arbitrum, Optimism, Avalanche, BNB Smart Chain, Solana, and others.

Monitoring and Logs

All co-signer decisions are logged in:

• BlockchainAnalysis.io Dashboard — Under Integrations > Fireblocks > Activity Log.
• Audit Trail — All decisions are recorded in the Audit Trail with full details including risk score, decision, and timestamp.
• Fireblocks Console — Transaction status reflects the co-signer decision.

Troubleshooting

| Issue | Resolution | |---|---| | All transactions rejected | Check that your API key is valid and the timeout duration is sufficient. | | Co-signer not responding | Verify the callback URL is correct and your network allows outbound HTTPS to api.blockchainanalysis.io. | | Screening results delayed | Check the status page for platform availability. | | Unsupported chain error | Verify that the chain is supported by both Fireblocks and BlockchainAnalysis.io. |