- Blockchain transfers (stablecoin deposits from supported networks). This includes other HIFI and external wallets.
-
Fiat onramps (local payment methods, e.g. bank transfers, PIX, ACH).
When a User pays in fiat (e.g. USD), it is converted into stablecoin and credited to their wallet.
Blockchain transfers
To track incoming transfers into a Wallet, use the Deposits API. This API provides updates on all incoming activity, including transaction hashes, amounts, and confirmation status. GET/v2/users/{userId}/wallets/deposits
Query Parameters
The deposits API supports several query parameters for filtering and pagination:View all query parameters
View all query parameters
| Parameter | Type | Required | Description | Example | | --------------- |
------ | -------- | --------------------------- |
--------------------------------------- | |
chain
| string | ✅ | Blockchain
network | POLYGON
, ETHEREUM
, SOLANA
, BASE
| | currency
| string | ✅
| Currency type | usdc
, usdt
, usdHifi
| | status
| string | ❌ |
Deposit status | CONFIRMED
, COMPLETED
| | createdAfter
| date | ❌ |
Filter deposits after date | 2024-01-01
| | createdBefore
| date | ❌ |
Filter deposits before date | 2024-12-31
| | limit
| string | ❌ | Number
of results (1-100) | 10
(default), 50
| | minAmount
| number | ❌ |
Minimum deposit amount | 0.01
|Response Format
The API returns a paginated list of deposit records:Deposit Record Fields
Record Information
- userId: ID of the user who owns the wallet
- id: Unique identifier for this deposit record
- createdAt: Timestamp when the deposit was first detected
- updatedAt: Timestamp when the deposit record was last updated
Wallet Information
- wallet.id: Unique identifier for the wallet
- wallet.address: Blockchain address of the wallet
- wallet.chain: Blockchain network (POLYGON, ETHEREUM, etc.)
- wallet.walletType: Type of wallet (INDIVIDUAL, BUSINESS)
Transaction Details
- transactionHash: Blockchain transaction hash
- chain: Blockchain network where the transaction occurred
- currency: Token symbol (usdc, usdt, etc.)
- status: Transaction status (COMPLETED, PENDING, FAILED)
- sourceAddress: Address that sent the funds
- destinationAddress: Address that received the funds
- contractAddress: Smart contract address of the token
- amount: Human-readable amount (e.g., “19” for 19 USDC)
- unitAmount: Raw amount in smallest token unit (e.g., “19000000” for 19 USDC with 6 decimals)
Understanding Amount Fields
Understanding Amount Fields
The
amount
field shows the human-readable value (19 USDC), while
unitAmount
shows the raw blockchain value (19000000). For USDC with 6
decimals: 19 USDC = 19,000,000 units.Fiat onramps
Convert fiat currency to stablecoins using local payment methods like bank transfers, PIX, or ACH. When users pay in fiat (e.g. USD), it’s automatically converted to stablecoin and credited to their wallet.Onramps
Learn how to convert to stablecoinsa