v1

latestOpenAPI 3.1.02026-07-241653251.3 MB

Fund

List transactions

You can use the fund_id in the response as the “parent” to query GET /movements?parent_link_id=[fund_id] to view a trail of all movements related to this fund event.

get/fund/transactions

Query parameters

participant_codestring

Participant code of the end customer

fund_assetstring

The asset sent on-chain by the end customer in order to fund an account

deposit_addressstring

The address provided by zerohash that the end customer will send to

fund_idstring

The zerohash-generated unique identifier associated with an executed fund event

pagestring

Filters for a specific page (pagination)

page_sizestring

The number of results returned per page, with a maximum of 50 transactions per page

successstring

Filters transactions by successful status. This is a boolean field, please specify either true or false

deposit_timestamp_gtenumber

Filter for greater than or equal to a given timestamp

deposit_timestamp_gtnumber

Filter for greater than a given timestamp

deposit_timestamp_ltnumber

Filter for less than a given timestamp

deposit_timestamp_ltenumber

Filter for less than or equal to a given timestamp

deposit_intent_idstring

id returned on JWT creation for correlation purposes

reference_idstring

Filter by the client-provided reference ID (set via client_fund_id when creating the RFQ or provided at JWT generation)

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required

Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Response

Successfully retrieved paginated list of fund transactions with optional filters: participant_code, fund_asset, deposit_address, fund_id, success, deposit_timestamp_*, deposit_intent_id, reference_id.

pagenumber

page_sizenumber

total_pagesnumber

Example response

{
  "message": [
    {
      "participant_code": "ABCDEF",
      "fund_asset": "USDC.ETH",
      "deposited_asset": "USDC.ETH",
      "rate": "1",
      "quoted_currency": "USD",
      "source_address": "0xA32A6aA6a3B87b49BeaB01393e2020C3C191CD61",
      "deposit_address": "0xF6C6E7d76Ec47F992aEbF46987879a4E3991a03b",
      "quantity": "100",
      "notional": "100",
      "fund_id": "29e6d7b8-d604-4212-86ee-998fef35505e",
      "fund_timestamp": 1708631671631,
      "deposit_timestamp": 1708631681631,
      "transaction_id": "ec963207-69f4-44d0-9251-2977dda86fcd",
      "account_label": "general",
      "success": true,
      "status_reason": "success",
      "status_reason_code": "DEPOSIT_PROCESSED",
      "reference_id": "ba97133e-ab15-4c86-86c1-86671b8420bc",
      "raw_fee_bps": "1.5",
      "raw_fee_notional": "30",
      "deposit_fee_bps": "1.5",
      "deposit_fee_notional": "30",
      "source": {
        "type": "CUSTODIAL",
        "integration": "coinbase"
      },
      "deposit_fee_type": "tiered",
      "fee_tier_breakdown": [
        {
          "tier": 1,
          "amount_in_tier": "5000",
          "fee_bps": "40",
          "fee_amount": "2.00"
        }
      ]
    }
  ],
  "page": 1,
  "page_size": 50,
  "total_pages": 1
}