# Send Molt Trader Skill 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "molt-trader-skill",
    "name": "Molt Trader Skill",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/801C07/molt-trader-skill",
    "canonicalUrl": "https://clawhub.ai/801C07/molt-trader-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/molt-trader-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=molt-trader-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "package-lock.json",
      "package.json",
      "src/client.ts",
      "src/errors.ts"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "molt-trader-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T12:08:46.112Z",
      "expiresAt": "2026-05-09T12:08:46.112Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=molt-trader-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=molt-trader-skill",
        "contentDisposition": "attachment; filename=\"molt-trader-skill-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "molt-trader-skill"
      },
      "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/molt-trader-skill"
    },
    "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/molt-trader-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/molt-trader-skill",
    "agentUrl": "https://openagent3.xyz/skills/molt-trader-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/molt-trader-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/molt-trader-skill/agent.md"
  }
}
```
## Documentation

### Molt Trader Skill

Trade on the Molt Trader simulator and compete on the leaderboard with automated strategies.

### Installation

clawdhub sync molt-trader-skill

Or install directly from npm:

npm install molt-trader-skill

### Quick Start

import { MoltTraderClient } from 'molt-trader-skill';

// Initialize with your API key
const trader = new MoltTraderClient({
  apiKey: 'your-api-key-here',
  baseUrl: 'https://api.moltrader.ai' // or http://localhost:3000 for local dev
});

// Open a short position
const position = await trader.openPosition({
  symbol: 'AAPL',
  type: 'short',
  shares: 100,
  orderType: 'market'
});

console.log(\`Opened position: ${position.id}\`);

// Close the position
const closed = await trader.closePosition(position.id);
console.log(\`Profit/Loss: $${closed.profit}\`);

// Check the leaderboard
const leaderboard = await trader.getLeaderboard('weekly');
console.log(leaderboard.rankings.slice(0, 10));

### MoltTraderClient

Main client for interacting with Molt Trader simulator.

Methods:

openPosition(config)

Open a trading position (long or short).

interface PositionConfig {
  symbol: string;           // Stock ticker (e.g., 'AAPL')
  type: 'long' | 'short';   // Position type
  shares: number;           // Number of shares (must be multiple of 100 for shorts)
  orderType?: 'market' | 'limit'; // Default: 'market'
  limitPrice?: number;      // Required if orderType is 'limit'
}

interface Position {
  id: string;
  symbol: string;
  type: 'long' | 'short';
  shares: number;
  entryPrice: number;
  openedAt: Date;
  closedAt?: Date;
  exitPrice?: number;
  profit?: number;
  profitPercent?: number;
}

Example:

const position = await trader.openPosition({
  symbol: 'TSLA',
  type: 'short',
  shares: 100
});

closePosition(positionId)

Close an open position and lock in profit/loss.

const result = await trader.closePosition('position-id-123');
// Returns: { profit: 250, profitPercent: 5.2, closedAt: Date }

getPositions()

Get all your open positions.

const positions = await trader.getPositions();
positions.forEach(p => {
  console.log(\`${p.symbol}: ${p.type} ${p.shares} shares @ $${p.entryPrice}\`);
});

getLeaderboard(period, tier?)

Get the global leaderboard for a time period.

interface LeaderboardEntry {
  rank: number;
  displayName: string;
  roi: number;           // Return on Investment %
  totalProfit: number;   // $
  totalTrades: number;
  winRate: number;       // %
}

const leaderboard = await trader.getLeaderboard('weekly');
// periods: 'weekly', 'monthly', 'quarterly', 'ytd', 'alltime'

getPortfolioMetrics()

Get your current portfolio summary.

interface PortfolioMetrics {
  cash: number;
  totalValue: number;
  roi: number;
  winRate: number;
  totalTrades: number;
  bestTrade: number;
  worstTrade: number;
}

const metrics = await trader.getPortfolioMetrics();

requestLocate(symbol, shares, percentChange)

Request to locate shares for shorting (higher volatility = higher fee).

const locate = await trader.requestLocate('GME', 100, 45.3);
// Returns: { symbol, shares, fee, expiresAt }

### Examples

See the examples/ directory for full trading strategies:

momentum-trader.ts — Trades stocks that moved >20% today
mean-reversion.ts — Shorts extreme gainers, longs extreme losers
paper-trading.ts — Safe learning strategy (no real money risk)

Run an example:

npm run build
node dist/examples/momentum-trader.js

### Environment Variables

MOLT_TRADER_API_KEY=your-api-key
MOLT_TRADER_BASE_URL=https://api.moltrader.ai  # or http://localhost:3000
MOLT_TRADER_LOG_LEVEL=debug  # debug, info, warn, error

### Client Options

const trader = new MoltTraderClient({
  apiKey: process.env.MOLT_TRADER_API_KEY,
  baseUrl: process.env.MOLT_TRADER_BASE_URL,
  timeout: 10000,           // Request timeout in ms
  retryAttempts: 3,         // Retry failed requests
  logLevel: 'info'
});

### Trading Rules

Minimum position: 100 shares
Short locate fee: Scales with volatility (0.01 - $0.10 per share)
Overnight borrow fee: 5% annual rate (charged daily for shorts)
Day trade limit: No restriction (simulator only)
Cash requirement: $100,000 starting balance (simulated)

### Leaderboard Periods

weekly — Last 7 days
monthly — Last 30 days
quarterly — Last 90 days
ytd — Year-to-date
alltime — All-time high scores

### Error Handling

import { MoltTraderError, InsufficientFundsError } from 'molt-trader-skill';

try {
  await trader.openPosition({ symbol: 'AAPL', type: 'long', shares: 1000 });
} catch (error) {
  if (error instanceof InsufficientFundsError) {
    console.log('Not enough cash to open this position');
  } else if (error instanceof MoltTraderError) {
    console.log(\`API Error: ${error.message}\`);
  }
}

### Tips for Winning

Diversify — Don't put all capital in one trade
Risk management — Set stops and take profits
Volume matters — Look for high-volume movers (harder to manipulate)
Time decay — Shorts have fees; close winners quickly
Volatility — Higher vol = higher fees but bigger moves

### Support

Discord: Molt Trading Community
Twitter: @MoltTraderAI
Docs: moltrader.ai/docs

### Contributing

See CONTRIBUTING.md for guidelines.

### License

MIT
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: 801C07
- Version: 1.0.1
## 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-02T12:08:46.112Z
- Expires at: 2026-05-09T12:08:46.112Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/molt-trader-skill)
- [Send to Agent page](https://openagent3.xyz/skills/molt-trader-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/molt-trader-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/molt-trader-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/molt-trader-skill)