{
  "schemaVersion": "1.0",
  "item": {
    "slug": "finnhub",
    "name": "Access Finnhub API for real-time stock quotes, company news, market data, financial statements, and trading signals",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/matthewxfz3/finnhub",
    "canonicalUrl": "https://clawhub.ai/matthewxfz3/finnhub",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/finnhub",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=finnhub",
    "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/finnhub"
    },
    "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/finnhub",
    "agentPageUrl": "https://openagent3.xyz/skills/finnhub/agent",
    "manifestUrl": "https://openagent3.xyz/skills/finnhub/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/finnhub/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": "Finnhub API",
        "body": "Access real-time and historical stock market data, company news, financial statements, and market indicators via the Finnhub API."
      },
      {
        "title": "Quick Start",
        "body": "Get your API key from finnhub.io (free tier available).\n\nConfigure in OpenClaw:\n\n{\n  skills: {\n    entries: {\n      finnhub: {\n        enabled: true,\n        apiKey: \"your-finnhub-api-key\",\n        env: {\n          FINNHUB_API_KEY: \"your-finnhub-api-key\",\n        },\n      },\n    },\n  },\n}\n\nOr add to ~/.openclaw/.env:\n\nFINNHUB_API_KEY=your-api-key-here"
      },
      {
        "title": "API Endpoints",
        "body": "Base URL: https://finnhub.io/api/v1\n\nAll requests require ?token=${FINNHUB_API_KEY} parameter."
      },
      {
        "title": "Stock Quotes (Real-time)",
        "body": "Get current stock price:\n\ncurl \"https://finnhub.io/api/v1/quote?symbol=AAPL&token=${FINNHUB_API_KEY}\"\n\nReturns: c (current price), h (high), l (low), o (open), pc (previous close), t (timestamp)"
      },
      {
        "title": "Company News",
        "body": "Get latest company news:\n\n# News for a symbol\ncurl \"https://finnhub.io/api/v1/company-news?symbol=AAPL&from=2025-01-01&to=2025-02-01&token=${FINNHUB_API_KEY}\"\n\n# General market news\ncurl \"https://finnhub.io/api/v1/news?category=general&token=${FINNHUB_API_KEY}\""
      },
      {
        "title": "Company Profile",
        "body": "Get company information:\n\ncurl \"https://finnhub.io/api/v1/stock/profile2?symbol=AAPL&token=${FINNHUB_API_KEY}\""
      },
      {
        "title": "Financial Statements",
        "body": "Get company financials:\n\n# Income statement\ncurl \"https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&token=${FINNHUB_API_KEY}\"\n\n# Balance sheet\ncurl \"https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=bs&token=${FINNHUB_API_KEY}\"\n\n# Cash flow\ncurl \"https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=cf&token=${FINNHUB_API_KEY}\"\n\n# Search in SEC filings (10-K, 10-Q, etc.)\n# Note: This endpoint may require premium tier or have a different path\ncurl \"https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB_API_KEY}\""
      },
      {
        "title": "Market Data",
        "body": "Get market indicators:\n\n# Stock candles (OHLCV)\ncurl \"https://finnhub.io/api/v1/stock/candle?symbol=AAPL&resolution=D&from=1609459200&to=1640995200&token=${FINNHUB_API_KEY}\"\n\n# Stock symbols (search)\ncurl \"https://finnhub.io/api/v1/search?q=apple&token=${FINNHUB_API_KEY}\"\n\n# Market status\ncurl \"https://finnhub.io/api/v1/stock/market-status?exchange=US&token=${FINNHUB_API_KEY}\""
      },
      {
        "title": "Trading Signals",
        "body": "Get technical indicators and signals:\n\n# Technical indicators (may require premium tier)\ncurl \"https://finnhub.io/api/v1/indicator?symbol=AAPL&indicator=rsi&resolution=D&token=${FINNHUB_API_KEY}\"\n\n# Support/Resistance (may require premium tier)\ncurl \"https://finnhub.io/api/v1/scan/support-resistance?symbol=AAPL&resolution=D&token=${FINNHUB_API_KEY}\"\n\n# Pattern recognition (may require premium tier)\ncurl \"https://finnhub.io/api/v1/scan/pattern?symbol=AAPL&resolution=D&token=${FINNHUB_API_KEY}\"\n\nNote: Some technical indicator endpoints may require a premium subscription. Free tier includes basic market data and quotes."
      },
      {
        "title": "Earnings & Calendar",
        "body": "Get earnings data:\n\n# Earnings calendar\ncurl \"https://finnhub.io/api/v1/calendar/earnings?from=2025-02-01&to=2025-02-28&token=${FINNHUB_API_KEY}\"\n\n# Company earnings\ncurl \"https://finnhub.io/api/v1/stock/earnings?symbol=AAPL&token=${FINNHUB_API_KEY}\""
      },
      {
        "title": "Find Trading Opportunities",
        "body": "Search for stocks: GET /search?q=keyword\nGet current quote: GET /quote?symbol=SYMBOL\nCheck recent news: GET /company-news?symbol=SYMBOL&from=DATE&to=DATE\nAnalyze technical indicators: GET /indicator?symbol=SYMBOL&indicator=rsi\nReview financials: GET /stock/financials-reported?symbol=SYMBOL\nSearch SEC filings: GET /stock/search-in-filing?symbol=SYMBOL&query=KEYWORD"
      },
      {
        "title": "Monitor Stock Performance",
        "body": "Get real-time quote: GET /quote?symbol=SYMBOL\nGet historical candles: GET /stock/candle?symbol=SYMBOL&resolution=D\nCheck company profile: GET /stock/profile2?symbol=SYMBOL\nReview earnings: GET /stock/earnings?symbol=SYMBOL"
      },
      {
        "title": "Research Company News",
        "body": "Company-specific news: GET /company-news?symbol=SYMBOL\nGeneral market news: GET /news?category=general\nSector news: GET /news?category=technology"
      },
      {
        "title": "Search SEC Filings",
        "body": "Search within company SEC filings (10-K, 10-Q, 8-K, etc.):\n\n# Search for specific terms in filings\n# Note: This endpoint may require premium tier or have a different path\ncurl \"https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB_API_KEY}\"\n\n# Search for risk factors\ncurl \"https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=risk&token=${FINNHUB_API_KEY}\"\n\n# Search for specific financial metrics\ncurl \"https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=EBITDA&token=${FINNHUB_API_KEY}\"\n\nThis endpoint searches through SEC filings (10-K, 10-Q, 8-K, etc.) for specific keywords or phrases, useful for finding mentions of specific topics, risks, or financial metrics in official company documents."
      },
      {
        "title": "Rate Limits",
        "body": "Free tier:\n\n60 API calls/minute\nReal-time data: limited\nHistorical data: available\n\nPaid tiers offer higher limits and additional features."
      },
      {
        "title": "Notes",
        "body": "Always include token=${FINNHUB_API_KEY} in query parameters\nUse proper date formats: YYYY-MM-DD for date ranges\nTimestamps are Unix epoch seconds\nSymbol format: use exchange prefix if needed (e.g., US:AAPL for US stocks)\nFor paper trading, combine Finnhub data with Alpaca API for execution"
      }
    ],
    "body": "Finnhub API\n\nAccess real-time and historical stock market data, company news, financial statements, and market indicators via the Finnhub API.\n\nQuick Start\n\nGet your API key from finnhub.io (free tier available).\n\nConfigure in OpenClaw:\n\n{\n  skills: {\n    entries: {\n      finnhub: {\n        enabled: true,\n        apiKey: \"your-finnhub-api-key\",\n        env: {\n          FINNHUB_API_KEY: \"your-finnhub-api-key\",\n        },\n      },\n    },\n  },\n}\n\n\nOr add to ~/.openclaw/.env:\n\nFINNHUB_API_KEY=your-api-key-here\n\nAPI Endpoints\n\nBase URL: https://finnhub.io/api/v1\n\nAll requests require ?token=${FINNHUB_API_KEY} parameter.\n\nStock Quotes (Real-time)\n\nGet current stock price:\n\ncurl \"https://finnhub.io/api/v1/quote?symbol=AAPL&token=${FINNHUB_API_KEY}\"\n\n\nReturns: c (current price), h (high), l (low), o (open), pc (previous close), t (timestamp)\n\nCompany News\n\nGet latest company news:\n\n# News for a symbol\ncurl \"https://finnhub.io/api/v1/company-news?symbol=AAPL&from=2025-01-01&to=2025-02-01&token=${FINNHUB_API_KEY}\"\n\n# General market news\ncurl \"https://finnhub.io/api/v1/news?category=general&token=${FINNHUB_API_KEY}\"\n\nCompany Profile\n\nGet company information:\n\ncurl \"https://finnhub.io/api/v1/stock/profile2?symbol=AAPL&token=${FINNHUB_API_KEY}\"\n\nFinancial Statements\n\nGet company financials:\n\n# Income statement\ncurl \"https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&token=${FINNHUB_API_KEY}\"\n\n# Balance sheet\ncurl \"https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=bs&token=${FINNHUB_API_KEY}\"\n\n# Cash flow\ncurl \"https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=cf&token=${FINNHUB_API_KEY}\"\n\n# Search in SEC filings (10-K, 10-Q, etc.)\n# Note: This endpoint may require premium tier or have a different path\ncurl \"https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB_API_KEY}\"\n\nMarket Data\n\nGet market indicators:\n\n# Stock candles (OHLCV)\ncurl \"https://finnhub.io/api/v1/stock/candle?symbol=AAPL&resolution=D&from=1609459200&to=1640995200&token=${FINNHUB_API_KEY}\"\n\n# Stock symbols (search)\ncurl \"https://finnhub.io/api/v1/search?q=apple&token=${FINNHUB_API_KEY}\"\n\n# Market status\ncurl \"https://finnhub.io/api/v1/stock/market-status?exchange=US&token=${FINNHUB_API_KEY}\"\n\nTrading Signals\n\nGet technical indicators and signals:\n\n# Technical indicators (may require premium tier)\ncurl \"https://finnhub.io/api/v1/indicator?symbol=AAPL&indicator=rsi&resolution=D&token=${FINNHUB_API_KEY}\"\n\n# Support/Resistance (may require premium tier)\ncurl \"https://finnhub.io/api/v1/scan/support-resistance?symbol=AAPL&resolution=D&token=${FINNHUB_API_KEY}\"\n\n# Pattern recognition (may require premium tier)\ncurl \"https://finnhub.io/api/v1/scan/pattern?symbol=AAPL&resolution=D&token=${FINNHUB_API_KEY}\"\n\n\nNote: Some technical indicator endpoints may require a premium subscription. Free tier includes basic market data and quotes.\n\nEarnings & Calendar\n\nGet earnings data:\n\n# Earnings calendar\ncurl \"https://finnhub.io/api/v1/calendar/earnings?from=2025-02-01&to=2025-02-28&token=${FINNHUB_API_KEY}\"\n\n# Company earnings\ncurl \"https://finnhub.io/api/v1/stock/earnings?symbol=AAPL&token=${FINNHUB_API_KEY}\"\n\nCommon Use Cases\nFind Trading Opportunities\nSearch for stocks: GET /search?q=keyword\nGet current quote: GET /quote?symbol=SYMBOL\nCheck recent news: GET /company-news?symbol=SYMBOL&from=DATE&to=DATE\nAnalyze technical indicators: GET /indicator?symbol=SYMBOL&indicator=rsi\nReview financials: GET /stock/financials-reported?symbol=SYMBOL\nSearch SEC filings: GET /stock/search-in-filing?symbol=SYMBOL&query=KEYWORD\nMonitor Stock Performance\nGet real-time quote: GET /quote?symbol=SYMBOL\nGet historical candles: GET /stock/candle?symbol=SYMBOL&resolution=D\nCheck company profile: GET /stock/profile2?symbol=SYMBOL\nReview earnings: GET /stock/earnings?symbol=SYMBOL\nResearch Company News\nCompany-specific news: GET /company-news?symbol=SYMBOL\nGeneral market news: GET /news?category=general\nSector news: GET /news?category=technology\nSearch SEC Filings\n\nSearch within company SEC filings (10-K, 10-Q, 8-K, etc.):\n\n# Search for specific terms in filings\n# Note: This endpoint may require premium tier or have a different path\ncurl \"https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB_API_KEY}\"\n\n# Search for risk factors\ncurl \"https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=risk&token=${FINNHUB_API_KEY}\"\n\n# Search for specific financial metrics\ncurl \"https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=EBITDA&token=${FINNHUB_API_KEY}\"\n\n\nThis endpoint searches through SEC filings (10-K, 10-Q, 8-K, etc.) for specific keywords or phrases, useful for finding mentions of specific topics, risks, or financial metrics in official company documents.\n\nRate Limits\n\nFree tier:\n\n60 API calls/minute\nReal-time data: limited\nHistorical data: available\n\nPaid tiers offer higher limits and additional features.\n\nNotes\nAlways include token=${FINNHUB_API_KEY} in query parameters\nUse proper date formats: YYYY-MM-DD for date ranges\nTimestamps are Unix epoch seconds\nSymbol format: use exchange prefix if needed (e.g., US:AAPL for US stocks)\nFor paper trading, combine Finnhub data with Alpaca API for execution"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/matthewxfz3/finnhub",
    "publisherUrl": "https://clawhub.ai/matthewxfz3/finnhub",
    "owner": "matthewxfz3",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/finnhub",
    "downloadUrl": "https://openagent3.xyz/downloads/finnhub",
    "agentUrl": "https://openagent3.xyz/skills/finnhub/agent",
    "manifestUrl": "https://openagent3.xyz/skills/finnhub/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/finnhub/agent.md"
  }
}