{
  "schemaVersion": "1.0",
  "item": {
    "slug": "trade-history",
    "name": "Trade History",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/newbienodes/trade-history",
    "canonicalUrl": "https://clawhub.ai/newbienodes/trade-history",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/trade-history",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=trade-history",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/trade-history"
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/trade-history",
    "agentPageUrl": "https://openagent3.xyz/skills/trade-history/agent",
    "manifestUrl": "https://openagent3.xyz/skills/trade-history/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/trade-history/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Trade History",
        "body": "Read and display recorded trade events from the local trades.jsonl log file, with optional filtering by symbol and configurable limit."
      },
      {
        "title": "When to Use",
        "body": "User asks: \"tampilkan trade history\"\nUser asks: \"trade apa saja yang sudah dicatat?\"\nUser asks: \"recap trade BTC terakhir\"\nUser asks: \"lihat 10 trade terakhir\"\nUser asks: \"ada berapa trade yang tersimpan?\""
      },
      {
        "title": "How It Works",
        "body": "This skill runs a local Python script that:\n\nReads the local trades.jsonl file line by line.\nParses each line as a JSON object.\nFilters by symbol if specified.\nSorts results newest first (reverse chronological).\nReturns up to N records (default 20).\nReturns a JSON object with count and items array."
      },
      {
        "title": "Workflow",
        "body": "Step 1 — Run the read script via bash tool:\npython3 ~/.npm-global/lib/node_modules/openclaw/skills/trade-history/read.py\n\nStep 2 — Parse the JSON output (count + items array).\n\nStep 3 — Present the trade list to the user in a readable format:\n\nShow each trade: symbol, side, entry, sl, tp, note, timestamp\nMention total count\nNewest trades first"
      },
      {
        "title": "Optional Arguments",
        "body": "Run with JSON args to filter or limit results:\npython3 ~/.npm-global/lib/node_modules/openclaw/skills/trade-history/read.py '{\"limit\": 10, \"symbol\": \"BTCUSDT\"}'\n\nSupported args:\n\nlimit: number of trades to return (default 20)\nsymbol: filter by trading pair (e.g. BTCUSDT)"
      },
      {
        "title": "Output Format",
        "body": "{\n\"count\": 3,\n\"items\": [\n{\n\"symbol\": \"BTCUSDT\",\n\"side\": \"BUY\",\n\"entry\": 94500,\n\"sl\": 94000,\n\"tp\": 95500,\n\"note\": \"sweep+fvg signal\",\n\"source\": \"btc-analyzer\",\n\"ts\": \"2026-02-23T00:00:00Z\"\n}\n]\n}"
      },
      {
        "title": "Log File Location",
        "body": "/home/windows_11/.openclaw/polymarket-workspace/trades.jsonl"
      },
      {
        "title": "Error Handling",
        "body": "If log file does not exist yet:\n{\"count\": 0, \"items\": []}\n\nNo error is thrown — returns empty result gracefully."
      },
      {
        "title": "Guardrails",
        "body": "Always run the script — never fabricate trade history.\nIf file is missing, return empty list gracefully without error.\nOutput must be JSON only from the script.\nAlways display newest trades first (reverse chronological order).\nNever delete or modify the log file — read only."
      }
    ],
    "body": "Trade History\n\nRead and display recorded trade events from the local trades.jsonl log file, with optional filtering by symbol and configurable limit.\n\nWhen to Use\nUser asks: \"tampilkan trade history\"\nUser asks: \"trade apa saja yang sudah dicatat?\"\nUser asks: \"recap trade BTC terakhir\"\nUser asks: \"lihat 10 trade terakhir\"\nUser asks: \"ada berapa trade yang tersimpan?\"\nHow It Works\n\nThis skill runs a local Python script that:\n\nReads the local trades.jsonl file line by line.\nParses each line as a JSON object.\nFilters by symbol if specified.\nSorts results newest first (reverse chronological).\nReturns up to N records (default 20).\nReturns a JSON object with count and items array.\nWorkflow\n\nStep 1 — Run the read script via bash tool: python3 ~/.npm-global/lib/node_modules/openclaw/skills/trade-history/read.py\n\nStep 2 — Parse the JSON output (count + items array).\n\nStep 3 — Present the trade list to the user in a readable format:\n\nShow each trade: symbol, side, entry, sl, tp, note, timestamp\nMention total count\nNewest trades first\nOptional Arguments\n\nRun with JSON args to filter or limit results: python3 ~/.npm-global/lib/node_modules/openclaw/skills/trade-history/read.py '{\"limit\": 10, \"symbol\": \"BTCUSDT\"}'\n\nSupported args:\n\nlimit: number of trades to return (default 20)\nsymbol: filter by trading pair (e.g. BTCUSDT)\nOutput Format\n\n{ \"count\": 3, \"items\": [ { \"symbol\": \"BTCUSDT\", \"side\": \"BUY\", \"entry\": 94500, \"sl\": 94000, \"tp\": 95500, \"note\": \"sweep+fvg signal\", \"source\": \"btc-analyzer\", \"ts\": \"2026-02-23T00:00:00Z\" } ] }\n\nLog File Location\n\n/home/windows_11/.openclaw/polymarket-workspace/trades.jsonl\n\nError Handling\n\nIf log file does not exist yet: {\"count\": 0, \"items\": []}\n\nNo error is thrown — returns empty result gracefully.\n\nGuardrails\nAlways run the script — never fabricate trade history.\nIf file is missing, return empty list gracefully without error.\nOutput must be JSON only from the script.\nAlways display newest trades first (reverse chronological order).\nNever delete or modify the log file — read only."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/newbienodes/trade-history",
    "publisherUrl": "https://clawhub.ai/newbienodes/trade-history",
    "owner": "newbienodes",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/trade-history",
    "downloadUrl": "https://openagent3.xyz/downloads/trade-history",
    "agentUrl": "https://openagent3.xyz/skills/trade-history/agent",
    "manifestUrl": "https://openagent3.xyz/skills/trade-history/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/trade-history/agent.md"
  }
}