# Send Universal Trading to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "universal-trading",
    "name": "Universal Trading",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/0xMomo-NGClubs/universal-trading",
    "canonicalUrl": "https://clawhub.ai/0xMomo-NGClubs/universal-trading",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/universal-trading",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=universal-trading",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "agents/openai.yaml",
      "references/api.md",
      "references/env-setup.md",
      "references/examples.md",
      "scripts/bind-invitation.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "universal-trading",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T12:12:24.342Z",
      "expiresAt": "2026-05-17T12:12:24.342Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=universal-trading",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=universal-trading",
        "contentDisposition": "attachment; filename=\"universal-trading-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "universal-trading"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/universal-trading"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/universal-trading",
    "downloadUrl": "https://openagent3.xyz/downloads/universal-trading",
    "agentUrl": "https://openagent3.xyz/skills/universal-trading/agent",
    "manifestUrl": "https://openagent3.xyz/skills/universal-trading/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/universal-trading/agent.md"
  }
}
```
## Documentation

### Universal Trading

Execute cross-chain trades with the official Particle Network universal-account-example project.

### First-Use Auto Initialization (Default)

When users install this skill and start using it for the first time, auto-run initialization by default.

Use this decision flow:

If universal-account-example/.env already exists, treat environment as initialized and continue to trading tasks.
If not initialized, run from any directory:

bash {baseDir}/scripts/init.sh new

If user explicitly wants to import an existing wallet, run:

bash {baseDir}/scripts/init.sh import <YOUR_PRIVATE_KEY>

After initialization, explicitly tell users:

private key is stored at universal-account-example/.env under PRIVATE_KEY
they can use this wallet in the UniversalX frontend:
https://universalx.app -> 创建钱包 -> 导入现有钱包

By default, setup auto-binds invite code 666666 after .env is created.
It also patches examples/buy-evm.ts to remove usePrimaryTokens restriction.

Optional flags:

# Use existing repo path
bash {baseDir}/scripts/init.sh new --target /path/to/universal-account-example

# Skip smoke test
bash {baseDir}/scripts/init.sh new --skip-smoke

# Disable invite auto-bind
DISABLE_AUTO_INVITE_BIND=1 bash {baseDir}/scripts/init.sh new

### Available Operations

Use scripts inside universal-account-example/examples:

Buy token: buy-solana.ts, buy-evm.ts
Sell token: sell-solana.ts, sell-evm.ts
Convert (swap): convert-solana.ts, convert-evm.ts, 7702-convert-evm.ts
Transfer: transfer-solana.ts, transfer-evm.ts
Custom transaction calls: custom-transaction-*
Balance and history: get-primary-asset.ts, get-transactions.ts
Real-time monitoring: transaction-status-wss.ts, user-assets-wss.ts

For buy operations that need explicit slippage control, use:

scripts/buy-with-slippage.sh (fixed slippage or dynamic retry)

### Trade Status Follow-Up (Required)

After any sendTransaction, do not stop at "transaction submitted".
Always return final outcome to user:

Capture and show transactionId.
Poll status until success or failure:

cd /path/to/universal-account-example
bash {baseDir}/scripts/check-transaction.sh <TRANSACTION_ID> --max-attempts 30 --interval-sec 2

Reply with one of:

SUCCESS (confirmed)
FAILED (failed on-chain/executor)
PENDING (not finalized before timeout, include explorer link)

### Trade Configuration

OptionDescriptionExampleslippageBpsSlippage tolerance (100 = 1%)100universalGasUse PARTI token for gastrueusePrimaryTokensRestrict source/fee primary tokens. Default: do not set (auto select).[SUPPORTED_TOKEN_TYPE.USDT, SUPPORTED_TOKEN_TYPE.USDC]solanaMEVTipAmountJito tip for MEV protection (SOL)0.01

### Slippage Controls (Required for Volatile Tokens)

Allow users to choose one of these modes before buy:

Fixed slippage only:

cd /path/to/universal-account-example
bash {baseDir}/scripts/buy-with-slippage.sh \\
  --chain bsc \\
  --token-address 0x0000000000000000000000000000000000000000 \\
  --amount-usd 5 \\
  --slippage-bps 300

Dynamic slippage + auto retry:

cd /path/to/universal-account-example
bash {baseDir}/scripts/buy-with-slippage.sh \\
  --chain bsc \\
  --token-address 0x0000000000000000000000000000000000000000 \\
  --amount-usd 5 \\
  --slippage-bps 300 \\
  --dynamic-slippage \\
  --retry-slippages 300,500,800,1200

Solana custom tip (anti-MEV) + retry tips:

cd /path/to/universal-account-example
bash {baseDir}/scripts/buy-with-slippage.sh \\
  --chain solana \\
  --token-address 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN \\
  --amount-usd 5 \\
  --slippage-bps 300 \\
  --dynamic-slippage \\
  --retry-slippages 300,500,800,1200 \\
  --solana-mev-tip-amount 0.001 \\
  --retry-mev-tips 0.001,0.003,0.005

Reply with:

chosen slippage mode and values
chosen Solana tip settings (if Solana)
final status (SUCCESS / FAILED / PENDING)
transactionId and explorer URL when available

### Supported Chains

Solana: CHAIN_ID.SOLANA_MAINNET
EVM: CHAIN_ID.POLYGON, CHAIN_ID.ARBITRUM, CHAIN_ID.OPTIMISM, CHAIN_ID.BSC, CHAIN_ID.ETHEREUM

### Common Token Addresses

SOL (native): 0x0000000000000000000000000000000000000000
USDC (Solana): EPjFWdd5AufqSSFqM7BcEHw3BXmQ9Ce3pq27dUGL7C24
USDT (Solana): Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB

### Safety Checklist

Validate chain, token address, and amount before creating transactions.
Use small size for first live trade.
Wrap sendTransaction in try-catch and log transactionId.
Prefer your own Particle credentials for production workloads.

### Reference Files

Environment Setup
API Reference
Examples
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: 0xMomo-NGClubs
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T12:12:24.342Z
- Expires at: 2026-05-17T12:12:24.342Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/universal-trading)
- [Send to Agent page](https://openagent3.xyz/skills/universal-trading/agent)
- [JSON manifest](https://openagent3.xyz/skills/universal-trading/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/universal-trading/agent.md)
- [Download page](https://openagent3.xyz/downloads/universal-trading)