Filter and Retrieve Transactions — GET /dac/v1/transactions

The List Transactions endpoint returns the transaction history for your sub-account. You can narrow results using filters including asset, source and destination identifiers, transaction status, and Unix timestamp ranges. The endpoint supports pagination via the page and limit parameters, making it suitable for high-volume reconciliation workflows. You can also look up a specific transaction by its Finrock ID, on-chain hash, or user-supplied memo.

Request

string

required

Your Finrock API key.

string

required

Your JWT bearer token in the format Token {JWT}.

string

Filter by asset name (e.g. BTC, ETH). Returns transactions for this asset only. Use the asset_name value from the Supported Assets list.

int32

Return only transactions that occurred before this Unix timestamp (seconds since epoch). Use together with after to define a date range.

int32

Return only transactions that occurred after this Unix timestamp (seconds since epoch).

string

Filter by the transaction source type. See the Transaction Types reference for allowed values.

string

Filter by a specific source address or label within the source type.

string

Filter by the transaction destination type. See the Transaction Types reference for allowed values.

string

Filter by a specific destination address or label within the destination type.

string

Filter by transaction status (e.g. pending, confirmed, failed). See the Transaction Statuses reference for the full list.

string

The page number to return when paginating results. Starts at 1.

string

The number of records to return per page. Defaults to a platform maximum if not specified.

string

Filter by Finrock transaction ID or on-chain transaction hash. Other filter parameters are still applied when id is supplied.

string

Filter by the user-provided memo string attached to a transaction at creation time. Other filter parameters are still applied when memo is supplied.

Example Request

curl --request GET \
     --url 'https://api.finrock.io/dac/v1/transactions?asset=ETH&status=confirmed&limit=25&page=1' \
     --header 'Authorization: Token {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: {{api_key}}'

Response

A successful request returns HTTP 200 with an array of transaction objects.

string

The Finrock-assigned unique transaction identifier.

string

The on-chain transaction hash. May be null for transactions that are still pending broadcast.

string

The asset involved in the transaction.

number

The transaction amount in the asset’s native unit.

number

The network fee paid for this transaction, expressed in the blockchain’s native unit.

string

The source type of the transaction.

string

The source address or label.

string

The destination type of the transaction.

string

The destination address or label.

string

Current status of the transaction. See Transaction Statuses for possible values.

string

The user-provided note attached to the transaction, if any.

string

ISO 8601 timestamp of when the transaction was submitted to Finrock.

string

ISO 8601 timestamp of on-chain confirmation. null if not yet confirmed.

{
  "data": [
    {
      "id": "txn_abc123",
      "hash": "0xabc123def456...",
      "asset": "ETH",
      "amount": 0.5,
      "fee": 0.00042,
      "source_type": "INTERNAL",
      "source_id": "0xC3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1d2",
      "destination_type": "EXTERNAL",
      "destination_id": "0xRecipientAddress...",
      "status": "confirmed",
      "memo": "payout-order-789",
      "created_at": "2024-06-01T12:00:00Z",
      "confirmed_at": "2024-06-01T12:02:15Z"
    }
  ],
  "page": 1,
  "limit": 25,
  "total": 1
}

object

Returned when the x-api-key or Authorization header is missing or invalid.

{
  "error": "Unauthorized",
  "message": "Invalid or missing authentication credentials."
}

Overview

Wallets & Addresses

Transactions

Gas Tanks

Exchanges

AML

Invoicing

Utilities

Filter and Retrieve Transactions — GET /dac/v1/transactions

Request

Example Request

Response

​Request

​Example Request

​Response

Request

Example Request

Response