HTTP Codes

Dashboard

Github

Blockradar

API Reference

API Changelog

Support

Blockradar's API is RESTful and as such, uses conventional HTTP response codes to indicate the success or failure of requests.

Errors

Welcome to the Blockradar Developer Documentation. Here, you’ll learn how to build amazing experiences for your customers using the Blockradar API.

Introduction

Wallets

Learn how to create dedicated addresses for your customers to deposit stablecoins

Addresses

Webhooks allow you to set up a notification system that can be used to receive updates on certain requests made to the Blockradar API.

Webhooks

Learn how to seamlessly integrate our APIs into your application.

Authenticate your API calls by including your api key in the request header of every request you make. You can manage your API keys from the [dashboard](https://blockradar.co).

Authentication

Stay up-to-date with the latest changes to our APIs.

Overview

This endpoint retrieves the details of a specific wallet

Get Wallet

This endpoint allows you to update the details of a specific wallet

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| name | false | string | The updated name of the wallet. |
| description | false | string | The updated description of the wallet. |

Update wallet

This endpoint allows you to update the status of a specific wallet.

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| isActive | true | boolean | The status state you want to set the wallet to |

Update Wallet status

This endpoint allows you to initiate a withdrawal from a specific wallet.

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| assetId | true | string | The ID of the asset to be withdrawn. |
| address | true | string | The recipient's address for the withdrawal. |
| amount | true | string | The amount to be withdrawn. |
| reference | false | string | This would be the transaction reference |
| metadata | false | object | This would be atteched to the transaction payload |

Withdraw

This API endpoint is used to get the withdrawal network fee from a specific wallet.

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| assetId | true | string | The ID of the asset to be withdrawn. |
| address | true | string | The recipient's address for the withdrawal. |
| amount | true | string | The amount to be withdrawn. |

Withdraw Network Fee

This endpoint retrieves the balance of a specific wallet for a given asset.

Get Balance

This endpoint retrieves the balances of a specific wallet.

Get Balances

This endpoint is used to initiate a rescan of blocks for a specific wallet.

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| blockNumber | false | number | The blockchain block number the transaction was made |
| transactionHash | false | string | The blockchain transaction hash |

Deposit Finder

This endpoint is used to manually trigger assets sweep for all unswept assets for a specific wallet

Trigger Sweep Assets

This endpoint retrieves the webhooks associated with a specific wallet

Webhooks Logs

This endpoint allows for assets salvage from a specific wallet

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| senderAddress | true | string | The address you're recovering assets from |
| recipientAddress | true | string | The address the recovering assets will be sent to |
| amount | true | string | The amount to be salvaged. |
| tokenAddress | false | string | Specify this for token salvage |
| blockchainId | true | string | The blockchain id you're recovering funds from |

Asset Salvage

This endpoint retrieves the assets associated with a specific wallet.

Get Wallet Assets

This endpoint allows you to add assets to a specific wallet

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| assetId | true | string | The asset id you want this wallet to support. |

Add Asset to Wallet

This endpoint is used to delete a specific asset from a wallet.

Remove Asset from Wallet

This endpoint allows the client to update the status of a specific asset within a wallet.

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| isActive | true | boolean | Update asset status tied to a wallet. |

Update Wallet Asset

This endpoint retrieves the addresses associated with a specific wallet.

Get Addresses

This endpoint allows you to create a new address for a specific wallet.

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| name | false | string | The name of the address. |
| metadata | false | object | Additional metadata for the address, this will be part of any transaction tied to this |
| showPrivateKey | false | boolean | If you want the address private key to be part of the response |
| disableAutoSweep | false | boolean | Disable automatic sweeping of assets sent to the address into your master wallet |
| enableGaslessWithdraw | false | boolean | Enable gasless transactions from this address |

Generate Address

This endpoint retrieves information about a specific address within a wallet.

Get Address

This endpoint allows the client to update the status of a specific address within a wallet.

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| isActive | true | boolean | The status state you want to set the address |

Update Address

This endpoint allows you to whitelist an external address to be monitored based on the wallet policies

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| name | false | string | The name associated with the wallet address. |
| address | true | string | The wallet address to be added to the whitelist. |
| metadata | false | object | Additional metadata associated with the wallet address this will be part of the transaction payload metadata |

Whitelist address

The endpoint allows the deletion of a specific address from the whitelist of a wallet.

Unwhitelist address

This endpoint retrieves the balance of a specific address within a wallet

This endpoint retrieves the balances associated with a specific address in a wallet.

This endpoint retrieves the transactions associated with a specific address in a wallet.

Get transactions

This endpoint retrieves the transactions associated with a specific wallet.

Get Transactions

The endpoint retrieves the details of a specific transaction associated with a wallet.

Get transaction

This endpoint is used to resend webhooks for transactions associated with a specific wallet.

Resend Webhook



This endpoint is used to initiate a sweep of assets for a specific transaction within a wallet

Trigger Asset Sweep



This endpoint retrieves the webhooks associated with a specific transaction within a wallet

Webhook Logs

This endpoint allows you to update the details of a specific wallet

### Body Parameters

| Key | **Required** | Type | Description |
| --- | --- | --- | --- |
| settlementFrequency | true | string | INSTANT, DAILY, WEEKLY, MONTHLY, YEARLY. |

Create

The endpoint retrieves the list of beneficiaries associated with a specific wallet.

Get all

This endpoint retrieves details of a specific beneficiary associated with a wallet.

Get one

This endpoint allows you to update the details of a specific beneficiary associated with a wallet.

Update

This API endpoint is used to delete a beneficiary from a specific wallet.

Delete

This endpoint allows you to create a payment link with the specified details.

This endpoint retrieves a list of payment links.

Get All

The `GET` request retrieves information about a specific payment link identified by `:id`

Get One

This endpoint allows you to update the details of a specific payment link.

This API endpoint is used to perform an anti-money laundering (AML) lookup for a given address and blockchain

Lookup

This endpoint allows to retrieve a list of assets supported by Blockradar

Get Assets

This endpoint retrieves the rates of specified assets in the given currency.

Get Rates

### Get Blockchains

This endpoint retrieves a list of supported blockchains by Blockradar

Code	Description
200	Request was successful and intended action was carried out.
201	A resource has successfully been created.
400	A validation or client side error occurred and the request was not fulfilled.
401	The request was not authorized. This can be triggered by passing an invalid api key in the x-api-key header or the lack of one.
404	Request could not be fulfilled as the requested resource does not exist.
5xx	Request could not be fulfilled due to an error on Blockradar’s end. This shouldn’t happen so please report as soon as you encounter any instance of this.

API Documentation

Wallet

Asset

Addresses

Transactions

Auto Settlements

Payment Links

AML(Anti Money Laundering)

Miscellaneous

Errors

HTTP Codes

API Documentation

Wallet

Asset

Addresses

Transactions

Auto Settlements

Payment Links

AML(Anti Money Laundering)

Miscellaneous

​HTTP Codes

HTTP Codes