HIFI Developer Docs

Create a batch crypto transfer

curl --request POST \
  --url https://production.hifibridge.com/v2/wallets/transfers/batches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "123e4567-e89b-12d3-a456-426614174000",
  "currency": "usdc",
  "chain": "POLYGON",
  "source": {
    "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
  },
  "destination": {
    "batch": [
      {
        "amount": "0.01",
        "userId": "a1f70737-3844-4782-a321-ad481108a8ec",
        "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
      }
    ]
  },
  "requireApproval": false
}
'

{
  "transferType": "WALLET.TRANSFER.BATCH",
  "transferDetails": {
    "id": "879af7af-67bf-469f-b718-d262a39d4857",
    "requestId": "14a84906-b72e-4847-b34d-51b9048fa6a5",
    "createdAt": "2025-04-05T00:55:50.609Z",
    "updatedAt": "2025-04-05T00:56:33.236Z",
    "chain": "POLYGON",
    "currency": "usdc",
    "contractAddress": "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582",
    "status": "COMPLETED",
    "source": {
      "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be",
      "walletAddress": "0x99a8c5ED386d217BC6ff0AA1b3585606D475432B",
      "walletType": "INDIVIDUAL"
    },
    "destination": {
      "batch": [
        {
          "amount": "0.04",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.05",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.06",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.03",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.03",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        }
      ]
    },
    "receipt": {
      "transactionHash": "0x57f0cd3429ea425d982882243428ef4a1eda5f1be2157c1b34ea48b49b24fe7f",
      "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac"
    }
  }
}

POST

wallets

transfers

batches

Create a batch crypto transfer

curl --request POST \
  --url https://production.hifibridge.com/v2/wallets/transfers/batches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "123e4567-e89b-12d3-a456-426614174000",
  "currency": "usdc",
  "chain": "POLYGON",
  "source": {
    "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
  },
  "destination": {
    "batch": [
      {
        "amount": "0.01",
        "userId": "a1f70737-3844-4782-a321-ad481108a8ec",
        "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
      }
    ]
  },
  "requireApproval": false
}
'

{
  "transferType": "WALLET.TRANSFER.BATCH",
  "transferDetails": {
    "id": "879af7af-67bf-469f-b718-d262a39d4857",
    "requestId": "14a84906-b72e-4847-b34d-51b9048fa6a5",
    "createdAt": "2025-04-05T00:55:50.609Z",
    "updatedAt": "2025-04-05T00:56:33.236Z",
    "chain": "POLYGON",
    "currency": "usdc",
    "contractAddress": "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582",
    "status": "COMPLETED",
    "source": {
      "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be",
      "walletAddress": "0x99a8c5ED386d217BC6ff0AA1b3585606D475432B",
      "walletType": "INDIVIDUAL"
    },
    "destination": {
      "batch": [
        {
          "amount": "0.04",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.05",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.06",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.03",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.03",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        }
      ]
    },
    "receipt": {
      "transactionHash": "0x57f0cd3429ea425d982882243428ef4a1eda5f1be2157c1b34ea48b49b24fe7f",
      "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac"
    }
  }
}

Authorizations

Authorization

string

header

required

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

Body

application/json

requestId

string<uuid>

required

Example:

"123e4567-e89b-12d3-a456-426614174000"

currency

enum<string>

required

Available options:

usdc

Example:

"usdc"

chain

enum<string>

required

Available options:

POLYGON

Example:

"POLYGON"

source

object

required

Show child attributes

source.userId

string<uuid>

required

Example:

"a1f70737-3844-4782-a321-ad481108a8ec"

destination

object

required

Show child attributes

destination.batch

object[]

required

Maximum array length: 50

Show child attributes

destination.batch.amount

string

required

Example:

"0.01"

destination.batch.userId

string<uuid>

Example:

"a1f70737-3844-4782-a321-ad481108a8ec"

destination.batch.walletAddress

string

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

requireApproval

boolean

default:false

Whether this batch transfer requires approval before processing.

true: Transfer will enter approval workflow
false or omitted: Transfer proceeds immediately

Example:

false

Response

Success

transferType

string

required

Example:

"WALLET.TRANSFER.BATCH"

transferDetails

object

required

Show child attributes

transferDetails.id

string<uuid>

required

Example:

"879af7af-67bf-469f-b718-d262a39d4857"

transferDetails.requestId

string<uuid>

required

Example:

"14a84906-b72e-4847-b34d-51b9048fa6a5"

transferDetails.createdAt

string<date-time>

required

Example:

"2025-04-05T00:55:50.609Z"

transferDetails.updatedAt

string<date-time>

required

Example:

"2025-04-05T00:56:33.236Z"

transferDetails.chain

enum<string>

required

Available options:

POLYGON

Example:

"POLYGON"

transferDetails.currency

enum<string>

required

Available options:

usdc

Example:

"usdc"

transferDetails.contractAddress

string

required

Example:

"0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582"

transferDetails.status

enum<string>

required

Available options:

NOT_INITIATED,

CREATED,

INITIATED,

PENDING,

COMPLETED,

FAILED,

UNKNOWN

Example:

"COMPLETED"

transferDetails.source

object

required

Show child attributes

transferDetails.source.userId

string<uuid>

required

Example:

"6a13bd30-b3a3-4d44-af33-0b32e58261be"

transferDetails.source.walletAddress

string

required

Example:

"0x99a8c5ED386d217BC6ff0AA1b3585606D475432B"

transferDetails.source.walletType

enum<string>

required

Available options:

INDIVIDUAL,

BUSINESS

Example:

"INDIVIDUAL"

transferDetails.destination

object

required

Show child attributes

transferDetails.destination.batch

object[]

required

Maximum array length: 50

Show child attributes

transferDetails.destination.batch.amount

string

required

Example:

"0.04"

transferDetails.destination.batch.userId

string<uuid>

Example:

"6a13bd30-b3a3-4d44-af33-0b32e58261be"

transferDetails.receipt

object

required

Show child attributes

transferDetails.receipt.transactionHash

string

required

Example:

"0x57f0cd3429ea425d982882243428ef4a1eda5f1be2157c1b34ea48b49b24fe7f"

transferDetails.receipt.userOpHash

string

Example:

"0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac"

transferDetails.receipt.approval

object

Show child attributes

transferDetails.receipt.approval.id

string<uuid>

Example:

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

transferDetails.receipt.approval.status

string

Example:

"PENDING"

transferDetails.receipt.approval.createdAt

string<date-time>

Example:

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

transferDetails.receipt.approval.updatedAt

string<date-time>

Example:

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

transferDetails.receipt.approval.transferId

string<uuid>

Example:

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

transferDetails.receipt.approval.transferType

string

Example:

"WALLET.TRANSFER.BATCH"

transferDetails.receipt.approval.fromDashboard

boolean

Example:

true

transferDetails.receipt.approval.initiatorProfileId

string<uuid>

Example:

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

transferDetails.receipt.approval.votes

object[]

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

Show child attributes

transferDetails.receipt.approval.votes.approverId

string<uuid>

Example:

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

transferDetails.receipt.approval.votes.vote

enum<string>

Available options:

APPROVE,

REJECT

Example:

"REJECT"

transferDetails.receipt.approval.votes.comment

string

Example:

"Transfer amount exceeds daily limit"

transferDetails.receipt.approval.votes.createdAt

string<date-time>

Example:

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

Create a crypto transfer

List all bridging requests

⌘I

Overview

Endpoints

Create a batch crypto transfer

Authorizations

Body

Response