Jump to Content
Explore & Design
Develop & Integrate
Embedded Wallet Guides
API Reference
Try in Sandbox
Develop & Integrate
API Reference
Try in Sandbox
Explore & Design
Develop & Integrate
Embedded Wallet Guides
Get a tag
Search
JUMP TO
Introduction
API Overview
REST API Guide
Authenticate
API Idempotency
Rate Limiting
Transaction Sources & Destinations
Errors & Data Objects
API Responses and Error Codes
Transaction Statuses
Statuses
Sub-Statuses
Data Objects
Vault Objects
Exchange Account Objects
Fiat Account Objects
Network Connection Objects
Internal/External Wallet Objects
Contract Objects
Blockchain & Asset Objects
Transaction Objects
Transaction Authorization Objects
Fee Estimation Objects
Transaction Screening Objects
Raw Signing Objects
Payments Objects
Gas Station Objects
User Object
Webhook Object
NFT Objects
Web3 Connection Objects
General Objects
Handle API Errors
SDKs & Dev Tools
Quickstart
SDK Migration Guide
Postman Guide
TypeScript SDK
Python SDK
Java SDK
JS SDK (Legacy)
Python SDK (Legacy)
EVM Web3 Provider
EVM Local JSON RPC
Fireblocks Hardhat Plugin
Solana Web3 Connection Adapter
Hedera Token Service SDK
Demo Apps
Retail Demo Application
Introduction
Structure
Setup
Webhooks
Overview
Getting started
Configuring webhooks
Validating webhook events
Resending & troubleshooting webhook notifications
IP allowlisting
Webhook & notification structures
Webhook object structure
Webhook notification structure
Event types
Transaction events
Wallet events
Embedded Wallet events
CeFi events
Whitelist events
Tokenization events
Smart Transfer events
Network connection events
Off Exchange events
Best practices for webhooks
Webhooks v1
Migration Guide
Configure Webhook URLs
Validate Requests
Resend Webhook Notifications
Code Examples
Webhooks v1 Data Objects
Vault Webhooks
Exchange & Fiat Account Webhooks
Network Connection Webhooks
Smart Transfer Webhooks
Internal, External & Contract Wallet Webhooks
Transaction Webhooks
NFT Webhooks
Off Exchange Webhooks
Automation Webhooks
Manage Your Workspace
Create API keys
Configure Policies
Manage Wallets
Create Vault Accounts
Create Vault Wallets
Create Omnibus Structure
Manage Transactions
Create Transactions
Boost Transactions
Sweep to Omnibus
Select UTXOs
Consolidate UTXOs
Monitoring Transaction Statuses
Manage Transaction Fees
Configure Gas Station
Enable Auto Fueling
Set the Gas Station values
Fund the Gas Station
Monitor the Gas Station
Estimate Transaction Fee
Manage Treasury
Execute Smart Transfers
Stake Assets
Overview
Create a Staking Position
Unstake & Withdraw
Connect to Exchanges & Fiat Providers
Comply with regulation
Validate Travel Rule
How to Use Fireblocks TypeScript SDK with Travel Rule Messages
Manage Smart Contracts
Upload Contract Template
Issue New ERC20F Tokens
Setting Up Roles in ERC20F Tokens
Operational Guide for ERC20F Token
Issue new ERC721F/ERC1155F Tokens
Interact with Solana Programs
SDK - Multichain Deployment
Manage Assets
Get Supported Assets
Add Tokens
Manage NFTs
Deploy an NFT Collection
Mint an NFT
Retrieve NFTs
Transfer NFTs
Sign Offchain Messages
Typed Message Signing
Structure the API Call
Sign Typed Messages in Ethereum
Sign Typed Messages in Tron
Sign Typed Messages in Bitcoin
RAW Signing
Structure the API Call
Code Examples
Caching Signatures
Automate Flows
Set API Co-Signer Callback Handler
Authenticating the Callback Handler Request
API Co-signer Management
API Co-signer Deployment Options and Installation Flow
Add a new Co-signer to the workspace
Install SGX Azure API Co-signer
Install SGX Azure Marketplace API Co-signer
Install SGX On-prem API Co-signer
Install SGX IBM Cloud API Co-signer
Install SGX Alibaba Cloud API Co-signer
Install AWS Nitro API Co-signer
Install Google Cloud Confidential Space API Co-signer
Using the Communal Test Co-signer
Setup API Co-signer Callback Handler
Establishing Secure Communication Between the Co-signer and the Callback Handler
Callback Handler Response Object
Approve Transactions
Approve Configuration Changes
Basic Callback Handler Code Example
Use the Plugin Based Callback Handler
Validate ETH Raw Transactions
Operating the API Co-signer
API Co-signer Maintenance
SGX API Co-signer Maintenance
AWS Nitro API Co-signer Maintenance
GCP Confidential Space API Co-signer Maintenance
API Co-signers Versions
SGX API Co-signer Version History
AWS Nitro API Co-signer Version History
GCP Confidential Space API Co-signer Version History
API Co-Signer Troubleshooting
Create Payments
Execute Payouts
Create Payment Flows
Workflow Data Objects
Create Workflow Configuration
Create Workflow Execution
Launch Workflow Execution
Fireblocks API
Vaults
Create a new vault account
post
Bulk creation of new deposit addresses
post
Get the job status of the bulk deposit address creation
get
Get vault accounts (Paginated)
get
Bulk creation of new vault accounts
post
Get a vault account by ID
get
Get job status of bulk creation of new vault accounts
get
Rename a vault account
put
Get vault wallets (Paginated)
get
Hide a vault account in the console
post
Unhide a vault account in the console
post
Activate a wallet in a vault account
post
Set an AML/KYT ID for a vault account
post
Set auto fueling to on or off
post
Get the asset balance for a vault account
get
Create a new vault wallet
post
Refresh asset balance data
post
Create new asset deposit address
post
Get addresses (Paginated)
get
Get the max spendable amount in a transaction.
get
Update address description
put
Assign AML customer reference ID
post
Convert a segwit address to legacy format
post
Get UTXO unspent inputs information
get
Get the public key for a derivation path
get
Get an asset's public key
get
Get asset balance for chosen assets
get
Get vault balance by an asset
get
Get vault accounts
get
Attach tags to a vault accounts
post
Get asset addresses
get
Detach tags from a vault accounts
post
Workspace Management
Get console users
get
Create console user
post
List user groups
get
Create user group
post
Get user group
get
Update user group
put
Delete user group
del
Get audit logs
get
Update admin quorum threshold
put
Enable or disable transactions to OTA
put
Returns current OTA status
get
Returns current workspace status
get
Get API Keys
get
Create API Key
post
Get whitelisted ip addresses for an API Key
get
Resets device
post
Freeze
post
Get audit logs
get
List users
get
Exchange Accounts
Add an Exchange Account
post
List connected exchange accounts
get
Get a specific exchange account
get
Internal transfer for exchange accounts
post
Convert exchange account funds
post
Get an asset for an exchange account
get
Get public key to encrypt exchange credentials
get
List exchange accounts
get
Fiat Accounts
List fiat accounts
get
Find a specific fiat account
get
Redeem funds to DDA
post
Deposit funds from DDA
post
Fireblocks Network
List network connections
get
Creates a new network connection
post
Update network connection routing policy.
patch
Retrieve third-party network routing validation
get
Get a network connection
get
Deletes a network connection by ID
del
Get all network IDs
get
Creates a new Network ID
post
Returns all enabled routing policy asset groups
get
Get both local IDs and discoverable remote IDs
get
Returns specific network ID.
get
Deletes specific network ID.
del
Update network id routing policy.
patch
Update network ID's discoverability.
patch
Update network ID's name.
patch
Whitelisted Internal Wallets
List internal wallets
get
Create an internal wallet
post
Get assets for internal wallet
get
Delete an internal wallet
del
List assets in an internal wallet (Paginated)
get
Set an AML/KYT customer reference ID for internal wallet
post
Get an asset from an internal wallet
get
Add an asset to an internal wallet
post
Delete a whitelisted address
del
Key Link
Add a new signing key
post
Get list of signing keys
get
Get a signing key by `keyId`
get
Modify the signing keyId
patch
Set agent user id
patch
Add a new validation key
post
Get list of registered validation keys
get
Get a validation key by `keyId`
get
Disables a validation key
patch
Keys (Beta)
Get list of mpc keys
get
Get list of mpc keys by `userId`
get
Whitelisted External Wallets
List external wallets
get
Create an external wallet
post
Find an external wallet
get
Delete an external wallet
del
Set an AML customer reference ID for an external wallet
post
Get an asset from an external wallet
get
Add an asset to an external wallet.
post
Delete an asset from an external wallet
del
Whitelisted Contracts
List Whitelisted Contracts
get
Create a Whitelisted Contract
post
Find a Specific Whitelisted Contract
get
Delete a Whitelisted Contract
del
Find a whitelisted contract's asset
get
Add an Asset to a Whitelisted Contract
post
Delete a Whitelisted Contract's Asset
del
Blockchains & Assets
List assets
get
Register an asset
post
Get an asset by ID
get
Set asset price
post
List blockchains
get
Get a Blockchain by ID
get
Validate destination address
get
Estimate the required fee for an asset
get
Legacy - List Assets
get
Transactions
Get transaction history
get
Create a new transaction
post
Estimate transaction fee
post
Get a specific transaction by Fireblocks transaction ID
get
Get a specific transaction by external transaction ID
get
Set confirmation threshold by Fireblocks Transaction ID
post
Drop ETH (EVM) transaction by ID
post
Cancel a transaction
post
Freeze a transaction
post
Unfreeze a transaction
post
Set confirmation threshold by transaction hash
post
Payments - Payout
Create a payout instruction set
post
Execute a payout instruction set
post
Get the status of a payout instruction set
get
Payments - Flows
Create payment flow configuration
post
Retrieve workflow configuration
get
Delete workflow configuration
del
Create workflow execution
post
Get workflow execution details
get
Execute the payments workflow
post
Gas Station
Get gas station settings
get
Get gas station settings by asset
get
Edit gas station settings
put
Edit gas station settings for an asset
put
Off Exchange
Add Collateral
post
Remove Collateral
post
Create Settlement for a Trader
post
Get Settlements Transactions
get
Find a specific collateral exchange account
get
Webhooks
Resend failed webhooks
post
Resend webhooks for a transaction by ID
post
Webhooks V2
Create a new webhook
post
Get all webhooks
get
Get webhook by id
get
Update webhook
patch
Delete a webhook
del
Get all notifications by webhook ID
get
Resend notification by ID
post
Resend notifications by resource ID
post
Get notification by ID
get
Resend failed notifications
post
Get notification attempts
get
Get resend job status
get
Contract Templates
List all contract templates
get
Upload contract template
post
Return contract template by id
get
Delete a contract template by id
del
Return contract template's constructor
get
Return contract template's function
get
Deploy contract
post
Deployed Contracts
List deployed contracts data
get
Return deployed contract data by id
get
Return deployed contract data
get
Fetch the contract ABI
post
Save contract ABI
post
Tokenization
Issue a new token
post
List all linked tokens
get
Link a contract
post
Create a new collection
post
Get collections
get
Get a collection by id
get
Delete a collection link
del
Get collection token details
get
Mint tokens
post
Burn tokens
post
Unlink a token
del
Return a linked token
get
Swap (Beta)
Get Providers List
get
Approve terms of service
post
Create a quote
post
Create swap operation
post
Get Operations list
get
Get operation details
get
Tags
Create a tag
post
Get list of tags
get
Get a tag
get
Update a tag
patch
Delete a tag
del
Contract Interactions
Return deployed contract's ABI
get
Call a read function
post
Call a write function
post
Get transaction receipt
get
Staking
List supported chains for Fireblocks Staking
get
Get chain-specific staking summary
get
Merge operation on Solana stake accounts
post
Initiate Stake Operation
post
Execute an Unstake operation
post
Execute a Withdraw operation
post
Execute a Claim Rewards operation
post
Execute a Split operation
post
List staking positions details
get
Get staking summary details
get
Get staking summary details by vault
get
Get staking position details
get
List staking providers details
get
Approve staking terms of service
post
NFTs
Refresh vault account tokens
put
List all owned tokens (paginated)
get
List all distinct owned tokens (paginated)
get
List owned collections (paginated)
get
Refresh token metadata
put
List token data by ID
get
List tokens by IDs
get
Update token ownership status
put
Update tokens ownership status
put
Update tokens ownership spam property
put
dApp Connections
List all open Web3 connections
get
Create a new Web3 connection.
post
Respond to a pending connection
put
Remove an existing Web3 connection
del
Compliance
Validate Travel Rule Transaction
post
Validate Full Travel Rule Transaction
post
Get VASP details
get
Get All VASPs
get
Update VASP Details
put
Travel Rule - View Post-Screening Policy
get
Travel Rule - View Screening Policy
get
Get assigned VASP to vault
get
Assign VASP to vault
post
Get Travel Rule Screening Policy Configuration
get
Update Travel Rule Configuration
put
Get AML Screening Policy Configuration
get
Update AML Configuration
put
AML - View Screening Policy
get
AML - View Post-Screening Policy
get
Screening Configuration Update
put
Bypass Screening Policy
post
Get Screening Full Details
get
Policy Editor (Beta)
Get the active policy and its validation
get
Get the active draft
get
Update the draft with a new set of rules
put
Send publish request for a certain draft id
post
Send publish request for a set of policy rules
post
Smart Transfers
Create Ticket
post
Find Ticket
get
Search Ticket by ID
get
Set expiration
put
Add external ref. ID
put
Submit ticket
put
Fund ticket manually
put
Fund dvp ticket
put
Cancel Ticket
put
Create leg (term)
post
Get Smart Transfer ticket term
get
Update ticket leg (term)
put
Delete ticket leg (term)
del
Define funding source
put
Set funding source and approval
put
Manually add term transaction
put
Set user group
post
Get user group
get
Get smart transfers statistic
get
Job Management
Return a list of jobs belonging to tenant
get
Get job details
get
Pause a job
post
Continue a paused job
post
Cancel a running job
post
Return a list of tasks for given job
get
Cosigners (Beta)
Get all cosigners
get
Add cosigner
post
Get cosigner
get
Rename cosigner
patch
Get all API keys
get
Get API key
get
Pair API key
put
Unpair API key
del
Update API key callback handler
patch
Get request status
get
Fireblocks NCW
Non Custodial Wallets
Create a new wallet
post
List wallets
get
Get a wallet
get
Get wallet Latest Backup details
get
Get wallet key setup state
get
Enable or disable a wallet
put
Get the public key of an asset
get
Get the public key for a derivation path
get
Non Custodial Wallet Accounts
Create a new account
post
Get accounts
get
Get an account
get
Non Custodial Wallet Assets
Retrieve assets
get
Retrieve asset
get
Add asset to account
post
Refresh asset balance
put
Retrieve asset balance
get
Retrieve asset addresses
get
Retrieve supported assets
get
Non Custodial Wallet Devices
Get registered devices
get
Enable or Disable device
put
Get device key setup state
get
Non Custodial Wallets RPC
Invoke RPC
post
Get a tag
get
https://api.fireblocks.io/v1/tags/
{tagId}
Retrieve an existing tag by ID.
Language
Shell
JavaScript
Python
URL
Base URL
https://api.fireblocks.io/v1
/tags/{tagId}
