Hercle
WebSocket

Whitelist Address with Params

Sends a request for the whitelisting of a new address with parameters.

Auth:API Key
Tags:
Funding
Addresses
Command Name
WhitelistAddressWithParams

Command Arguments

ClientId
Required
Type:
string
Description:

Custom client ID for tracking (max 36 characters)

Example: "my-client-123"
Name
Required
Type:
string
Description:

Address recognizable custom name

Example: "My XRP Wallet"
Asset
Required
Type:
string
Description:

Asset of the Address (e.g.: "BTC" or "EUR")

Example: "XRP"
Address
Required
Type:
string
Description:

Address

Example: "rN7n7otQDd6FczFgLdlqtyMVrn3z1oQmGX"
AddressParams
Required
Type:
object
Description:

Address parameters (e.g., destination tag, memo, etc.)

Example: {"tag":"123456"}
Network
Required
Type:
string
Description:

Address network

Example: "Ripple"

Command Invocation

Command Arguments Example:
[
  "my-client-123",
  "My XRP Wallet",
  "XRP",
  "rN7n7otQDd6FczFgLdlqtyMVrn3z1oQmGX",
  {
    "tag": "123456"
  },
  "Ripple"
]
Invocation Example:
connection.invoke('WhitelistAddressWithParams', 'my-client-123', 'My XRP Wallet', 'XRP', 'rN7n7otQDd6FczFgLdlqtyMVrn3z1oQmGX', { tag: '123456' }, 'Ripple')

Response Event

Event Name
executionEvents
Subject
account.address.registered
FieldTypeDescription
httpStatusCodenumberStatus code of the request (201: created successfully)
userIdstringUser ID
addressIdstringAddress ID
messagestringOptional message in case of errors or checks failed

Example Response

{
  "data": {
    "httpStatusCode": 201,
    "userId": "user-123",
    "addressId": "zzzz",
    "message": ""
  }
}

Code Examples

const signalR = require('@microsoft/signalr');

const apiKey = 'YOUR_API_KEY_HERE';
const connection = new signalR.HubConnectionBuilder()
  .withUrl('https://publicapi.sandbox.hercle.financial/ExecutionLiveServer/v1', {
    accessTokenFactory: () => apiKey,
  })
  .build();

connection.start()
  .then(() => {
    console.log('Connected to WebSocket');
    
    // Invoke command
    connection.invoke('WhitelistAddressWithParams', "my-client-123", "My XRP Wallet", "XRP", "rN7n7otQDd6FczFgLdlqtyMVrn3z1oQmGX", {"tag":"123456"}, "Ripple")
      .then(() => {
        console.log('Command sent successfully');
      })
      .catch(err => {
        console.error('Command failed:', err);
      });
  })
  .catch(err => {
    console.error('Connection failed:', err);
  });

// Listen for events
connection.on('executionEvents', (data) => {
  console.log('Received event:', data);
});

SignalR API Tester

Test this command in the sandbox environment

Disconnected

Your API key is only used locally and never stored

Event Log

No events yet. Connect and invoke a command to see events.