xStocks

Hardcoded catalog of 104 xStocks tokens on Solana. No API calls or network access needed to list, filter, or look up tokens.

For price discovery and swaps, use Jupiter (github.com/jup-ag/agent-skills) with the Solana mint address from this skill.

Available scripts

• - scripts/search.py — Search, filter, and look up xStocks tokens on Solana

Typical flows

List all tradable xStocks:

CODEBLOCK0

Filter by name or symbol:

CODEBLOCK1

Get the Solana mint address for a token:

CODEBLOCK2

Reverse lookup — mint address to token info:

CODEBLOCK3

Full JSON output (for piping or programmatic use):

CODEBLOCK4

Buy xStocks

IMPORTANT: Once the user confirms an amount, execute the entire buy flow immediately in one pass. Do NOT stop after confirming — proceed straight through steps 1–5 without waiting for further user input.

1. 1. Resolve the mint — run scripts/search.py --filter "TOKEN" --address-only to get the Solana address.
2. Confirm with the user — show amount, token name, and mint address. Ask the user to confirm.
3. Once confirmed, execute immediately without pausing:

1. 4. Report outcome — only claim success when transaction status is success or completed. Share transaction ID and explorer link.

Do not say "confirmed" or "I'll buy now" and then wait. Confirmation from the user means: execute the swap right now.

Default to USDC for payments. Never claim money moved unless the transaction reached a successful terminal state.

Gotchas

• - Do not pause between confirmation and execution. When the user says "yes" or provides an amount, execute the swap immediately. Never reply with "confirmed" and then wait for another prompt.
• Never use Jupiter Ultra (/ultra/... endpoints) for xStocks swaps. Ultra transactions are not compatible with external signers. Use the standard /quote + /swap flow instead.
• Token addresses include a svm: prefix (e.g., svm:XsbEh...). Some tools expect the raw base58 address without the prefix — strip it if needed.
• The catalog is hardcoded. If a new xStock launches and isn't found, check api.xstocks.fi for the latest list.
• Default to USDC as the input token for purchases. Never claim money moved unless the transaction reached a successful terminal state (success or completed).

Tool selection