Jupiter Ultra icon

Jupiter Ultra

Jupiter Ultra API operations
Join our community

Actions6

Overview

This node integrates with the Jupiter Ultra API, a service primarily used for interacting with token swaps and balances on blockchain networks. The "Balances" operation fetches the token balances for a specified wallet address. This is useful in scenarios where users want to monitor or display the current holdings of a wallet, such as portfolio tracking, balance verification before transactions, or integration into dashboards.

Practical examples:

  • A user wants to check all token balances held by their Solana wallet.
  • An application needs to verify if a wallet has sufficient tokens before initiating a swap.
  • Displaying real-time token balances in a DeFi dashboard.

Properties

Name Meaning
Base URL The base URL for the Jupiter Ultra API. Defaults to https://lite-api.jup.ag/ultra/v1.
Address The wallet address to retrieve token balances for. Must be a valid blockchain address.

Output

The output is a JSON object containing the response from the Jupiter Ultra API's balances endpoint for the specified wallet address. This typically includes a list of tokens and their respective balances held by that wallet.

Example structure (simplified):

{
  "tokens": [
    {
      "mint": "tokenMintAddress",
      "balance": "amountInSmallestUnit",
      "decimals": 6,
      "symbol": "TOKEN"
    },
    ...
  ]
}

No binary data is output by this operation.

Dependencies

  • Requires access to the Jupiter Ultra API endpoint.
  • Optionally supports an API key credential for authenticated requests; if provided, it is sent via the x-api-key HTTP header.
  • No additional environment variables are required beyond optional API authentication.

Troubleshooting

  • Invalid wallet address: Ensure the wallet address is correctly formatted and corresponds to the expected blockchain network.
  • API errors or timeouts: Check network connectivity and verify the Base URL is correct and accessible.
  • Authentication issues: If using an API key, ensure it is valid and has the necessary permissions.
  • Empty or missing balances: The wallet may have no tokens or the API might not support the queried tokens; verify the wallet contents independently.
  • Unknown operation error: This node only supports predefined operations; ensure "balances" is selected when using this functionality.

Links and References

Discussion