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