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) → INLINECODE2
Find products → INLINECODE3
Get Product details → INLINECODE4
Check Wallet balance → python balance.py (shows all tokens)
Buy product → INLINECODE6
Check order → INLINECODE7
List orders → INLINECODE8
Swap tokens → python swap.py SOL USDC 5 (min $5)
Get swap quote → INLINECODE10
List wallet tokens → INLINECODE11
All commands run from scripts/ folder. API key loads automatically from credentials.json.
Setup (one-time)
CODEBLOCK0
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 | INLINECODE15 |
| 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
- 1. No credentials? →
get_api_key.py (creates wallet + API key) - No balance? → Fund wallet address shown by INLINECODE26
- Ready to buy → INLINECODE27
Errors
| Error | Fix |
|---|
| INLINECODE28 | Fund wallet (balance.py shows address) |
| INLINECODE30 |
Run
get_api_key.py |
|
OUT_OF_STOCK | Search for alternatives |
|
OVER_LIMIT | Max $1,500 per order |
Credentials (credentials.json)
CODEBLOCK1
Never share the API key.
Scout 🛒
使用USDC从Amazon和Shopify购物。通过Jupiter兑换代币。仅限美国境内配送。
展示商品（重要！）
搜索结果： 对于每个推荐商品，将图片作为实际媒体（而非Markdown链接）发送，商品详情作为标题。每条消息只发送一个商品，以确保图片正确渲染。
商品详情： 展示详情时，将图片作为媒体附件与文本一同发送。API会在同一响应中返回图片——请立即使用，不要让用户再次请求。
原因： Markdown图片链接（
）在Telegram/消息平台上无法渲染。请始终使用带有media参数的消息工具将图片作为实际媒体发送，或通过内联方式（如果支持）。
快速参考
设置（一次性） → python getapikey.py --email ... --address ...
查找商品 → python search.py 50美元以下的游戏鼠标
获取商品详情 → python product.py amazon:B07GBZ4Q68
查看钱包余额 → python balance.py（显示所有代币）
购买商品 → python buy.py amazon:B07GBZ4Q68
查看订单 → python orderstatus.py ordabc123
列出订单 → python order_status.py --list
兑换代币 → python swap.py SOL USDC 5（最低5美元）
获取兑换报价 → python swap.py --quote SOL USDC 5
列出钱包代币 → python swap.py --list
所有命令从scripts/文件夹运行。API密钥从credentials.json自动加载。
设置（一次性）
bash
python getapikey.py --email <邮箱> --address <姓名>,<街道>,<城市>,<州>,<邮编>,<国家>
创建一个Crossmint钱包 + API密钥，并将其存储在credentials.json中。向钱包充值USDC即可购买。
确保API密钥安全——它授权从您的钱包进行交易。
命令
| 命令 | 用法 |
|---|
| 搜索 | python search.py 查询 |
| 详情 |
python product.py amazon:B07GBZ4Q68 |
| 余额 | python balance.py（所有代币）或 balance.py --usdc |
| 购买 | python buy.py amazon:B07GBZ4Q68 |
| 订单 | python order
status.py --list 或 orderstatus.py <订单ID> |
| 兑换 | python swap.py SOL USDC 5（最低5美元，免Gas费） |
| 报价 | python swap.py --quote SOL USDC 5 |
| 代币 | python swap.py --list |
支持的代币： SOL、USDC、USDT、BONK、TRUST——或直接使用任何铸币地址。
工作流程
- 1. 没有凭证？ → getapikey.py（创建钱包 + API密钥）
- 没有余额？ → 向balance.py显示的钱包地址充值
- 准备购买 → buy.py <定位器>
错误
| 错误 | 解决方法 |
|---|
| INSUFFICIENTBALANCE | 充值钱包（balance.py显示地址） |
| No API key found |
运行getapi_key.py |
| OUT
OFSTOCK | 搜索替代商品 |
| OVER_LIMIT | 每笔订单最高1,500美元 |
凭证（credentials.json）
json
{
apikey: scoutsk_...,
wallet_address: FtbC9x5...,
shipping_profile: { email: ..., address: ... }
}
切勿分享API密钥。
