Skip to content

New pending cryptocurrency deposit

SEND Server to Client on wss://api.valr.com/ws/account

Sent when an incoming cryptocurrency deposit is detected on the blockchain but has not yet been confirmed. Includes the transaction hash, amount, and confirmation count.

Authentication

This operation requires API key authentication (HMAC-SHA512 via query parameters or in-band AUTHENTICATE message).

Message

Event type: NEW_PENDING_RECEIVE

Payload Schema

PropertyTypeRequiredDescription
currencystringYes-
receiveAddressstringYes-
transactionHashstringYes-
amountstringYes-
createdAtstringYes-
confirmationsinteger (int32)Yes-
confirmedbooleanYes-
confirmedAtstringNo-

Example

json
"{\n    \"type\": \"NEW_PENDING_RECEIVE\",\n    \"data\": {\n        \"currency\": \"BTC\",\n        \"receiveAddress\": \"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh\",\n        \"transactionHash\": \"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2\",\n        \"amount\": \"0.50000000\",\n        \"createdAt\": \"2024-09-27T12:00:00.000Z\",\n        \"confirmations\": 1,\n        \"confirmed\": false,\n        \"confirmedAt\": null\n    }\n}"

Channel

Channel: account Address: wss://api.valr.com/ws/account