HIFI Developer Docs

List all batch crypto transfers

curl --request GET \
  --url https://production.hifibridge.com/v2/wallets/transfers/batches \
  --header 'Authorization: Bearer <token>'

{
  "count": 1,
  "records": [
    {
      "transferType": "WALLET.TRANSFER.BATCH",
      "transferDetails": {
        "id": "a671d42d-9417-4bb3-868e-06c868d0d4b8",
        "requestId": "d2189ddd-2d32-4a46-9421-d25ebf602e6c",
        "createdAt": "2025-04-05T14:01:09.785Z",
        "updatedAt": "2025-04-05T14:01:37.708Z",
        "chain": "POLYGON",
        "currency": "usdc",
        "contractAddress": "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582",
        "status": "COMPLETED",
        "failedReason": null,
        "source": {
          "userId": "a1f70737-3844-4782-a321-ad481108a8ec",
          "walletAddress": "0xAFD59de44048D33d964f720ec2Dec3465D8D887D",
          "walletType": "INDIVIDUAL"
        },
        "destination": {
          "batch": [
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            },
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            },
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            },
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            },
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            }
          ]
        },
        "receipt": {
          "transactionHash": "0xeef52c844f72f41717f025b160a8e6b34ebcd22ea77b5e70fd6ab4c5a42e98af",
          "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac"
        }
      }
    }
  ],
  "nextCursor": "2025-04-05T14:01:09.785Z"
}

GET

wallets

transfers

batches

List all batch crypto transfers

curl --request GET \
  --url https://production.hifibridge.com/v2/wallets/transfers/batches \
  --header 'Authorization: Bearer <token>'

{
  "count": 1,
  "records": [
    {
      "transferType": "WALLET.TRANSFER.BATCH",
      "transferDetails": {
        "id": "a671d42d-9417-4bb3-868e-06c868d0d4b8",
        "requestId": "d2189ddd-2d32-4a46-9421-d25ebf602e6c",
        "createdAt": "2025-04-05T14:01:09.785Z",
        "updatedAt": "2025-04-05T14:01:37.708Z",
        "chain": "POLYGON",
        "currency": "usdc",
        "contractAddress": "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582",
        "status": "COMPLETED",
        "failedReason": null,
        "source": {
          "userId": "a1f70737-3844-4782-a321-ad481108a8ec",
          "walletAddress": "0xAFD59de44048D33d964f720ec2Dec3465D8D887D",
          "walletType": "INDIVIDUAL"
        },
        "destination": {
          "batch": [
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            },
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            },
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            },
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            },
            {
              "amount": "0.01",
              "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
            }
          ]
        },
        "receipt": {
          "transactionHash": "0xeef52c844f72f41717f025b160a8e6b34ebcd22ea77b5e70fd6ab4c5a42e98af",
          "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac"
        }
      }
    }
  ],
  "nextCursor": "2025-04-05T14:01:09.785Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

userId

string

The user ID.

limit

string

default to 10, maximum to 100

createdBefore

string<date>

ISO format: YYYY-MM-DD

createdAfter

string<date>

ISO format: YYYY-MM-DD

Response

Success

count

integer

required

Example:

1

records

object[]

required

Show child attributes

records.transferType

string

required

Example:

"WALLET.TRANSFER.BATCH"

records.transferDetails

object

required

Show child attributes

records.transferDetails.id

string<uuid>

required

Example:

"a671d42d-9417-4bb3-868e-06c868d0d4b8"

records.transferDetails.requestId

string<uuid>

required

Example:

"d2189ddd-2d32-4a46-9421-d25ebf602e6c"

records.transferDetails.createdAt

string<date-time>

required

Example:

"2025-04-05T14:01:09.785Z"

records.transferDetails.updatedAt

string<date-time>

required

Example:

"2025-04-05T14:01:37.708Z"

records.transferDetails.chain

enum<string>

required

Available options:

POLYGON

Example:

"POLYGON"

records.transferDetails.currency

enum<string>

required

Available options:

usdc

Example:

"usdc"

records.transferDetails.contractAddress

string

required

Example:

"0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582"

records.transferDetails.status

enum<string>

required

Available options:

NOT_INITIATED,

CREATED,

INITIATED,

PENDING,

COMPLETED,

FAILED,

UNKNOWN

Example:

"COMPLETED"

records.transferDetails.source

object

required

Show child attributes

records.transferDetails.source.userId

string<uuid>

required

Example:

"a1f70737-3844-4782-a321-ad481108a8ec"

records.transferDetails.source.walletAddress

string

required

Example:

"0xAFD59de44048D33d964f720ec2Dec3465D8D887D"

records.transferDetails.source.walletType

enum<string>

required

Available options:

INDIVIDUAL,

BUSINESS

Example:

"INDIVIDUAL"

records.transferDetails.destination

object

required

Show child attributes

records.transferDetails.destination.batch

object[]

required

Maximum array length: 50

Show child attributes

records.transferDetails.destination.batch.amount

string

required

Example:

"0.01"

records.transferDetails.destination.batch.userId

string<uuid>

Example:

"a1f70737-3844-4782-a321-ad481108a8ec"

records.transferDetails.destination.batch.walletAddress

string

Example:

null

records.transferDetails.receipt

object

required

Show child attributes

records.transferDetails.receipt.transactionHash

string

required

Example:

"0xeef52c844f72f41717f025b160a8e6b34ebcd22ea77b5e70fd6ab4c5a42e98af"

records.transferDetails.receipt.userOpHash

string

Example:

"0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac"

records.transferDetails.receipt.approval

object

Show child attributes

records.transferDetails.receipt.approval.id

string<uuid>

Example:

"006737ca-42d5-4780-b3c2-aeb63279c591"

records.transferDetails.receipt.approval.status

string

Example:

"PENDING"

records.transferDetails.receipt.approval.createdAt

string<date-time>

Example:

"2025-02-03T16:11:36.654998+00:00"

records.transferDetails.receipt.approval.updatedAt

string<date-time>

Example:

"2025-02-03T16:12:41.503+00:00"

records.transferDetails.receipt.approval.transferId

string<uuid>

Example:

"006737ca-42d5-4780-b3c2-aeb63279c591"

records.transferDetails.receipt.approval.transferType

string

Example:

"WALLET.TRANSFER.BATCH"

records.transferDetails.receipt.approval.fromDashboard

boolean

Example:

true

records.transferDetails.receipt.approval.initiatorProfileId

string<uuid>

Example:

"aec66b02-4f3f-471c-839a-94820b36abb2"

records.transferDetails.receipt.approval.votes

object[]

Array of approval votes (only present when status is PENDING_APPROVAL or REJECTED)

Show child attributes

records.transferDetails.receipt.approval.votes.approverId

string<uuid>

Example:

"aec66b02-4f3f-471c-839a-94820b36abb2"

records.transferDetails.receipt.approval.votes.vote

enum<string>

Available options:

APPROVE,

REJECT

Example:

"REJECT"

records.transferDetails.receipt.approval.votes.comment

string

Example:

"Transfer amount exceeds daily limit"

records.transferDetails.receipt.approval.votes.createdAt

string<date-time>

Example:

"2025-02-03T16:12:41.503+00:00"

records.transferDetails.failedReason

string | null

Example:

null

nextCursor

string<date-time>

required

Example:

"2025-04-05T14:01:09.785Z"

Retrieve a crypto transfer

Retrieve a batch crypto transfer

⌘I

Overview

Endpoints

List all batch crypto transfers

Authorizations

Query Parameters

Response