Transactions

In a nutshell
Every deposit, withdrawal, swap, or sweep that flows through Blockradar creates a transaction record. The Transactions API is your activity log — use it to fetch history, investigate specific payments, trigger missed webhooks, cancel pending transactions, or retry failed ones.

Prerequisites

API Key

Get your API key from the Blockradar Dashboard. Navigate to Developers to generate one.

Wallet Created

You’ll need a walletId to query transactions. Create one via the dashboard or API.

How It Works

When any on-chain event occurs on a Blockradar wallet: a deposit arriving, a withdrawal being submitted, a sweep being triggered, Blockradar creates a transaction record and fires a webhook. The Transactions API gives you programmatic access to all of these records.

Fetch History

Retrieve all transactions for a wallet or filter by address, asset, status, or date range.

Investigate Payments

Look up a specific transaction by ID to check its status, hash, and metadata.

Replay Webhooks

Resend a webhook for a transaction your system may have missed or failed to process.

Cancel or Retry

Cancel a stuck pending transaction or retry a failed one without re-submitting from scratch.

Transaction States

Status	Description
`PENDING`	Transaction submitted to the blockchain, awaiting confirmation
`SUCCESS`	Transaction confirmed and settled
`FAILED`	Transaction failed on-chain or was rejected
`CANCELLED`	Transaction was cancelled before it was broadcast

Fetching Transactions

Get all transactions for a wallet

GET /v1/wallets/{walletId}/transactions

You can filter by address, asset, type, status, and date range using query parameters.

Get a single transaction

GET /v1/wallets/{walletId}/transactions/{transactionId}

Example

const transactions = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/transactions?status=SUCCESS&limit=50`,
  {
    headers: { 'x-api-key': apiKey }
  }
).then(r => r.json());

console.log(transactions.data);

Replaying a Missed Webhook

If your system missed or failed to process a webhook, you can trigger a resend without waiting for another on-chain event.

POST /v1/wallets/{walletId}/transactions/{transactionId}/resend-webhook

This is useful for reconciliation flows and recovering from downtime.

Cancelling a Pending Transaction

If a transaction is stuck in PENDING and hasn’t been broadcast yet, you can cancel it.

POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel

Cancellation is only possible before a transaction is broadcast to the blockchain. Once it’s on-chain, it cannot be cancelled.

Retrying a Failed Transaction

If a transaction failed due to insufficient gas or a temporary node issue, you can retry it.

POST /v1/wallets/{walletId}/transactions/{transactionId}/retry

Best Practices

Use webhooks as your primary signal — don’t poll the Transactions API for real-time updates. Use it for reconciliation, investigations, and history.
Store transaction IDs — save the Blockradar transaction ID alongside your internal records so you can look up status at any time.
Replay webhooks after downtime — if your webhook endpoint was unavailable, use the resend endpoint to recover missed events rather than re-processing manually.

API Reference

Endpoint	Description
Get Transactions	Fetch all transactions for a wallet
Get Transaction	Fetch a single transaction by ID
Resend Webhook	Replay a webhook for a transaction
Trigger Asset Sweep	Manually trigger a sweep
Cancel Transaction	Cancel a pending transaction
Retry Transaction	Retry a failed transaction

Get Started

Wallets

Receive Payments

Send Payments

Convert & Manage

Compliance & Recovery

Integrations

Prerequisites

How It Works

Fetch History

Investigate Payments

Replay Webhooks

Cancel or Retry

Transaction States

Fetching Transactions

Get all transactions for a wallet

Get a single transaction

Example

Replaying a Missed Webhook

Cancelling a Pending Transaction

Retrying a Failed Transaction

Best Practices

API Reference

​Prerequisites

​How It Works

Fetch History

Investigate Payments

Replay Webhooks

Cancel or Retry

​Transaction States

​Fetching Transactions

​Get all transactions for a wallet

​Get a single transaction

​Example

​Replaying a Missed Webhook

​Cancelling a Pending Transaction

​Retrying a Failed Transaction

​Best Practices

​API Reference

Prerequisites

How It Works

Transaction States

Fetching Transactions

Get all transactions for a wallet

Get a single transaction

Example

Replaying a Missed Webhook

Cancelling a Pending Transaction

Retrying a Failed Transaction

Best Practices

API Reference