---
title: "Funds deposited"
method: POST
path: "wallet.funds_deposited"
---

# Funds deposited

`POST wallet.funds_deposited` (webhook)

Fired when funds are deposited into a wallet.

## Payload

- FundsDepositedWebhookPayload — Payload for the wallet.funds_deposited webhook event.
  - `amount` string, required — The amount transferred, as a stringified bigint.
  - `asset` union, required
    - object — The asset type being transferred.
      - `address` unknown, required
      - `type` 'native-token', required
    - object — The asset type being transferred.
      - `address` string, required
      - `type` 'erc20', required
    - object — The asset type being transferred.
      - `mint` string, required
      - `type` 'spl', required
    - object — The asset type being transferred.
      - `address` string, required
      - `type` 'sac', required
  - `block` BlockInfo, required — Block metadata for a wallet transfer event.
    - `number` number, required — The block number.
    - `timestamp` number, required — The block timestamp.
  - `bridge_metadata` union
    - object — Optional Bridge metadata for custodial wallet deposits.
      - `drain_id` string, required
      - `liquidation_address` string, required — The crypto address of the liquidation address that received the deposit.
      - `liquidation_address_id` string, required
      - `method` 'liquidation_address', required
      - `source_wallet_address` string, required — The address that sent the deposit.
      - `type` 'crypto_deposit', required
    - object — Optional Bridge metadata for custodial wallet deposits.
      - `drain_id` string, required
      - `liquidation_address_id` string, required
      - `method` 'liquidation_address', required
      - `original_transaction_hash` string, required — The original deposit transaction hash that triggered the failed drain.
      - `type` 'refund', required
    - object — Optional Bridge metadata for custodial wallet deposits.
      - `activity_id` string, required
      - `method` 'virtual_account', required
      - `type` 'fiat_deposit', required
      - `virtual_account_id` string, required
    - object — Optional Bridge metadata for custodial wallet deposits.
      - `method` 'transfer', required
      - `source_wallet_address` string, required — The wallet address that sent the transfer.
      - `transfer_id` string, required
      - `type` 'crypto_deposit', required
    - object — Optional Bridge metadata for custodial wallet deposits.
      - `method` 'transfer', required
      - `transfer_id` string, required
      - `type` 'fiat_deposit', required
    - object — Optional Bridge metadata for custodial wallet deposits.
      - `method` 'transfer', required
      - `original_transaction_hash` string — The original transfer transaction hash (if available).
      - `transfer_id` string, required
      - `type` 'refund', required
    - object — Optional Bridge metadata for custodial wallet deposits.
      - `method` 'static_memo', required
      - `static_memo_event_id` string, required
      - `static_memo_id` string, required
      - `type` 'fiat_deposit', required
  - `caip2` string, required — The CAIP-2 chain identifier.
  - `idempotency_key` string, required — A unique key for this event.
  - `recipient` string, required — The recipient address.
  - `sender` string, required — The sender address.
  - `transaction_fee` string — The transaction fee paid, as a stringified bigint in the chain's native token.
  - `transaction_hash` string, required — The blockchain transaction hash.
  - `type` 'wallet.funds_deposited', required — The type of webhook event.
  - `wallet_id` string, required — The ID of the wallet.

## Acknowledgement `200`

Return a 200 status to indicate that the webhook was received successfully.

---

[API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)