Actions12
Overview
This node integrates with the Soroswap decentralized exchange (DEX) on the Stellar network, enabling users to interact programmatically with various Soroswap features. It supports multiple operations such as retrieving asset lists, getting trading quotes, managing liquidity pools, sending transactions, and fetching user positions.
A common use case is automating DeFi workflows on Stellar, for example:
- Fetching updated asset metadata or prices before executing trades.
- Building and sending token swap transactions based on dynamic market data.
- Managing liquidity by adding or removing tokens from pools.
- Querying user liquidity positions for portfolio tracking.
Specifically, the "Get Asset Lists" operation retrieves metadata about predefined asset lists available on Soroswap, filtered optionally by a specific list name.
Properties
| Name | Meaning |
|---|---|
| Network | Selects the Stellar network to operate on: Mainnet or Testnet. |
| Asset List Name | Specifies which asset list to retrieve. Options: All, Aqua, Lobstr, Soroswap, Stellar Expert. An empty value means all assets. |
Output
The output JSON contains the asset list metadata retrieved from Soroswap's API. This typically includes details such as asset codes, issuers, names, and other relevant metadata describing each asset in the selected list.
The output structure is an array or object representing the asset list(s), depending on the chosen option. Each item corresponds to an asset entry with its associated metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for Soroswap's API.
- Uses the Soroswap SDK (
@soroswap/sdk) to communicate with the Soroswap backend. - Needs network connectivity to Soroswap's API endpoints.
- The node configuration must include valid credentials containing the API key and base URL for Soroswap.
Troubleshooting
Common issues:
- Invalid or missing API key credential will cause authentication failures.
- Selecting an unsupported or misspelled asset list name may result in empty or error responses.
- Network connectivity problems can prevent successful API calls.
Error messages:
"Unknown operation: ..."indicates an invalid operation parameter; ensure "Get Asset Lists" is correctly specified.- API errors returned from Soroswap are propagated; check the error message for details like rate limits or invalid parameters.
- If the node fails without continuing on fail enabled, verify credentials and input parameters.
Resolutions:
- Confirm that the API key credential is properly configured and active.
- Use one of the predefined asset list names exactly as listed.
- Enable "Continue On Fail" in the node settings to handle intermittent API errors gracefully.