Transactions - Finrock

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}}'

{
  "pagination": {
    "page": 1,
    "limit": 200,
    "total_records": 45
  },
  "transactions": [
    {
      "id": "a9cd7e4c-cb0d-4b90-8196-0b5e070c47c7",
      "sub_account": {
        "id": "47fbf0b6-04ff-4843-ba9f-7163815fb6e1",
        "title": "Main Account"
      },
      "type": "Deposit",
      "asset": "USDT_BNB",
      "asset_ticker": "USDT",
      "chain": {
        "id": "BNB",
        "title": "Binance Coin",
        "ticker": "BNB",
        "token_type": null
      },
      "amount": 500.00000000,
      "amount_in_usd": 499.97,
      "network_fee": 0.000056776500000000,
      "nett": 500.00000000,
      "fees": null,
      "hash": "0x00a1b93349e3e9ffe761125208c5f9b087859ba361a57c5bcade4fe8b6b007ec",
      "source_type": "External",
      "source_id": "0xc3afa8e23f6c0eca0a72930796e96845d3bb5e5a",
      "source_alias": null,
      "dest_type": "Internal",
      "dest_id": "0x11c2b67563542da937635bcf4c4639c085a3934a",
      "dest_alias": "Invoices for customer 6",
      "dest_outputs": [],
      "memo": null,
      "sequence_id": "",
      "created_on_utc": "2024-06-17T18:38:29Z",
      "created_timestamp_utc": 1718649509,
      "status": "Success",
      "confirmations": {
        "required": 10,
        "actual": 102
      },
      "explorer_url": "https://bscscan.com/tx/0x00a1b93349e3e9ffe761125208c5f9b087859ba361a57c5bcade4fe8b6b007ec",
      "last_updated_on_utc": "2024-06-17T18:39:12Z",
      "last_updated_timestamp_utc": 1718649552,
      "tx_key": "",
      "failure_reason": "",
      "approvals": null,
      "aml": {
        "cid": null,
        "risk_score": null,
        "ca_payload": null
      },
      "created_by": null,
      "cancelled_by": null,
      "tx_dtmemo": null,
      "invoice_id": null,
      "cancelable": false,
      "bank_detail": null
    },
    {
      "id": "b12b7ec6-0162-4381-a90d-270a6abc5cc2",
      "sub_account": {
        "id": "47fbf0b6-04ff-4843-ba9f-7163815fb6e1",
        "title": "Main Account"
      },
      "type": "Withdraw",
      "asset": "USDT_BNB",
      "asset_ticker": "USDT",
      "chain": {
        "id": "BNB",
        "title": "Binance Coin",
        "ticker": "BNB",
        "token_type": null
      },
      "amount": 1500.00000000,
      "amount_in_usd": 1500.00,
      "network_fee": 0.000055786500000000,
      "nett": -1500.000055786500000000,
      "fees": {
        "sweep_fee": 0.000000000000000000,
        "refill_fee": 0.000023100000000000,
        "withdrawal_fee": 0.000032686500000000
      },
      "hash": "0x8eefa61e0362f37f7760d87253febf479aef4c72faeaeb1121996eb585dc213b",
      "source_type": "Internal",
      "source_id": "0x11c2B67563542da937635bcF4c4639c085A3934a",
      "source_alias": "Invoices for customer 6",
      "dest_type": "External",
      "dest_id": "0xC33bB2A76CA770D9beA3efae82200EaF29C228bd",
      "dest_alias": "Whitelisted Address",
      "dest_outputs": [],
      "memo": "cashout",
      "sequence_id": null,
      "created_on_utc": "2025-03-04T22:50:37Z",
      "created_timestamp_utc": 1741128637,
      "status": "Success",
      "confirmations": {
        "required": 10,
        "actual": 16
      },
      "explorer_url": "https://bscscan.com/tx/0x8eefa61e0362f37f7760d87253febf479aef4c72faeaeb1121996eb585dc213b",
      "last_updated_on_utc": "2025-03-04T23:18:47Z",
      "last_updated_timestamp_utc": 1741130327,
      "tx_key": null,
      "failure_reason": null,
      "approvals": {
        "required": 1,
        "confirmed": 1,
        "users": [
          {
            "first_name": "Jane",
            "last_name": "Doe",
            "role": "Owner",
            "approval_status": "Approved",
            "updated_on": 1741128739
          }
        ]
      },
      "aml": {
        "cid": "0",
        "risk_score": "LOW",
        "ca_payload": []
      },
      "created_by": {
        "name": "Jane Doe",
        "email": "jane.doe@example.com"
      },
      "cancelled_by": null,
      "tx_dtmemo": "",
      "invoice_id": "",
      "cancelable": false,
      "bank_detail": null
    },
    {
      "id": "f657ff64-7270-4797-8726-8dffc40090b0",
      "sub_account": {
        "id": "47fbf0b6-04ff-4843-ba9f-7163815fb6e1",
        "title": "Main Account"
      },
      "type": "Sweep",
      "asset": "USDT_BNB",
      "asset_ticker": "USDT",
      "chain": {
        "id": "BNB",
        "title": "Binance Coin",
        "ticker": "BNB",
        "token_type": null
      },
      "amount": 3100.00000000,
      "amount_in_usd": 3100.00,
      "network_fee": 0.000001634325000000,
      "nett": 0.0,
      "fees": null,
      "hash": "0x96a9fb8a875e96e324f850a70bbb624ae1cf1c10904e43f5602a1acad2b0a995",
      "source_type": "Internal",
      "source_id": "0xa54171d2f69039257f546a38efe09078093835ce",
      "source_alias": "Invoices for customer 2",
      "dest_type": "Internal",
      "dest_id": "0xfaf403c12bde4d81c9b47db273ab3bb4e80e9df2",
      "dest_alias": "Main Address",
      "dest_outputs": [],
      "memo": null,
      "sequence_id": "",
      "created_on_utc": "2025-12-12T12:53:13Z",
      "created_timestamp_utc": 1765543993,
      "status": "Success",
      "confirmations": {
        "required": 10,
        "actual": 102
      },
      "explorer_url": "https://bscscan.com/tx/0x96a9fb8a875e96e324f850a70bbb624ae1cf1c10904e43f5602a1acad2b0a995",
      "last_updated_on_utc": "2025-12-12T12:53:26Z",
      "last_updated_timestamp_utc": 1765544006,
      "tx_key": "",
      "failure_reason": "",
      "approvals": null,
      "aml": {
        "cid": null,
        "risk_score": null,
        "ca_payload": null
      },
      "created_by": null,
      "cancelled_by": null,
      "tx_dtmemo": "",
      "invoice_id": null,
      "cancelable": false,
      "bank_detail": null
    }
  ]
}

GET

dac

transactions

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}}'

{
  "pagination": {
    "page": 1,
    "limit": 200,
    "total_records": 45
  },
  "transactions": [
    {
      "id": "a9cd7e4c-cb0d-4b90-8196-0b5e070c47c7",
      "sub_account": {
        "id": "47fbf0b6-04ff-4843-ba9f-7163815fb6e1",
        "title": "Main Account"
      },
      "type": "Deposit",
      "asset": "USDT_BNB",
      "asset_ticker": "USDT",
      "chain": {
        "id": "BNB",
        "title": "Binance Coin",
        "ticker": "BNB",
        "token_type": null
      },
      "amount": 500.00000000,
      "amount_in_usd": 499.97,
      "network_fee": 0.000056776500000000,
      "nett": 500.00000000,
      "fees": null,
      "hash": "0x00a1b93349e3e9ffe761125208c5f9b087859ba361a57c5bcade4fe8b6b007ec",
      "source_type": "External",
      "source_id": "0xc3afa8e23f6c0eca0a72930796e96845d3bb5e5a",
      "source_alias": null,
      "dest_type": "Internal",
      "dest_id": "0x11c2b67563542da937635bcf4c4639c085a3934a",
      "dest_alias": "Invoices for customer 6",
      "dest_outputs": [],
      "memo": null,
      "sequence_id": "",
      "created_on_utc": "2024-06-17T18:38:29Z",
      "created_timestamp_utc": 1718649509,
      "status": "Success",
      "confirmations": {
        "required": 10,
        "actual": 102
      },
      "explorer_url": "https://bscscan.com/tx/0x00a1b93349e3e9ffe761125208c5f9b087859ba361a57c5bcade4fe8b6b007ec",
      "last_updated_on_utc": "2024-06-17T18:39:12Z",
      "last_updated_timestamp_utc": 1718649552,
      "tx_key": "",
      "failure_reason": "",
      "approvals": null,
      "aml": {
        "cid": null,
        "risk_score": null,
        "ca_payload": null
      },
      "created_by": null,
      "cancelled_by": null,
      "tx_dtmemo": null,
      "invoice_id": null,
      "cancelable": false,
      "bank_detail": null
    },
    {
      "id": "b12b7ec6-0162-4381-a90d-270a6abc5cc2",
      "sub_account": {
        "id": "47fbf0b6-04ff-4843-ba9f-7163815fb6e1",
        "title": "Main Account"
      },
      "type": "Withdraw",
      "asset": "USDT_BNB",
      "asset_ticker": "USDT",
      "chain": {
        "id": "BNB",
        "title": "Binance Coin",
        "ticker": "BNB",
        "token_type": null
      },
      "amount": 1500.00000000,
      "amount_in_usd": 1500.00,
      "network_fee": 0.000055786500000000,
      "nett": -1500.000055786500000000,
      "fees": {
        "sweep_fee": 0.000000000000000000,
        "refill_fee": 0.000023100000000000,
        "withdrawal_fee": 0.000032686500000000
      },
      "hash": "0x8eefa61e0362f37f7760d87253febf479aef4c72faeaeb1121996eb585dc213b",
      "source_type": "Internal",
      "source_id": "0x11c2B67563542da937635bcF4c4639c085A3934a",
      "source_alias": "Invoices for customer 6",
      "dest_type": "External",
      "dest_id": "0xC33bB2A76CA770D9beA3efae82200EaF29C228bd",
      "dest_alias": "Whitelisted Address",
      "dest_outputs": [],
      "memo": "cashout",
      "sequence_id": null,
      "created_on_utc": "2025-03-04T22:50:37Z",
      "created_timestamp_utc": 1741128637,
      "status": "Success",
      "confirmations": {
        "required": 10,
        "actual": 16
      },
      "explorer_url": "https://bscscan.com/tx/0x8eefa61e0362f37f7760d87253febf479aef4c72faeaeb1121996eb585dc213b",
      "last_updated_on_utc": "2025-03-04T23:18:47Z",
      "last_updated_timestamp_utc": 1741130327,
      "tx_key": null,
      "failure_reason": null,
      "approvals": {
        "required": 1,
        "confirmed": 1,
        "users": [
          {
            "first_name": "Jane",
            "last_name": "Doe",
            "role": "Owner",
            "approval_status": "Approved",
            "updated_on": 1741128739
          }
        ]
      },
      "aml": {
        "cid": "0",
        "risk_score": "LOW",
        "ca_payload": []
      },
      "created_by": {
        "name": "Jane Doe",
        "email": "jane.doe@example.com"
      },
      "cancelled_by": null,
      "tx_dtmemo": "",
      "invoice_id": "",
      "cancelable": false,
      "bank_detail": null
    },
    {
      "id": "f657ff64-7270-4797-8726-8dffc40090b0",
      "sub_account": {
        "id": "47fbf0b6-04ff-4843-ba9f-7163815fb6e1",
        "title": "Main Account"
      },
      "type": "Sweep",
      "asset": "USDT_BNB",
      "asset_ticker": "USDT",
      "chain": {
        "id": "BNB",
        "title": "Binance Coin",
        "ticker": "BNB",
        "token_type": null
      },
      "amount": 3100.00000000,
      "amount_in_usd": 3100.00,
      "network_fee": 0.000001634325000000,
      "nett": 0.0,
      "fees": null,
      "hash": "0x96a9fb8a875e96e324f850a70bbb624ae1cf1c10904e43f5602a1acad2b0a995",
      "source_type": "Internal",
      "source_id": "0xa54171d2f69039257f546a38efe09078093835ce",
      "source_alias": "Invoices for customer 2",
      "dest_type": "Internal",
      "dest_id": "0xfaf403c12bde4d81c9b47db273ab3bb4e80e9df2",
      "dest_alias": "Main Address",
      "dest_outputs": [],
      "memo": null,
      "sequence_id": "",
      "created_on_utc": "2025-12-12T12:53:13Z",
      "created_timestamp_utc": 1765543993,
      "status": "Success",
      "confirmations": {
        "required": 10,
        "actual": 102
      },
      "explorer_url": "https://bscscan.com/tx/0x96a9fb8a875e96e324f850a70bbb624ae1cf1c10904e43f5602a1acad2b0a995",
      "last_updated_on_utc": "2025-12-12T12:53:26Z",
      "last_updated_timestamp_utc": 1765544006,
      "tx_key": "",
      "failure_reason": "",
      "approvals": null,
      "aml": {
        "cid": null,
        "risk_score": null,
        "ca_payload": null
      },
      "created_by": null,
      "cancelled_by": null,
      "tx_dtmemo": "",
      "invoice_id": null,
      "cancelable": false,
      "bank_detail": null
    }
  ]
}

MCP scope: dac.read 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.

Query Parameters

string

Filter by asset ID (e.g. BTC, ETH). Returns transactions for this asset only. Use the id 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.

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 a pagination object and a transactions array.

object

Pagination details for the result set.

Show properties

integer

The current page number.

integer

The maximum number of records per page.

integer

The total number of transactions matching your filters, across all pages.

array

The transactions on this page.

Show properties

string

The Finrock-assigned unique transaction identifier.

object

The sub-account the transaction belongs to, with its id and title.

string

The transaction type, for example Deposit, Withdraw, or Sweep.

string

The asset involved in the transaction (e.g. USDT_BNB).

string

The asset’s ticker symbol (e.g. USDT).

object

The blockchain the transaction ran on, with its id, title, ticker, and token_type.

number

The transaction amount in the asset’s native unit.

number

The transaction amount converted to USD.

number

The network fee paid for the transaction, in the blockchain’s native token.

number

The net effect on your balance. Positive for deposits, negative for withdrawals (amount plus fees), and 0 for sweeps and cancelled transactions.

object | null

A breakdown of fees for withdrawals: sweep_fee, refill_fee, and withdrawal_fee. null for other transaction types.

string | null

The on-chain transaction hash. null if the transaction was never broadcast.

string

The source type of the transaction (Internal or External).

string

The source address.

string | null

The label of the source address, if it has one.

string

The destination type of the transaction (Internal or External).

string

The destination address.

string | null

The label of the destination address, if it has one.

array

Additional destination outputs, if any.

string | null

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

string | null

The sequence identifier of the transaction, if any.

string

ISO 8601 timestamp (UTC) of when the transaction was created.

integer

Unix timestamp of when the transaction was created.

string

Current status of the transaction (e.g. Success, UserCancelled). See Transaction Statuses for possible values.

object

The number of block confirmations required and the actual number received.

string | null

A link to the transaction on a block explorer. null if there is no on-chain hash.

string

ISO 8601 timestamp (UTC) of the last status update.

integer

Unix timestamp of the last status update.

string | null

The transaction key, if any.

string | null

The reason the transaction failed, if it did.

object | null

Approval details for withdrawals that need approval: the number required, the number confirmed, and a users array with each approver’s first_name, last_name, role, approval_status, and updated_on timestamp.

object

AML screening results: cid, risk_score (e.g. LOW), and ca_payload.

object | null

The name and email of the user who created the transaction. null for deposits and sweeps.

object | null

The name, email, and timestamp (ts) of the user who cancelled the transaction, if it was cancelled.

string | null

The destination tag or memo used on the transaction, if any.

string | null

The ID of the invoice linked to the transaction, if any.

boolean

Whether the transaction can still be cancelled.

object | null

Bank details linked to the transaction, if any.

{
  "pagination": {
    "page": 1,
    "limit": 200,
    "total_records": 45
  },
  "transactions": [
    {
      "id": "a9cd7e4c-cb0d-4b90-8196-0b5e070c47c7",
      "sub_account": {
        "id": "47fbf0b6-04ff-4843-ba9f-7163815fb6e1",
        "title": "Main Account"
      },
      "type": "Deposit",
      "asset": "USDT_BNB",
      "asset_ticker": "USDT",
      "chain": {
        "id": "BNB",
        "title": "Binance Coin",
        "ticker": "BNB",
        "token_type": null
      },
      "amount": 500.00000000,
      "amount_in_usd": 499.97,
      "network_fee": 0.000056776500000000,
      "nett": 500.00000000,
      "fees": null,
      "hash": "0x00a1b93349e3e9ffe761125208c5f9b087859ba361a57c5bcade4fe8b6b007ec",
      "source_type": "External",
      "source_id": "0xc3afa8e23f6c0eca0a72930796e96845d3bb5e5a",
      "source_alias": null,
      "dest_type": "Internal",
      "dest_id": "0x11c2b67563542da937635bcf4c4639c085a3934a",
      "dest_alias": "Invoices for customer 6",
      "dest_outputs": [],
      "memo": null,
      "sequence_id": "",
      "created_on_utc": "2024-06-17T18:38:29Z",
      "created_timestamp_utc": 1718649509,
      "status": "Success",
      "confirmations": {
        "required": 10,
        "actual": 102
      },
      "explorer_url": "https://bscscan.com/tx/0x00a1b93349e3e9ffe761125208c5f9b087859ba361a57c5bcade4fe8b6b007ec",
      "last_updated_on_utc": "2024-06-17T18:39:12Z",
      "last_updated_timestamp_utc": 1718649552,
      "tx_key": "",
      "failure_reason": "",
      "approvals": null,
      "aml": {
        "cid": null,
        "risk_score": null,
        "ca_payload": null
      },
      "created_by": null,
      "cancelled_by": null,
      "tx_dtmemo": null,
      "invoice_id": null,
      "cancelable": false,
      "bank_detail": null
    },
    {
      "id": "b12b7ec6-0162-4381-a90d-270a6abc5cc2",
      "sub_account": {
        "id": "47fbf0b6-04ff-4843-ba9f-7163815fb6e1",
        "title": "Main Account"
      },
      "type": "Withdraw",
      "asset": "USDT_BNB",
      "asset_ticker": "USDT",
      "chain": {
        "id": "BNB",
        "title": "Binance Coin",
        "ticker": "BNB",
        "token_type": null
      },
      "amount": 1500.00000000,
      "amount_in_usd": 1500.00,
      "network_fee": 0.000055786500000000,
      "nett": -1500.000055786500000000,
      "fees": {
        "sweep_fee": 0.000000000000000000,
        "refill_fee": 0.000023100000000000,
        "withdrawal_fee": 0.000032686500000000
      },
      "hash": "0x8eefa61e0362f37f7760d87253febf479aef4c72faeaeb1121996eb585dc213b",
      "source_type": "Internal",
      "source_id": "0x11c2B67563542da937635bcF4c4639c085A3934a",
      "source_alias": "Invoices for customer 6",
      "dest_type": "External",
      "dest_id": "0xC33bB2A76CA770D9beA3efae82200EaF29C228bd",
      "dest_alias": "Whitelisted Address",
      "dest_outputs": [],
      "memo": "cashout",
      "sequence_id": null,
      "created_on_utc": "2025-03-04T22:50:37Z",
      "created_timestamp_utc": 1741128637,
      "status": "Success",
      "confirmations": {
        "required": 10,
        "actual": 16
      },
      "explorer_url": "https://bscscan.com/tx/0x8eefa61e0362f37f7760d87253febf479aef4c72faeaeb1121996eb585dc213b",
      "last_updated_on_utc": "2025-03-04T23:18:47Z",
      "last_updated_timestamp_utc": 1741130327,
      "tx_key": null,
      "failure_reason": null,
      "approvals": {
        "required": 1,
        "confirmed": 1,
        "users": [
          {
            "first_name": "Jane",
            "last_name": "Doe",
            "role": "Owner",
            "approval_status": "Approved",
            "updated_on": 1741128739
          }
        ]
      },
      "aml": {
        "cid": "0",
        "risk_score": "LOW",
        "ca_payload": []
      },
      "created_by": {
        "name": "Jane Doe",
        "email": "jane.doe@example.com"
      },
      "cancelled_by": null,
      "tx_dtmemo": "",
      "invoice_id": "",
      "cancelable": false,
      "bank_detail": null
    },
    {
      "id": "f657ff64-7270-4797-8726-8dffc40090b0",
      "sub_account": {
        "id": "47fbf0b6-04ff-4843-ba9f-7163815fb6e1",
        "title": "Main Account"
      },
      "type": "Sweep",
      "asset": "USDT_BNB",
      "asset_ticker": "USDT",
      "chain": {
        "id": "BNB",
        "title": "Binance Coin",
        "ticker": "BNB",
        "token_type": null
      },
      "amount": 3100.00000000,
      "amount_in_usd": 3100.00,
      "network_fee": 0.000001634325000000,
      "nett": 0.0,
      "fees": null,
      "hash": "0x96a9fb8a875e96e324f850a70bbb624ae1cf1c10904e43f5602a1acad2b0a995",
      "source_type": "Internal",
      "source_id": "0xa54171d2f69039257f546a38efe09078093835ce",
      "source_alias": "Invoices for customer 2",
      "dest_type": "Internal",
      "dest_id": "0xfaf403c12bde4d81c9b47db273ab3bb4e80e9df2",
      "dest_alias": "Main Address",
      "dest_outputs": [],
      "memo": null,
      "sequence_id": "",
      "created_on_utc": "2025-12-12T12:53:13Z",
      "created_timestamp_utc": 1765543993,
      "status": "Success",
      "confirmations": {
        "required": 10,
        "actual": 102
      },
      "explorer_url": "https://bscscan.com/tx/0x96a9fb8a875e96e324f850a70bbb624ae1cf1c10904e43f5602a1acad2b0a995",
      "last_updated_on_utc": "2025-12-12T12:53:26Z",
      "last_updated_timestamp_utc": 1765544006,
      "tx_key": "",
      "failure_reason": "",
      "approvals": null,
      "aml": {
        "cid": null,
        "risk_score": null,
        "ca_payload": null
      },
      "created_by": null,
      "cancelled_by": null,
      "tx_dtmemo": "",
      "invoice_id": null,
      "cancelable": false,
      "bank_detail": null
    }
  ]
}