WAX icon

WAX

Interact with the WAX blockchain

Actions9

Overview

This node interacts with the WAX blockchain to retrieve token balances for specified accounts. It is useful when you want to programmatically check how many tokens a particular WAX account holds, such as querying the balance of WAX tokens or other tokens issued on the WAX blockchain.

Practical examples include:

  • Monitoring user wallet balances in a dApp.
  • Automating balance checks before executing token transfers.
  • Integrating WAX token balance data into dashboards or reports.

Properties

Name Meaning
API Endpoint The URL of the WAX blockchain API endpoint to connect to (default: https://wax.greymass.com).
Account Name The WAX blockchain account name whose token balance you want to retrieve.
Token Contract The smart contract that issues the token (e.g., eosio.token for standard WAX tokens).
Symbol The symbol of the token to query (e.g., WAX).

Output

The node outputs JSON data containing the token balance information for the specified account and token symbol. The exact structure depends on the response from the WAX blockchain API but typically includes fields such as the amount and symbol of the token held by the account.

No binary data output is produced by this operation.

Dependencies

  • Requires access to a WAX blockchain API endpoint (default is https://wax.greymass.com).
  • No explicit external API keys or credentials are mandatory for this operation, but the node supports optional private key credentials for other operations.
  • Network connectivity to the specified API endpoint is necessary.

Troubleshooting

  • Common Issues:

    • Incorrect or misspelled account names will result in errors or empty balances.
    • Using an invalid or unreachable API endpoint will cause connection failures.
    • Querying a token symbol or contract that does not exist on the blockchain will return no balance or an error.

  • Error Messages:

    • Errors related to network connectivity indicate problems reaching the API endpoint; verify the endpoint URL and network status.
    • Errors about missing or invalid parameters suggest required properties like account name or token contract were not set correctly.

  • Resolution Tips:

    • Double-check all input property values for correctness.
    • Ensure the API endpoint is accessible and operational.
    • Confirm the token contract and symbol exist on the WAX blockchain.

Links and References

Discussion