Scout 🛒
Buy from Amazon & Shopify with USDC. Swap tokens via Jupiter. US shipping only.
Presenting Products (Important!)
Search results: For each recommended product, send the image as actual media (not markdown links) with the product details as the caption. One product per message so images render properly.
Product details: When showing details, send images as media attachments alongside the text. The API returns images in the same response — use them immediately, don't make the user ask.
Why: Markdown image links () don't render on Telegram/messaging platforms. Always send images as actual media using the message tool with media parameter, or via inline if supported.
Quick Reference
Setup (once) → python get_api_key.py --email ... --address "..."
Find products → python search.py "gaming mouse under $50"
Get Product details → python product.py amazon:B07GBZ4Q68
Check Wallet balance → python balance.py (shows all tokens)
Buy product → python buy.py amazon:B07GBZ4Q68
Check order → python order_status.py ord_abc123
List orders → python order_status.py --list
Swap tokens → python swap.py SOL USDC 5 (min $5)
Get swap quote → python swap.py --quote SOL USDC 5
List wallet tokens → python swap.py --list
All commands run from scripts/ folder. API key loads automatically from credentials.json.
Setup (one-time)
python get_api_key.py --email <EMAIL> --address "<NAME>,<STREET>,<CITY>,<STATE>,<ZIP>,<COUNTRY>"
Creates a Crossmint wallet + API key and stores them in credentials.json. Fund the wallet with USDC to buy.
Keep API key secure - it authorizes transactions from your wallet.
Commands
| Command | Usage |
|---|---|
| Search | python search.py "query" |
| Details | python product.py amazon:B07GBZ4Q68 |
| Balance | python balance.py (all tokens) or balance.py --usdc |
| Buy | python buy.py amazon:B07GBZ4Q68 |
| Orders | python order_status.py --list or order_status.py <orderId> |
| Swap | python swap.py SOL USDC 5 (min $5 for gasless) |
| Quote | python swap.py --quote SOL USDC 5 |
| Tokens | python swap.py --list |
Supported tokens: SOL, USDC, USDT, BONK, TRUST — or use any mint address directly.
Workflow
- No credentials? →
get_api_key.py(creates wallet + API key) - No balance? → Fund wallet address shown by
balance.py - Ready to buy →
buy.py <locator>
Errors
| Error | Fix |
|---|---|
INSUFFICIENT_BALANCE | Fund wallet (balance.py shows address) |
No API key found | Run get_api_key.py |
OUT_OF_STOCK | Search for alternatives |
OVER_LIMIT | Max $1,500 per order |
Credentials (credentials.json)
{
"api_key": "scout_sk_...",
"wallet_address": "FtbC9x5...",
"shipping_profile": { "email": "...", "address": "..." }
}
Never share the API key.