{
  "schemaVersion": "1.0",
  "item": {
    "slug": "taapi",
    "name": "TAAPI CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/oscraters/taapi",
    "canonicalUrl": "https://clawhub.ai/oscraters/taapi",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/taapi",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=taapi",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "agents/openai.yaml",
      "examples/bulk-multi-constructs.json",
      "examples/bulk-single-construct.json",
      "scripts/taapi-agent.sh",
      "tests/smoke-live.sh"
    ],
    "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",
      "slug": "taapi",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-09T16:15:03.031Z",
      "expiresAt": "2026-05-16T16:15:03.031Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=taapi",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=taapi",
        "contentDisposition": "attachment; filename=\"taapi-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "taapi"
      },
      "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/taapi"
    },
    "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/taapi",
    "agentPageUrl": "https://openagent3.xyz/skills/taapi/agent",
    "manifestUrl": "https://openagent3.xyz/skills/taapi/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/taapi/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": "Overview",
        "body": "This skill gives Codex a reliable workflow for TAAPI.IO integrations and analysis tasks. It includes a CLI helper for low-friction, repeatable API calls from agents and scripts.\n\nUse this skill when:\n\nYou need technical indicators (for example rsi, macd, adx) from TAAPI.IO.\nYou need to evaluate one symbol quickly via GET requests.\nYou need batch evaluations in one request using /bulk.\nYou need multi-construct queries across symbols/timeframes/exchanges.\nYou need deterministic shell-based tooling for agent loops."
      },
      {
        "title": "Workflow Decision Tree",
        "body": "If you need one indicator for one market/timeframe, use direct.\nIf you need many indicators in one API call, use bulk.\nIf you need multiple symbol/timeframe constructs in one API call, use multi.\nIf you need non-exchange candles (custom data), this skill documents API expectations but you should create a custom payload and use bulk --payload-file."
      },
      {
        "title": "API Facts (Checked February 27, 2026)",
        "body": "Base host: https://api.taapi.io\nDirect endpoint pattern: GET /{indicator}\nBulk endpoint: POST /bulk\nMandatory direct params: secret, symbol, interval, and exchange for crypto (type=crypto, default).\ntype=stocks is supported for stocks/ETFs.\nCommon optional direct params: backtrack (max 50), results, addResultTimestamp, gaps, chart=heikinashi.\nBulk and rate limit constraints: max 20 calculations per request on standard plans.\nPlan rate limits documented as:\n\nFree: 1 request / 15s\nBasic: 5 requests / 15s\nPro: 30 requests / 15s\nExpert: 75 requests / 15s\n\nPrimary docs:\n\nhttps://taapi.io/documentation/\nhttps://taapi.io/documentation/integration/direct/\nhttps://taapi.io/documentation/integration/post-rest-bulk/\nhttps://taapi.io/documentation/multiple-constructs/\nhttps://taapi.io/documentation/rate-limits/\nhttps://taapi.io/indicators/"
      },
      {
        "title": "Security And Runtime Requirements",
        "body": "This skill is an open-source wrapper around the commercial TAAPI.IO API. Live requests require a TAAPI.IO account secret.\nSet TAAPI_SECRET only in the current shell session. Prefer export TAAPI_SECRET=... over persistent/global shell files, and prefer the env var over --secret so the secret is less exposed in process listings.\ncurl is required for all live requests.\njq is only required for the multi command. direct, bulk, and CI-safe argument tests work without it.\nThe default and audited endpoint is https://api.taapi.io. Overriding TAAPI_BASE_URL is an advanced escape hatch and should only be used deliberately. Sending requests to another host can expose your secret and request payloads to that endpoint.\ntests/smoke-live.sh sends real network requests with your live secret. Use a revocable secret and avoid running it outside an isolated session."
      },
      {
        "title": "Quick Start",
        "body": "Use the local helper:\n\n# 1) Set secret once per session\nexport TAAPI_SECRET=\"your_secret\"\n\n# 2) Direct RSI query\nbash scripts/taapi-agent.sh direct \\\n  --indicator rsi \\\n  --exchange binance \\\n  --symbol BTC/USDT \\\n  --interval 1h\n\n# 3) Bulk query from JSON payload\nbash scripts/taapi-agent.sh bulk --payload-file examples/bulk-single-construct.json\n\n# 4) Multi-construct query (requires jq)\nbash scripts/taapi-agent.sh multi \\\n  --exchange binance \\\n  --symbols BTC/USDT,ETH/USDT \\\n  --intervals 15m,1h \\\n  --indicators rsi,supertrend\n\n# 5) Live smoke tests (requires real TAAPI_SECRET and network access)\nbash tests/smoke-live.sh"
      },
      {
        "title": "direct",
        "body": "Single indicator via GET:\n\nbash scripts/taapi-agent.sh direct \\\n  --indicator macd \\\n  --exchange binance \\\n  --symbol BTC/USDT \\\n  --interval 1h \\\n  --opt backtrack=1 \\\n  --opt addResultTimestamp=true"
      },
      {
        "title": "bulk",
        "body": "POST an explicit bulk payload file to /bulk:\n\nbash scripts/taapi-agent.sh bulk --payload-file examples/bulk-single-construct.json\nbash scripts/taapi-agent.sh bulk --payload-file examples/bulk-multi-constructs.json"
      },
      {
        "title": "multi",
        "body": "Build multi-construct payload from flags (for /bulk). Requires jq:\n\nbash scripts/taapi-agent.sh multi \\\n  --exchange binance \\\n  --symbols BTC/USDT,ETH/USDT \\\n  --intervals 15m,1h \\\n  --indicators rsi,supertrend"
      },
      {
        "title": "Agentic Usage Guidelines",
        "body": "Always pass --json in automation loops for stable machine parsing.\nKeep per-request calculations at <=20; split workloads deterministically.\nHandle 429 with bounded retries and backoff.\nPrefer bulk for multi-indicator evaluations on the same construct.\nPrefer multi for cross-symbol/timeframe batching when plan supports constructs.\nFor stocks, include --type stocks and omit --exchange if not required by your setup.\nTreat TAAPI_BASE_URL overrides as a deliberate deviation from the default OpenClaw-audited path. If you must override it, use a session-scoped TAAPI_ALLOW_UNOFFICIAL_BASE_URL=1 as an explicit acknowledgement."
      },
      {
        "title": "scripts/taapi-agent.sh",
        "body": "Bash CLI with:\n\ndirect GET indicator calls\nbulk POST using payload files\nmulti-construct payload generation\nretries for transient failures and 429 rate limits\nopt-in guardrails for unofficial base URLs\noptional jq formatting, with jq required only for multi"
      },
      {
        "title": "examples/",
        "body": "Ready-to-run payloads:\n\nexamples/bulk-single-construct.json\nexamples/bulk-multi-constructs.json"
      },
      {
        "title": "tests/",
        "body": "tests/test-cli.sh: CI-safe argument and error-path checks (no API call required).\ntests/smoke-live.sh: Live smoke checks using real TAAPI credentials.\n\nCI command:\n\nbash tests/test-cli.sh\n\nLive smoke command:\n\nexport TAAPI_SECRET=\"your_secret\"\nbash tests/smoke-live.sh"
      }
    ],
    "body": "OpenClaw TAAPI Skill\nOverview\n\nThis skill gives Codex a reliable workflow for TAAPI.IO integrations and analysis tasks. It includes a CLI helper for low-friction, repeatable API calls from agents and scripts.\n\nUse this skill when:\n\nYou need technical indicators (for example rsi, macd, adx) from TAAPI.IO.\nYou need to evaluate one symbol quickly via GET requests.\nYou need batch evaluations in one request using /bulk.\nYou need multi-construct queries across symbols/timeframes/exchanges.\nYou need deterministic shell-based tooling for agent loops.\nWorkflow Decision Tree\nIf you need one indicator for one market/timeframe, use direct.\nIf you need many indicators in one API call, use bulk.\nIf you need multiple symbol/timeframe constructs in one API call, use multi.\nIf you need non-exchange candles (custom data), this skill documents API expectations but you should create a custom payload and use bulk --payload-file.\nAPI Facts (Checked February 27, 2026)\nBase host: https://api.taapi.io\nDirect endpoint pattern: GET /{indicator}\nBulk endpoint: POST /bulk\nMandatory direct params: secret, symbol, interval, and exchange for crypto (type=crypto, default).\ntype=stocks is supported for stocks/ETFs.\nCommon optional direct params: backtrack (max 50), results, addResultTimestamp, gaps, chart=heikinashi.\nBulk and rate limit constraints: max 20 calculations per request on standard plans.\nPlan rate limits documented as:\nFree: 1 request / 15s\nBasic: 5 requests / 15s\nPro: 30 requests / 15s\nExpert: 75 requests / 15s\n\nPrimary docs:\n\nhttps://taapi.io/documentation/\nhttps://taapi.io/documentation/integration/direct/\nhttps://taapi.io/documentation/integration/post-rest-bulk/\nhttps://taapi.io/documentation/multiple-constructs/\nhttps://taapi.io/documentation/rate-limits/\nhttps://taapi.io/indicators/\nSecurity And Runtime Requirements\nThis skill is an open-source wrapper around the commercial TAAPI.IO API. Live requests require a TAAPI.IO account secret.\nSet TAAPI_SECRET only in the current shell session. Prefer export TAAPI_SECRET=... over persistent/global shell files, and prefer the env var over --secret so the secret is less exposed in process listings.\ncurl is required for all live requests.\njq is only required for the multi command. direct, bulk, and CI-safe argument tests work without it.\nThe default and audited endpoint is https://api.taapi.io. Overriding TAAPI_BASE_URL is an advanced escape hatch and should only be used deliberately. Sending requests to another host can expose your secret and request payloads to that endpoint.\ntests/smoke-live.sh sends real network requests with your live secret. Use a revocable secret and avoid running it outside an isolated session.\nQuick Start\n\nUse the local helper:\n\n# 1) Set secret once per session\nexport TAAPI_SECRET=\"your_secret\"\n\n# 2) Direct RSI query\nbash scripts/taapi-agent.sh direct \\\n  --indicator rsi \\\n  --exchange binance \\\n  --symbol BTC/USDT \\\n  --interval 1h\n\n# 3) Bulk query from JSON payload\nbash scripts/taapi-agent.sh bulk --payload-file examples/bulk-single-construct.json\n\n# 4) Multi-construct query (requires jq)\nbash scripts/taapi-agent.sh multi \\\n  --exchange binance \\\n  --symbols BTC/USDT,ETH/USDT \\\n  --intervals 15m,1h \\\n  --indicators rsi,supertrend\n\n# 5) Live smoke tests (requires real TAAPI_SECRET and network access)\nbash tests/smoke-live.sh\n\nCLI Tasks\ndirect\n\nSingle indicator via GET:\n\nbash scripts/taapi-agent.sh direct \\\n  --indicator macd \\\n  --exchange binance \\\n  --symbol BTC/USDT \\\n  --interval 1h \\\n  --opt backtrack=1 \\\n  --opt addResultTimestamp=true\n\nbulk\n\nPOST an explicit bulk payload file to /bulk:\n\nbash scripts/taapi-agent.sh bulk --payload-file examples/bulk-single-construct.json\nbash scripts/taapi-agent.sh bulk --payload-file examples/bulk-multi-constructs.json\n\nmulti\n\nBuild multi-construct payload from flags (for /bulk). Requires jq:\n\nbash scripts/taapi-agent.sh multi \\\n  --exchange binance \\\n  --symbols BTC/USDT,ETH/USDT \\\n  --intervals 15m,1h \\\n  --indicators rsi,supertrend\n\nAgentic Usage Guidelines\nAlways pass --json in automation loops for stable machine parsing.\nKeep per-request calculations at <=20; split workloads deterministically.\nHandle 429 with bounded retries and backoff.\nPrefer bulk for multi-indicator evaluations on the same construct.\nPrefer multi for cross-symbol/timeframe batching when plan supports constructs.\nFor stocks, include --type stocks and omit --exchange if not required by your setup.\nTreat TAAPI_BASE_URL overrides as a deliberate deviation from the default OpenClaw-audited path. If you must override it, use a session-scoped TAAPI_ALLOW_UNOFFICIAL_BASE_URL=1 as an explicit acknowledgement.\nResources\nscripts/taapi-agent.sh\n\nBash CLI with:\n\ndirect GET indicator calls\nbulk POST using payload files\nmulti-construct payload generation\nretries for transient failures and 429 rate limits\nopt-in guardrails for unofficial base URLs\noptional jq formatting, with jq required only for multi\nexamples/\n\nReady-to-run payloads:\n\nexamples/bulk-single-construct.json\nexamples/bulk-multi-constructs.json\ntests/\ntests/test-cli.sh: CI-safe argument and error-path checks (no API call required).\ntests/smoke-live.sh: Live smoke checks using real TAAPI credentials.\n\nCI command:\n\nbash tests/test-cli.sh\n\n\nLive smoke command:\n\nexport TAAPI_SECRET=\"your_secret\"\nbash tests/smoke-live.sh"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/oscraters/taapi",
    "publisherUrl": "https://clawhub.ai/oscraters/taapi",
    "owner": "oscraters",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/taapi",
    "downloadUrl": "https://openagent3.xyz/downloads/taapi",
    "agentUrl": "https://openagent3.xyz/skills/taapi/agent",
    "manifestUrl": "https://openagent3.xyz/skills/taapi/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/taapi/agent.md"
  }
}