{
  "schemaVersion": "1.0",
  "item": {
    "slug": "twelve-data",
    "name": "Twelve Data Market API",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/softtrymee/twelve-data",
    "canonicalUrl": "https://clawhub.ai/softtrymee/twelve-data",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/twelve-data",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twelve-data",
    "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",
      "slug": "twelve-data",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T06:30:01.095Z",
      "expiresAt": "2026-05-17T06:30:01.095Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twelve-data",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twelve-data",
        "contentDisposition": "attachment; filename=\"twelve-data-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "twelve-data"
      },
      "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/twelve-data"
    },
    "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/twelve-data",
    "agentPageUrl": "https://openagent3.xyz/skills/twelve-data/agent",
    "manifestUrl": "https://openagent3.xyz/skills/twelve-data/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/twelve-data/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": "Twelve Data",
        "body": "This skill provides practical request patterns for Twelve Data based on official docs.\n\nOfficial docs:\n\nhttps://twelvedata.com/docs\nhttps://support.twelvedata.com/en/articles/5620512-how-to-create-a-request\nhttps://support.twelvedata.com/en/articles/5335783-trial"
      },
      {
        "title": "Base URLs",
        "body": "REST API: https://api.twelvedata.com\nWebSocket: wss://ws.twelvedata.com"
      },
      {
        "title": "Authentication",
        "body": "Twelve Data supports two auth methods:\n\nQuery parameter\n\ncurl \"https://api.twelvedata.com/price?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\nHTTP header (recommended by docs)\n\ncurl -H \"Authorization: apikey ${TWELVEDATA_API_KEY}\" \\\n  \"https://api.twelvedata.com/price?symbol=AAPL\"\n\nNotes:\n\napikey=demo can be used for limited trial/demo requests.\nPremium endpoints require higher-tier plans."
      },
      {
        "title": "Quick Setup",
        "body": "Configure in OpenClaw:\n\n{\n  skills: {\n    entries: {\n      \"twelve-data\": {\n        enabled: true,\n        apiKey: \"your-twelvedata-api-key\",\n        env: {\n          TWELVEDATA_API_KEY: \"your-twelvedata-api-key\"\n        }\n      }\n    }\n  }\n}\n\nOr in ~/.openclaw/.env:\n\nTWELVEDATA_API_KEY=your-api-key-here"
      },
      {
        "title": "1) Latest price (/price, 1 credit/symbol)",
        "body": "curl \"https://api.twelvedata.com/price?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\""
      },
      {
        "title": "2) Real-time quote (/quote, 1 credit/symbol)",
        "body": "curl \"https://api.twelvedata.com/quote?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\""
      },
      {
        "title": "3) Historical OHLCV (/time_series, 1 credit/symbol)",
        "body": "curl \"https://api.twelvedata.com/time_series?symbol=AAPL&interval=1day&outputsize=100&apikey=${TWELVEDATA_API_KEY}\"\n\nCommon interval values: 1min, 5min, 15min, 30min, 1h, 2h, 4h, 1day, 1week, 1month\n\nUseful params:\n\noutputsize=1..5000\nstart_date=YYYY-MM-DD or datetime\nend_date=YYYY-MM-DD or datetime\ntimezone=Exchange|UTC|IANA_TZ\nformat=JSON|CSV"
      },
      {
        "title": "4) Symbol discovery (/symbol_search, 1 credit/request)",
        "body": "curl \"https://api.twelvedata.com/symbol_search?symbol=apple&apikey=${TWELVEDATA_API_KEY}\""
      },
      {
        "title": "5) Technical indicators (typically 1 credit/symbol)",
        "body": "RSI:\n\ncurl \"https://api.twelvedata.com/rsi?symbol=AAPL&interval=1day&time_period=14&series_type=close&apikey=${TWELVEDATA_API_KEY}\"\n\nMACD:\n\ncurl \"https://api.twelvedata.com/macd?symbol=AAPL&interval=1day&series_type=close&apikey=${TWELVEDATA_API_KEY}\""
      },
      {
        "title": "6) Fundamentals (plan-gated, higher credits)",
        "body": "Earnings (/earnings, Grow+):\n\ncurl \"https://api.twelvedata.com/earnings?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\nStatistics (/statistics, Pro+):\n\ncurl \"https://api.twelvedata.com/statistics?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\nIncome statement (/income_statement, Pro+):\n\ncurl \"https://api.twelvedata.com/income_statement?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\nBalance sheet (/balance_sheet, Pro+):\n\ncurl \"https://api.twelvedata.com/balance_sheet?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\nCash flow (/cash_flow, Pro+):\n\ncurl \"https://api.twelvedata.com/cash_flow?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\nDividends:\n\ncurl \"https://api.twelvedata.com/dividends?symbol=AAPL&start_date=1970-01-01&apikey=${TWELVEDATA_API_KEY}\""
      },
      {
        "title": "Batch and Multi-Asset Examples",
        "body": "Batch symbols on supported endpoints:\n\ncurl \"https://api.twelvedata.com/time_series?symbol=AAPL,EUR/USD,ETH/BTC:Huobi&interval=1min&apikey=${TWELVEDATA_API_KEY}\"\n\nAsset symbol patterns:\n\nStocks: AAPL\nForex: EUR/USD\nCrypto: BTC/USD or exchange-scoped pair like ETH/BTC:Huobi"
      },
      {
        "title": "WebSocket (Streaming)",
        "body": "Connect:\n\nwss://ws.twelvedata.com/v1/quotes/price?apikey=YOUR_API_KEY\n\nSubscribe message:\n\n{\n  \"action\": \"subscribe\",\n  \"params\": {\n    \"symbols\": \"AAPL,MSFT\"\n  }\n}"
      },
      {
        "title": "Reliability Guidance",
        "body": "Always handle null values in responses.\nImplement retry/backoff for transient failures and 429 rate limits.\nCache frequent reads to reduce credit usage.\nCheck your current credit/rate limits in Twelve Data dashboard (plan-dependent)."
      },
      {
        "title": "Skill Usage Workflow",
        "body": "When user asks for market data analysis:\n\nResolve symbol with /symbol_search if ambiguous.\nPull latest context with /price or /quote.\nPull history with /time_series for selected interval/date range.\nAdd indicators (/rsi, /macd, etc.) if technical analysis is requested.\nAdd fundamentals endpoints only when user asks for financial statements or valuation context.\nReport endpoint, parameters, and plan limits clearly in output."
      }
    ],
    "body": "Twelve Data\n\nThis skill provides practical request patterns for Twelve Data based on official docs.\n\nOfficial docs:\n\nhttps://twelvedata.com/docs\nhttps://support.twelvedata.com/en/articles/5620512-how-to-create-a-request\nhttps://support.twelvedata.com/en/articles/5335783-trial\nBase URLs\nREST API: https://api.twelvedata.com\nWebSocket: wss://ws.twelvedata.com\nAuthentication\n\nTwelve Data supports two auth methods:\n\nQuery parameter\ncurl \"https://api.twelvedata.com/price?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\nHTTP header (recommended by docs)\ncurl -H \"Authorization: apikey ${TWELVEDATA_API_KEY}\" \\\n  \"https://api.twelvedata.com/price?symbol=AAPL\"\n\n\nNotes:\n\napikey=demo can be used for limited trial/demo requests.\nPremium endpoints require higher-tier plans.\nQuick Setup\n\nConfigure in OpenClaw:\n\n{\n  skills: {\n    entries: {\n      \"twelve-data\": {\n        enabled: true,\n        apiKey: \"your-twelvedata-api-key\",\n        env: {\n          TWELVEDATA_API_KEY: \"your-twelvedata-api-key\"\n        }\n      }\n    }\n  }\n}\n\n\nOr in ~/.openclaw/.env:\n\nTWELVEDATA_API_KEY=your-api-key-here\n\nCore Endpoints (Practical)\n1) Latest price (/price, 1 credit/symbol)\ncurl \"https://api.twelvedata.com/price?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\n2) Real-time quote (/quote, 1 credit/symbol)\ncurl \"https://api.twelvedata.com/quote?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\n3) Historical OHLCV (/time_series, 1 credit/symbol)\ncurl \"https://api.twelvedata.com/time_series?symbol=AAPL&interval=1day&outputsize=100&apikey=${TWELVEDATA_API_KEY}\"\n\n\nCommon interval values: 1min, 5min, 15min, 30min, 1h, 2h, 4h, 1day, 1week, 1month\n\nUseful params:\n\noutputsize=1..5000\nstart_date=YYYY-MM-DD or datetime\nend_date=YYYY-MM-DD or datetime\ntimezone=Exchange|UTC|IANA_TZ\nformat=JSON|CSV\n4) Symbol discovery (/symbol_search, 1 credit/request)\ncurl \"https://api.twelvedata.com/symbol_search?symbol=apple&apikey=${TWELVEDATA_API_KEY}\"\n\n5) Technical indicators (typically 1 credit/symbol)\n\nRSI:\n\ncurl \"https://api.twelvedata.com/rsi?symbol=AAPL&interval=1day&time_period=14&series_type=close&apikey=${TWELVEDATA_API_KEY}\"\n\n\nMACD:\n\ncurl \"https://api.twelvedata.com/macd?symbol=AAPL&interval=1day&series_type=close&apikey=${TWELVEDATA_API_KEY}\"\n\n6) Fundamentals (plan-gated, higher credits)\n\nEarnings (/earnings, Grow+):\n\ncurl \"https://api.twelvedata.com/earnings?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\n\nStatistics (/statistics, Pro+):\n\ncurl \"https://api.twelvedata.com/statistics?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\n\nIncome statement (/income_statement, Pro+):\n\ncurl \"https://api.twelvedata.com/income_statement?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\n\nBalance sheet (/balance_sheet, Pro+):\n\ncurl \"https://api.twelvedata.com/balance_sheet?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\n\nCash flow (/cash_flow, Pro+):\n\ncurl \"https://api.twelvedata.com/cash_flow?symbol=AAPL&apikey=${TWELVEDATA_API_KEY}\"\n\n\nDividends:\n\ncurl \"https://api.twelvedata.com/dividends?symbol=AAPL&start_date=1970-01-01&apikey=${TWELVEDATA_API_KEY}\"\n\nBatch and Multi-Asset Examples\n\nBatch symbols on supported endpoints:\n\ncurl \"https://api.twelvedata.com/time_series?symbol=AAPL,EUR/USD,ETH/BTC:Huobi&interval=1min&apikey=${TWELVEDATA_API_KEY}\"\n\n\nAsset symbol patterns:\n\nStocks: AAPL\nForex: EUR/USD\nCrypto: BTC/USD or exchange-scoped pair like ETH/BTC:Huobi\nWebSocket (Streaming)\n\nConnect:\n\nwss://ws.twelvedata.com/v1/quotes/price?apikey=YOUR_API_KEY\n\n\nSubscribe message:\n\n{\n  \"action\": \"subscribe\",\n  \"params\": {\n    \"symbols\": \"AAPL,MSFT\"\n  }\n}\n\nReliability Guidance\nAlways handle null values in responses.\nImplement retry/backoff for transient failures and 429 rate limits.\nCache frequent reads to reduce credit usage.\nCheck your current credit/rate limits in Twelve Data dashboard (plan-dependent).\nSkill Usage Workflow\n\nWhen user asks for market data analysis:\n\nResolve symbol with /symbol_search if ambiguous.\nPull latest context with /price or /quote.\nPull history with /time_series for selected interval/date range.\nAdd indicators (/rsi, /macd, etc.) if technical analysis is requested.\nAdd fundamentals endpoints only when user asks for financial statements or valuation context.\nReport endpoint, parameters, and plan limits clearly in output."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/softtrymee/twelve-data",
    "publisherUrl": "https://clawhub.ai/softtrymee/twelve-data",
    "owner": "softtrymee",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/twelve-data",
    "downloadUrl": "https://openagent3.xyz/downloads/twelve-data",
    "agentUrl": "https://openagent3.xyz/skills/twelve-data/agent",
    "manifestUrl": "https://openagent3.xyz/skills/twelve-data/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/twelve-data/agent.md"
  }
}