{
  "schemaVersion": "1.0",
  "item": {
    "slug": "gprophet-api",
    "name": "Gprophet Api",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/filwu8/gprophet-api",
    "canonicalUrl": "https://clawhub.ai/filwu8/gprophet-api",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/gprophet-api",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gprophet-api",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "README.md",
      "SKILL.md",
      "_meta.json"
    ],
    "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. 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."
        },
        {
          "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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "gprophet-api",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T03:19:53.925Z",
      "expiresAt": "2026-05-07T03:19:53.925Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gprophet-api",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gprophet-api",
        "contentDisposition": "attachment; filename=\"gprophet-api-1.0.6.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "gprophet-api"
      },
      "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/gprophet-api"
    },
    "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/gprophet-api",
    "agentPageUrl": "https://openagent3.xyz/skills/gprophet-api/agent",
    "manifestUrl": "https://openagent3.xyz/skills/gprophet-api/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/gprophet-api/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. 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."
      },
      {
        "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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "G-Prophet AI Skills Documentation",
        "body": "Stock prediction and market analysis capabilities for AI agents"
      },
      {
        "title": "Overview",
        "body": "G-Prophet is an AI-powered stock prediction platform that exposes its core capabilities through an external API for other AI agent systems. It supports global markets (China A-shares, US stocks, HK stocks, Crypto) and provides AI prediction, technical analysis, market sentiment, and deep analysis Skills."
      },
      {
        "title": "Basic Information",
        "body": "ItemDescriptionAPI Base URLhttps://www.gprophet.com/api/external/v1AuthenticationX-API-Key headerKey Formatgp_sk_ prefix (e.g. gp_sk_[REDACTED]_a1b2c3...)Response FormatJSONBillingPoints-based, each call consumes corresponding points"
      },
      {
        "title": "Authentication",
        "body": "All requests must include an API Key in the HTTP header:\n\nX-API-Key: gp_sk_[REDACTED]_your_api_key_here\n\nAPI Keys can be created in the G-Prophet platform under \"Settings → API Key Management\"."
      },
      {
        "title": "Security Recommendations",
        "body": "Store API keys in environment variables (GPROPHET_API_KEY), not in code\nUse test/limited-scope keys for development and evaluation\nMonitor usage and billing regularly at https://www.gprophet.com/dashboard\nRotate keys periodically and revoke compromised keys immediately\nNever commit API keys to version control or share them publicly"
      },
      {
        "title": "Rate Limiting",
        "body": "All API requests are subject to per-key rate limiting (fixed window, per minute).\n\nHeaderDescriptionX-RateLimit-LimitMaximum requests allowed per minuteX-RateLimit-RemainingRemaining requests in current windowX-RateLimit-ResetSeconds until the rate limit window resets\n\nDefault limit is 60 requests per minute per API Key. When exceeded, the API returns HTTP 429:\n\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"RATE_LIMITED\",\n    \"message\": \"Rate limit exceeded. Max 60 requests per minute.\",\n    \"details\": {\n      \"limit_per_minute\": 60,\n      \"retry_after_seconds\": 45\n    }\n  }\n}\n\nThe response includes a Retry-After header indicating how many seconds to wait."
      },
      {
        "title": "Quota Management",
        "body": "Each API Key has configurable daily and monthly call quotas. Quota = 0 means unlimited.\n\nWhen quota is exceeded, the API returns HTTP 429:\n\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"QUOTA_EXCEEDED\",\n    \"message\": \"Daily quota exceeded (100/100)\",\n    \"details\": {\n      \"resolution\": \"Upgrade your plan or wait for quota reset.\"\n    }\n  }\n}\n\nCheck your current quota usage via GET /account/balance."
      },
      {
        "title": "Success Response",
        "body": "{\n  \"success\": true,\n  \"data\": { ... },\n  \"metadata\": {\n    \"request_id\": \"req_abc123\",\n    \"timestamp\": \"2026-02-18T10:30:00Z\",\n    \"processing_time_ms\": 1250,\n    \"api_version\": \"v1\"\n  },\n  \"error\": null\n}"
      },
      {
        "title": "Error Response",
        "body": "Errors return the appropriate HTTP status code (401, 402, 403, 404, 429, 500, 503) along with a JSON body:\n\n{\n  \"success\": false,\n  \"data\": null,\n  \"metadata\": { ... },\n  \"error\": {\n    \"code\": \"INVALID_SYMBOL\",\n    \"message\": \"Stock symbol 'XXXXX' not found\",\n    \"details\": {}\n  }\n}"
      },
      {
        "title": "Insufficient Points Response (402)",
        "body": "When points are insufficient, the API returns a detailed 402 response with actionable guidance:\n\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INSUFFICIENT_POINTS\",\n    \"message\": \"Insufficient points. Required: 20, available: 5.\",\n    \"details\": {\n      \"required\": 20,\n      \"available\": 5,\n      \"shortage\": 15,\n      \"resolution\": {\n        \"actions\": [\n          { \"action\": \"register\", \"url\": \"https://gprophet.com/register\" },\n          { \"action\": \"recharge\", \"url\": \"https://gprophet.com/membership\" },\n          { \"action\": \"subscribe\", \"url\": \"https://gprophet.com/membership\" }\n        ]\n      }\n    }\n  }\n}"
      },
      {
        "title": "Points Cost",
        "body": "SkillEndpointPoints/CallStock PredictionPOST /predictions/predictCN 10, HK 15, US 20, Crypto 20Algorithm ComparePOST /predictions/compareSingle prediction cost × number of algorithmsQuoteGET /market-data/quote5HistoryGET /market-data/history5SearchGET /market-data/search5Batch QuotePOST /market-data/batch-quote5 × number of symbolsTechnical AnalysisPOST /technical/analyze5Fear & Greed IndexGET /sentiment/fear-greed5Market OverviewGET /sentiment/market-overview5AI Stock AnalysisPOST /analysis/stock58Deep AnalysisPOST /analysis/comprehensive150Task PollingGET /analysis/task/{task_id}0 (free)Account BalanceGET /account/balance0 (free)Usage StatisticsGET /account/usage0 (free)API InfoGET /info0 (free)"
      },
      {
        "title": "Skill 1: Stock Price Prediction",
        "body": "Predict future stock/cryptocurrency price movements using AI algorithms. Supports G-Prophet2026V1, LSTM, Transformer, and more."
      },
      {
        "title": "POST /predictions/predict",
        "body": "Request Body (JSON):\n\nParameterTypeRequiredDefaultDescriptionsymbolstring✅-Stock/crypto ticker (e.g. AAPL, 600519, BTCUSDT)marketstring✅-Market code: US, CN, HK, CRYPTOdaysintegerNo7Prediction days, range 1-30algorithmstringNoautoAlgorithm: auto, gprophet2026v1, lstm, transformer, random_forest, ensemble\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/predictions/predict\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"AAPL\", \"market\": \"US\", \"days\": 7, \"algorithm\": \"auto\"}'\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"AAPL\",\n    \"name\": \"Apple Inc.\",\n    \"market\": \"US\",\n    \"current_price\": 185.50,\n    \"predicted_price\": 191.20,\n    \"change_percent\": 3.07,\n    \"direction\": \"up\",\n    \"confidence\": 0.78,\n    \"prediction_days\": 7,\n    \"algorithm_used\": \"gprophet2026v1\",\n    \"data_quality\": {\n      \"completeness\": 1.0,\n      \"anomaly_count\": 82,\n      \"missing_values\": 0,\n      \"overall_score\": 80\n    },\n    \"points_consumed\": 20\n  }\n}"
      },
      {
        "title": "POST /predictions/compare",
        "body": "Multi-algorithm comparison prediction. Returns results from each algorithm and the best recommendation. Points cost = single prediction cost × number of algorithms.\n\nRequest Body (JSON):\n\nParameterTypeRequiredDefaultDescriptionsymbolstring✅-Stock/crypto tickermarketstring✅-Market code: US, CN, HK, CRYPTOdaysintegerNo5Prediction days, range 1-30algorithmsstring[]No[\"gprophet2026v1\",\"lstm\",\"transformer\",\"ensemble\"]Algorithm list, max 6\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/predictions/compare\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"TSLA\", \"market\": \"US\", \"days\": 5, \"algorithms\": [\"gprophet2026v1\", \"lstm\", \"transformer\"]}'\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"TSLA\",\n    \"name\": \"Tesla Inc.\",\n    \"market\": \"US\",\n    \"current_price\": 245.00,\n    \"prediction_days\": 5,\n    \"results\": [\n      {\n        \"algorithm\": \"gprophet2026v1\",\n        \"predicted_price\": 252.30,\n        \"change_percent\": 2.98,\n        \"direction\": \"up\",\n        \"confidence\": 0.82,\n        \"success\": true\n      },\n      {\n        \"algorithm\": \"lstm\",\n        \"predicted_price\": 248.10,\n        \"change_percent\": 1.27,\n        \"direction\": \"up\",\n        \"confidence\": 0.71,\n        \"success\": true\n      }\n    ],\n    \"best_algorithm\": \"gprophet2026v1\",\n    \"consensus_direction\": \"up\",\n    \"average_predicted_price\": 250.20,\n    \"points_consumed\": 60\n  }\n}"
      },
      {
        "title": "Skill 2: Market Data",
        "body": "Get real-time quotes, historical OHLCV data, search for stocks/crypto, and batch quotes. Each call costs 5 points (batch = 5 × count)."
      },
      {
        "title": "GET /market-data/quote",
        "body": "Get real-time quote.\n\nQuery Parameters:\n\nParameterTypeRequiredDescriptionsymbolstring✅Stock/crypto tickermarketstring✅Market code: US, CN, HK, CRYPTO\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/market-data/quote?symbol=AAPL&market=US\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"name\": \"Apple Inc.\",\n    \"price\": 185.50,\n    \"open\": 183.90,\n    \"high\": 186.80,\n    \"low\": 183.20,\n    \"volume\": 52340000,\n    \"previous_close\": 183.20,\n    \"change\": 2.30,\n    \"change_percent\": 1.26,\n    \"points_consumed\": 5\n  }\n}"
      },
      {
        "title": "GET /market-data/history",
        "body": "Get historical OHLCV candlestick data.\n\nQuery Parameters:\n\nParameterTypeRequiredDefaultDescriptionsymbolstring✅-Stock/crypto tickermarketstring✅-Market codeperiodstringNo3mTime range: 1w, 1m, 3m, 6m, 1y, 2y\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/market-data/history?symbol=AAPL&market=US&period=3m\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"period\": \"3m\",\n    \"data_points\": 63,\n    \"history\": [\n      {\n        \"date\": \"2025-12-01\",\n        \"open\": 178.50,\n        \"high\": 180.20,\n        \"low\": 177.80,\n        \"close\": 179.90,\n        \"volume\": 48500000\n      }\n    ],\n    \"points_consumed\": 5\n  }\n}"
      },
      {
        "title": "GET /market-data/search",
        "body": "Search for stocks/crypto by keyword.\n\nQuery Parameters:\n\nParameterTypeRequiredDefaultDescriptionkeywordstring✅-Search keywordmarketstringNoUSMarket codelimitintegerNo10Result count, range 1-50\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/market-data/search?keyword=apple&market=US&limit=5\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\""
      },
      {
        "title": "POST /market-data/batch-quote",
        "body": "Get quotes for multiple symbols in a single request. Max 20 symbols. Cost = 5 points × number of symbols.\n\nRequest Body (JSON):\n\nParameterTypeRequiredDescriptionsymbolsstring[]✅List of stock/crypto tickers (max 20)marketstring✅Market code: US, CN, HK, CRYPTO\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/market-data/batch-quote\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbols\": [\"AAPL\", \"TSLA\", \"GOOGL\"], \"market\": \"US\"}'\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"market\": \"US\",\n    \"count\": 3,\n    \"successful\": 3,\n    \"results\": [\n      {\n        \"symbol\": \"AAPL\",\n        \"name\": \"Apple Inc.\",\n        \"success\": true,\n        \"price\": 185.50,\n        \"change\": 2.30,\n        \"change_percent\": 1.26\n      },\n      {\n        \"symbol\": \"TSLA\",\n        \"name\": \"Tesla Inc.\",\n        \"success\": true,\n        \"price\": 245.00,\n        \"change\": -3.20,\n        \"change_percent\": -1.29\n      },\n      {\n        \"symbol\": \"GOOGL\",\n        \"name\": \"Alphabet Inc.\",\n        \"success\": true,\n        \"price\": 142.80,\n        \"change\": 1.10,\n        \"change_percent\": 0.78\n      }\n    ],\n    \"points_consumed\": 15\n  }\n}"
      },
      {
        "title": "Skill 3: Technical Analysis",
        "body": "Calculate technical indicators and generate trading signals for a given stock. Each call costs 5 points."
      },
      {
        "title": "POST /technical/analyze",
        "body": "Request Body (JSON):\n\nParameterTypeRequiredDefaultDescriptionsymbolstring✅-Stock/crypto tickermarketstring✅-Market code: US, CN, HK, CRYPTOindicatorsstring[]No[\"rsi\",\"macd\",\"bollinger\",\"kdj\"]Indicators: rsi, macd, bollinger, kdj, sma, ema\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/technical/analyze\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"AAPL\", \"market\": \"US\", \"indicators\": [\"rsi\", \"macd\", \"bollinger\", \"kdj\"]}'\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"current_price\": 185.50,\n    \"indicators\": {\n      \"rsi_14\": { \"value\": 55.3, \"signal\": \"neutral\" },\n      \"macd\": { \"macd\": 1.25, \"signal\": 0.98, \"histogram\": 0.27, \"signal_type\": \"bullish\" },\n      \"bollinger\": { \"upper\": 192.0, \"middle\": 185.0, \"lower\": 178.0, \"position\": 0.54 },\n      \"kdj\": { \"k\": 65.2, \"d\": 58.7, \"j\": 78.2 }\n    },\n    \"signals\": [\n      { \"type\": \"bullish\", \"indicator\": \"MACD\" },\n      { \"type\": \"neutral\", \"indicator\": \"RSI\" }\n    ],\n    \"overall_signal\": \"bullish\",\n    \"signal_strength\": 0.5,\n    \"points_consumed\": 5\n  }\n}"
      },
      {
        "title": "Skill 4: Market Sentiment",
        "body": "Get market sentiment data including Fear & Greed Index and market overview. Each call costs 5 points."
      },
      {
        "title": "GET /sentiment/fear-greed",
        "body": "Get the crypto market Fear & Greed Index.\n\nQuery Parameters:\n\nParameterTypeRequiredDefaultDescriptiondaysintegerNo1History days, 1=current only, range 1-365\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/sentiment/fear-greed?days=1\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"value\": 72,\n    \"classification\": \"greed\",\n    \"previous_value\": 68,\n    \"change\": 4,\n    \"points_consumed\": 5\n  }\n}"
      },
      {
        "title": "GET /sentiment/market-overview",
        "body": "Get comprehensive market overview (breadth, hot sectors, major indices).\n\nQuery Parameters:\n\nParameterTypeRequiredDefaultDescriptionmarketstringNoCNMarket code: CN, US\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/sentiment/market-overview?market=CN\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\""
      },
      {
        "title": "Skill 5: AI Stock Analysis (Async)",
        "body": "Single-stock AI analysis report using LLM. Costs 58 points. Supports CN, US, CRYPTO markets.\n\n⚠️ Async Mode: Analysis typically takes 15-60 seconds, so this endpoint uses async mode.\n\nPOST /analysis/stock → Returns task_id immediately\nGET /analysis/task/{task_id} → Poll for status; get results when status=completed\n\nRecommended polling interval: 5 seconds. Max wait: 5 minutes."
      },
      {
        "title": "POST /analysis/stock",
        "body": "Submit a stock analysis task. Returns task ID immediately.\n\nRequest Body (JSON):\n\nParameterTypeRequiredDefaultDescriptionsymbolstring✅-Stock/crypto tickermarketstring✅-Market code: US, CN, CRYPTOlocalestringNozh-CNReport language: zh-CN, en-UScallback_urlstringNo-Webhook URL; results are POSTed on completion\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/analysis/stock\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"AAPL\", \"market\": \"US\", \"locale\": \"en-US\"}'\n\nExample Response (immediate):\n\n{\n  \"success\": true,\n  \"data\": {\n    \"task_id\": \"task_abc123def456\",\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"status\": \"pending\",\n    \"points_consumed\": 58,\n    \"poll_url\": \"/api/external/v1/analysis/task/task_abc123def456\",\n    \"callback_url\": null,\n    \"message\": \"Stock analysis started. Poll the task URL every 5 seconds for results.\"\n  }\n}"
      },
      {
        "title": "Skill 6: Deep Analysis (Async)",
        "body": "Multi-agent collaborative deep analysis evaluating stocks from 5 dimensions: technical, fundamental, capital flow, sentiment, and macro environment. Costs 150 points.\n\n⚠️ Async Mode: Deep analysis typically takes 30-120 seconds, so this endpoint uses async mode.\n\nPOST /analysis/comprehensive → Returns task_id immediately\nGET /analysis/task/{task_id} → Poll for status; get results when status=completed\n\nRecommended polling interval: 5 seconds. Max wait: 5 minutes."
      },
      {
        "title": "POST /analysis/comprehensive",
        "body": "Submit a deep analysis task. Returns task ID immediately.\n\nRequest Body (JSON):\n\nParameterTypeRequiredDefaultDescriptionsymbolstring✅-Stock/crypto tickermarketstring✅-Market code: US, CN, HK, CRYPTOlocalestringNozh-CNReport language: zh-CN, en-UScallback_urlstringNo-Webhook URL; results are POSTed on completion\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/analysis/comprehensive\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"AAPL\", \"market\": \"US\", \"locale\": \"en-US\"}'\n\nExample Response (immediate):\n\n{\n  \"success\": true,\n  \"data\": {\n    \"task_id\": \"task_abc123def456\",\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"status\": \"pending\",\n    \"points_consumed\": 150,\n    \"poll_url\": \"/api/external/v1/analysis/task/task_abc123def456\",\n    \"callback_url\": null,\n    \"message\": \"Analysis started. Poll the task URL every 5 seconds for results.\"\n  }\n}"
      },
      {
        "title": "Webhook Callback",
        "body": "Both /analysis/stock and /analysis/comprehensive accept an optional callback_url parameter. When provided, the API will POST the task result to that URL upon completion or failure:\n\nCallback Payload (success):\n\n{\n  \"task_id\": \"task_abc123def456\",\n  \"status\": \"completed\",\n  \"result\": { ... }\n}\n\nCallback Payload (failure):\n\n{\n  \"task_id\": \"task_abc123def456\",\n  \"status\": \"failed\",\n  \"error\": \"Analysis service timeout\"\n}"
      },
      {
        "title": "GET /analysis/task/{task_id}",
        "body": "Poll analysis task status and results.\n\nPath Parameters:\n\nParameterTypeDescriptiontask_idstringTask ID returned by analysis endpoints\n\nStatus Flow: pending → running (progress 0-100) → completed / failed\n\nExample Response (completed):\n\n{\n  \"success\": true,\n  \"data\": {\n    \"task_id\": \"task_abc123def456\",\n    \"status\": \"completed\",\n    \"progress\": 100,\n    \"message\": \"Analysis completed\",\n    \"result\": {\n      \"symbol\": \"AAPL\",\n      \"asset_type\": \"stock_us\",\n      \"analysis\": {\n        \"overall_rating\": \"bullish\",\n        \"confidence\": 0.75,\n        \"agents\": {\n          \"technical\": { \"rating\": \"bullish\", \"confidence\": 0.80 },\n          \"fundamental\": { \"rating\": \"neutral\", \"confidence\": 0.65 },\n          \"capital_flow\": { \"rating\": \"bullish\", \"confidence\": 0.70 },\n          \"sentiment\": { \"rating\": \"neutral\", \"confidence\": 0.60 },\n          \"macro\": { \"rating\": \"cautious\", \"confidence\": 0.55 }\n        },\n        \"final_recommendation\": \"Short-term bullish, consider buying on dips\",\n        \"risk_level\": \"medium\"\n      }\n    },\n    \"error\": null\n  }\n}"
      },
      {
        "title": "GET /account/balance",
        "body": "Check current API Key's points balance and quota usage. Free, no points consumed.\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/account/balance\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"available_points\": 1250,\n    \"key_name\": \"My Trading Bot\",\n    \"key_prefix\": \"gp_sk_abc\",\n    \"scopes\": [\"predictions\", \"market_data\", \"technical\", \"sentiment\", \"analysis\"],\n    \"rate_limit_per_minute\": 60,\n    \"daily_quota\": 1000,\n    \"daily_used\": 42,\n    \"monthly_quota\": 0,\n    \"monthly_used\": 856\n  }\n}"
      },
      {
        "title": "GET /account/usage",
        "body": "Get call history statistics for the current API Key. Free, no points consumed.\n\nQuery Parameters:\n\nParameterTypeRequiredDefaultDescriptiondaysintegerNo7History days, range 1-90\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/account/usage?days=7\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"key_prefix\": \"gp_sk_abc\",\n    \"period_days\": 7,\n    \"daily\": [\n      {\n        \"date\": \"2026-03-09\",\n        \"total_calls\": 85,\n        \"success_calls\": 82,\n        \"avg_response_ms\": 1250\n      }\n    ],\n    \"by_endpoint\": [\n      { \"endpoint\": \"/api/external/v1/predictions/predict\", \"calls\": 45 },\n      { \"endpoint\": \"/api/external/v1/market-data/quote\", \"calls\": 30 }\n    ]\n  }\n}"
      },
      {
        "title": "GET /info",
        "body": "Get API metadata: supported markets, algorithms, pricing table, authentication info. Free, no points consumed.\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/info\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\""
      },
      {
        "title": "Error Codes",
        "body": "CodeHTTP StatusDescriptionMISSING_API_KEY401Missing X-API-Key headerINVALID_KEY_FORMAT401Invalid API Key format (must start with gp_sk_)INVALID_API_KEY401Invalid API KeyAPI_KEY_DISABLED403API Key has been disabledAPI_KEY_EXPIRED403API Key has expiredINSUFFICIENT_SCOPE403API Key lacks permission for this SkillINSUFFICIENT_POINTS402Insufficient pointsPOINTS_DEDUCTION_FAILED500Failed to deduct pointsOWNER_NOT_FOUND403API Key owner account not foundRATE_LIMITED429Request frequency exceeded per-minute limitQUOTA_EXCEEDED429Daily or monthly call quota exhaustedINVALID_MARKET400Unsupported market codeUNSUPPORTED_MARKET400Market not supported for this endpointSYMBOL_NOT_FOUND404Stock/crypto ticker not foundNO_DATA404Unable to retrieve dataTOO_MANY_ALGORITHMS400Too many algorithms (max 6)PREDICTION_FAILED500Prediction service errorANALYSIS_FAILED500Analysis service errorTASK_NOT_FOUND404Async task not found or expiredFORBIDDEN403Access denied (e.g. querying another user's task)DATA_UNAVAILABLE503Data source temporarily unavailableINTERNAL_ERROR500Internal service error"
      },
      {
        "title": "MCP Tools Definitions",
        "body": "MCP (Model Context Protocol) tool definitions for use with Claude, Kiro, and other MCP-compatible agents:"
      },
      {
        "title": "gprophet_predict",
        "body": "{\n  \"name\": \"gprophet_predict\",\n  \"description\": \"Predict stock/crypto price using AI. Markets: US, CN, HK, CRYPTO. Algorithms: auto, gprophet2026v1, lstm, transformer, random_forest, ensemble. IMPORTANT: The response includes 'symbol', 'name' (official stock name), and 'market' fields — always use these values directly, never infer or fabricate the stock name from the symbol.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\", \"description\": \"Stock/crypto symbol (e.g., AAPL, 600519, BTCUSDT)\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] },\n      \"days\": { \"type\": \"integer\", \"minimum\": 1, \"maximum\": 30, \"default\": 7 },\n      \"algorithm\": { \"type\": \"string\", \"default\": \"auto\" }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}"
      },
      {
        "title": "gprophet_quote",
        "body": "{\n  \"name\": \"gprophet_quote\",\n  \"description\": \"Get real-time stock/crypto quote.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\", \"description\": \"Stock/crypto symbol\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}"
      },
      {
        "title": "gprophet_batch_quote",
        "body": "{\n  \"name\": \"gprophet_batch_quote\",\n  \"description\": \"Get quotes for multiple symbols at once (max 20). Cost = 5 points × number of symbols.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbols\": { \"type\": \"array\", \"items\": { \"type\": \"string\" }, \"description\": \"List of symbols (max 20)\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] }\n    },\n    \"required\": [\"symbols\", \"market\"]\n  }\n}"
      },
      {
        "title": "gprophet_history",
        "body": "{\n  \"name\": \"gprophet_history\",\n  \"description\": \"Get historical OHLCV price data.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] },\n      \"period\": { \"type\": \"string\", \"enum\": [\"1w\", \"1m\", \"3m\", \"6m\", \"1y\", \"2y\"], \"default\": \"3m\" }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}"
      },
      {
        "title": "gprophet_search",
        "body": "{\n  \"name\": \"gprophet_search\",\n  \"description\": \"Search for stocks/crypto by keyword.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"keyword\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"], \"default\": \"US\" },\n      \"limit\": { \"type\": \"integer\", \"minimum\": 1, \"maximum\": 50, \"default\": 10 }\n    },\n    \"required\": [\"keyword\"]\n  }\n}"
      },
      {
        "title": "gprophet_technical",
        "body": "{\n  \"name\": \"gprophet_technical\",\n  \"description\": \"Calculate technical indicators (RSI, MACD, Bollinger, KDJ, SMA, EMA) and generate trading signals.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] },\n      \"indicators\": { \"type\": \"array\", \"items\": { \"type\": \"string\", \"enum\": [\"rsi\", \"macd\", \"bollinger\", \"kdj\", \"sma\", \"ema\"] }, \"default\": [\"rsi\", \"macd\", \"bollinger\", \"kdj\"] }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}"
      },
      {
        "title": "gprophet_fear_greed",
        "body": "{\n  \"name\": \"gprophet_fear_greed\",\n  \"description\": \"Get crypto market Fear & Greed Index.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"days\": { \"type\": \"integer\", \"minimum\": 1, \"maximum\": 365, \"default\": 1 }\n    }\n  }\n}"
      },
      {
        "title": "gprophet_market_overview",
        "body": "{\n  \"name\": \"gprophet_market_overview\",\n  \"description\": \"Get market overview: breadth, hot concepts, major indices.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"market\": { \"type\": \"string\", \"enum\": [\"CN\", \"US\"], \"default\": \"CN\" }\n    }\n  }\n}"
      },
      {
        "title": "gprophet_analyze_stock",
        "body": "{\n  \"name\": \"gprophet_analyze_stock\",\n  \"description\": \"Run AI stock analysis report (58 points, async). Returns task_id for polling via gprophet_task_status. Supports US, CN, CRYPTO markets.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"CRYPTO\"] },\n      \"locale\": { \"type\": \"string\", \"enum\": [\"zh-CN\", \"en-US\"], \"default\": \"en-US\" }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}"
      },
      {
        "title": "gprophet_analyze_comprehensive",
        "body": "{\n  \"name\": \"gprophet_analyze_comprehensive\",\n  \"description\": \"Run multi-agent comprehensive analysis (150 points, async). Returns task_id for polling via gprophet_task_status. Evaluates from 5 dimensions: technical, fundamental, capital flow, sentiment, macro.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] },\n      \"locale\": { \"type\": \"string\", \"enum\": [\"zh-CN\", \"en-US\"], \"default\": \"en-US\" }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}"
      },
      {
        "title": "gprophet_task_status",
        "body": "{\n  \"name\": \"gprophet_task_status\",\n  \"description\": \"Check the status of an async analysis task. Poll every 5 seconds until status is 'completed' or 'failed'.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"task_id\": { \"type\": \"string\", \"description\": \"Task ID returned by analysis endpoints\" }\n    },\n    \"required\": [\"task_id\"]\n  }\n}"
      },
      {
        "title": "gprophet_balance",
        "body": "{\n  \"name\": \"gprophet_balance\",\n  \"description\": \"Check current points balance, quota usage, and API key info. Free.\",\n  \"inputSchema\": { \"type\": \"object\", \"properties\": {}, \"required\": [] }\n}"
      },
      {
        "title": "gprophet_info",
        "body": "{\n  \"name\": \"gprophet_info\",\n  \"description\": \"Get API metadata: supported markets, algorithms, pricing table. Free.\",\n  \"inputSchema\": { \"type\": \"object\", \"properties\": {}, \"required\": [] }\n}"
      },
      {
        "title": "Typical Prediction Flow",
        "body": "1. Call gprophet_predict to get prediction results (sync, typically 5-30 seconds)\n2. Use data.direction and data.confidence to assess the trend\n3. Optional: Call gprophet_technical for technical confirmation"
      },
      {
        "title": "Typical Stock Analysis Flow",
        "body": "1. Call gprophet_analyze_stock to submit analysis task → get task_id\n2. Poll gprophet_task_status every 5 seconds\n3. When status = \"completed\", read the analysis report from result\n4. When status = \"failed\", read the failure reason from error"
      },
      {
        "title": "Typical Deep Analysis Flow",
        "body": "1. Call gprophet_analyze_comprehensive to submit analysis task → get task_id\n2. Poll gprophet_task_status every 5 seconds\n3. When status = \"completed\", read the full report from result.analysis\n4. When status = \"failed\", read the failure reason from error"
      },
      {
        "title": "Webhook Integration Flow",
        "body": "1. Call POST /analysis/stock or /analysis/comprehensive with callback_url\n2. Continue processing other tasks (no need to poll)\n3. Receive POST to your callback_url when task completes or fails\n4. Verify task_id and process the result"
      },
      {
        "title": "Agent Integration Tips",
        "body": "Search before predicting: If unsure about a ticker, use gprophet_search to confirm first\nCombine skills: Prediction + Technical Analysis + Sentiment = more comprehensive judgment\nPoints management: Use gprophet_balance to check points before expensive operations\nBatch operations: Use gprophet_batch_quote instead of multiple single quotes to save API calls\nError handling: Check the success field; on failure, refer to error.code for retry logic\nRate limiting: Respect X-RateLimit-Remaining header; back off when approaching 0\nWebhooks: Use callback_url for analysis tasks to avoid polling overhead"
      },
      {
        "title": "Python SDK",
        "body": "Install the official Python SDK for easier integration:\n\npip install gprophet\n\nfrom gprophet import GProphet\n\nclient = GProphet(api_key=\"gp_sk_...\")\n\n# Predict stock price\nresult = client.predict(\"AAPL\", market=\"US\", days=7)\n\n# Batch quote\nquotes = client.batch_quote([\"AAPL\", \"TSLA\", \"GOOGL\"], market=\"US\")\n\n# Stock analysis (auto-polls until complete)\nanalysis = client.analyze_stock(\"AAPL\", market=\"US\", wait=True)\n\n# Check balance\nbalance = client.balance()"
      },
      {
        "title": "MCP Server",
        "body": "Run the standalone MCP server for AI agent integration:\n\n{\n  \"mcpServers\": {\n    \"gprophet\": {\n      \"command\": \"python\",\n      \"args\": [\"path/to/gprophet_mcp_server.py\"],\n      \"env\": { \"GPROPHET_API_KEY\": \"gp_sk_...\" }\n    }\n  }\n}"
      },
      {
        "title": "Supported Market Codes",
        "body": "CodeMarketTicker FormatExample TickersCNChina A-shares6-digit number. 6xxxxx=Shanghai, 0/3xxxxx=Shenzhen600519, 000001, 300750USUS StocksAlphabetic ticker symbolAAPL, TSLA, GOOGL, MSFTHKHong Kong StocksNumeric code (no zero-padding needed)700, 9988, 1810, 3007CRYPTOCryptocurrencyTrading pair (ending in USDT)BTCUSDT, ETHUSDT, SOLUSDT\n\n⚠️ A-share Ticker Notes:\n\nA-share tickers are 6-digit numbers; different prefixes indicate different exchanges/boards\n6xxxxx = Shanghai Stock Exchange (Main Board / STAR Market)\n0xxxxx = Shenzhen Stock Exchange (Main Board / SME Board)\n3xxxxx = Shenzhen Stock Exchange (ChiNext / Growth Enterprise Market)\nMake sure to pass the correct 6-digit code, e.g. 600986 and 000001 are different stocks"
      },
      {
        "title": "Supported Prediction Algorithms",
        "body": "AlgorithmDescriptionautoAutomatically select the best algorithmgprophet2026v1G-Prophet2026V1 proprietary model (recommended)lstmLong Short-Term Memory networktransformerTransformer modelrandom_forestRandom ForestensembleEnsemble learning (multi-algorithm fusion)"
      }
    ],
    "body": "G-Prophet AI Skills Documentation\n\nStock prediction and market analysis capabilities for AI agents\n\nOverview\n\nG-Prophet is an AI-powered stock prediction platform that exposes its core capabilities through an external API for other AI agent systems. It supports global markets (China A-shares, US stocks, HK stocks, Crypto) and provides AI prediction, technical analysis, market sentiment, and deep analysis Skills.\n\nBasic Information\nItem\tDescription\nAPI Base URL\thttps://www.gprophet.com/api/external/v1\nAuthentication\tX-API-Key header\nKey Format\tgp_sk_ prefix (e.g. gp_sk_[REDACTED]_a1b2c3...)\nResponse Format\tJSON\nBilling\tPoints-based, each call consumes corresponding points\nAuthentication\n\nAll requests must include an API Key in the HTTP header:\n\nX-API-Key: gp_sk_[REDACTED]_your_api_key_here\n\n\nAPI Keys can be created in the G-Prophet platform under \"Settings → API Key Management\".\n\nSecurity Recommendations\nStore API keys in environment variables (GPROPHET_API_KEY), not in code\nUse test/limited-scope keys for development and evaluation\nMonitor usage and billing regularly at https://www.gprophet.com/dashboard\nRotate keys periodically and revoke compromised keys immediately\nNever commit API keys to version control or share them publicly\nRate Limiting\n\nAll API requests are subject to per-key rate limiting (fixed window, per minute).\n\nHeader\tDescription\nX-RateLimit-Limit\tMaximum requests allowed per minute\nX-RateLimit-Remaining\tRemaining requests in current window\nX-RateLimit-Reset\tSeconds until the rate limit window resets\n\nDefault limit is 60 requests per minute per API Key. When exceeded, the API returns HTTP 429:\n\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"RATE_LIMITED\",\n    \"message\": \"Rate limit exceeded. Max 60 requests per minute.\",\n    \"details\": {\n      \"limit_per_minute\": 60,\n      \"retry_after_seconds\": 45\n    }\n  }\n}\n\n\nThe response includes a Retry-After header indicating how many seconds to wait.\n\nQuota Management\n\nEach API Key has configurable daily and monthly call quotas. Quota = 0 means unlimited.\n\nWhen quota is exceeded, the API returns HTTP 429:\n\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"QUOTA_EXCEEDED\",\n    \"message\": \"Daily quota exceeded (100/100)\",\n    \"details\": {\n      \"resolution\": \"Upgrade your plan or wait for quota reset.\"\n    }\n  }\n}\n\n\nCheck your current quota usage via GET /account/balance.\n\nUnified Response Format\nSuccess Response\n{\n  \"success\": true,\n  \"data\": { ... },\n  \"metadata\": {\n    \"request_id\": \"req_abc123\",\n    \"timestamp\": \"2026-02-18T10:30:00Z\",\n    \"processing_time_ms\": 1250,\n    \"api_version\": \"v1\"\n  },\n  \"error\": null\n}\n\nError Response\n\nErrors return the appropriate HTTP status code (401, 402, 403, 404, 429, 500, 503) along with a JSON body:\n\n{\n  \"success\": false,\n  \"data\": null,\n  \"metadata\": { ... },\n  \"error\": {\n    \"code\": \"INVALID_SYMBOL\",\n    \"message\": \"Stock symbol 'XXXXX' not found\",\n    \"details\": {}\n  }\n}\n\nInsufficient Points Response (402)\n\nWhen points are insufficient, the API returns a detailed 402 response with actionable guidance:\n\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INSUFFICIENT_POINTS\",\n    \"message\": \"Insufficient points. Required: 20, available: 5.\",\n    \"details\": {\n      \"required\": 20,\n      \"available\": 5,\n      \"shortage\": 15,\n      \"resolution\": {\n        \"actions\": [\n          { \"action\": \"register\", \"url\": \"https://gprophet.com/register\" },\n          { \"action\": \"recharge\", \"url\": \"https://gprophet.com/membership\" },\n          { \"action\": \"subscribe\", \"url\": \"https://gprophet.com/membership\" }\n        ]\n      }\n    }\n  }\n}\n\nPoints Cost\nSkill\tEndpoint\tPoints/Call\nStock Prediction\tPOST /predictions/predict\tCN 10, HK 15, US 20, Crypto 20\nAlgorithm Compare\tPOST /predictions/compare\tSingle prediction cost × number of algorithms\nQuote\tGET /market-data/quote\t5\nHistory\tGET /market-data/history\t5\nSearch\tGET /market-data/search\t5\nBatch Quote\tPOST /market-data/batch-quote\t5 × number of symbols\nTechnical Analysis\tPOST /technical/analyze\t5\nFear & Greed Index\tGET /sentiment/fear-greed\t5\nMarket Overview\tGET /sentiment/market-overview\t5\nAI Stock Analysis\tPOST /analysis/stock\t58\nDeep Analysis\tPOST /analysis/comprehensive\t150\nTask Polling\tGET /analysis/task/{task_id}\t0 (free)\nAccount Balance\tGET /account/balance\t0 (free)\nUsage Statistics\tGET /account/usage\t0 (free)\nAPI Info\tGET /info\t0 (free)\nSkill 1: Stock Price Prediction\n\nPredict future stock/cryptocurrency price movements using AI algorithms. Supports G-Prophet2026V1, LSTM, Transformer, and more.\n\nPOST /predictions/predict\n\nRequest Body (JSON):\n\nParameter\tType\tRequired\tDefault\tDescription\nsymbol\tstring\t✅\t-\tStock/crypto ticker (e.g. AAPL, 600519, BTCUSDT)\nmarket\tstring\t✅\t-\tMarket code: US, CN, HK, CRYPTO\ndays\tinteger\tNo\t7\tPrediction days, range 1-30\nalgorithm\tstring\tNo\tauto\tAlgorithm: auto, gprophet2026v1, lstm, transformer, random_forest, ensemble\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/predictions/predict\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"AAPL\", \"market\": \"US\", \"days\": 7, \"algorithm\": \"auto\"}'\n\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"AAPL\",\n    \"name\": \"Apple Inc.\",\n    \"market\": \"US\",\n    \"current_price\": 185.50,\n    \"predicted_price\": 191.20,\n    \"change_percent\": 3.07,\n    \"direction\": \"up\",\n    \"confidence\": 0.78,\n    \"prediction_days\": 7,\n    \"algorithm_used\": \"gprophet2026v1\",\n    \"data_quality\": {\n      \"completeness\": 1.0,\n      \"anomaly_count\": 82,\n      \"missing_values\": 0,\n      \"overall_score\": 80\n    },\n    \"points_consumed\": 20\n  }\n}\n\nPOST /predictions/compare\n\nMulti-algorithm comparison prediction. Returns results from each algorithm and the best recommendation. Points cost = single prediction cost × number of algorithms.\n\nRequest Body (JSON):\n\nParameter\tType\tRequired\tDefault\tDescription\nsymbol\tstring\t✅\t-\tStock/crypto ticker\nmarket\tstring\t✅\t-\tMarket code: US, CN, HK, CRYPTO\ndays\tinteger\tNo\t5\tPrediction days, range 1-30\nalgorithms\tstring[]\tNo\t[\"gprophet2026v1\",\"lstm\",\"transformer\",\"ensemble\"]\tAlgorithm list, max 6\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/predictions/compare\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"TSLA\", \"market\": \"US\", \"days\": 5, \"algorithms\": [\"gprophet2026v1\", \"lstm\", \"transformer\"]}'\n\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"TSLA\",\n    \"name\": \"Tesla Inc.\",\n    \"market\": \"US\",\n    \"current_price\": 245.00,\n    \"prediction_days\": 5,\n    \"results\": [\n      {\n        \"algorithm\": \"gprophet2026v1\",\n        \"predicted_price\": 252.30,\n        \"change_percent\": 2.98,\n        \"direction\": \"up\",\n        \"confidence\": 0.82,\n        \"success\": true\n      },\n      {\n        \"algorithm\": \"lstm\",\n        \"predicted_price\": 248.10,\n        \"change_percent\": 1.27,\n        \"direction\": \"up\",\n        \"confidence\": 0.71,\n        \"success\": true\n      }\n    ],\n    \"best_algorithm\": \"gprophet2026v1\",\n    \"consensus_direction\": \"up\",\n    \"average_predicted_price\": 250.20,\n    \"points_consumed\": 60\n  }\n}\n\nSkill 2: Market Data\n\nGet real-time quotes, historical OHLCV data, search for stocks/crypto, and batch quotes. Each call costs 5 points (batch = 5 × count).\n\nGET /market-data/quote\n\nGet real-time quote.\n\nQuery Parameters:\n\nParameter\tType\tRequired\tDescription\nsymbol\tstring\t✅\tStock/crypto ticker\nmarket\tstring\t✅\tMarket code: US, CN, HK, CRYPTO\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/market-data/quote?symbol=AAPL&market=US\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"name\": \"Apple Inc.\",\n    \"price\": 185.50,\n    \"open\": 183.90,\n    \"high\": 186.80,\n    \"low\": 183.20,\n    \"volume\": 52340000,\n    \"previous_close\": 183.20,\n    \"change\": 2.30,\n    \"change_percent\": 1.26,\n    \"points_consumed\": 5\n  }\n}\n\nGET /market-data/history\n\nGet historical OHLCV candlestick data.\n\nQuery Parameters:\n\nParameter\tType\tRequired\tDefault\tDescription\nsymbol\tstring\t✅\t-\tStock/crypto ticker\nmarket\tstring\t✅\t-\tMarket code\nperiod\tstring\tNo\t3m\tTime range: 1w, 1m, 3m, 6m, 1y, 2y\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/market-data/history?symbol=AAPL&market=US&period=3m\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"period\": \"3m\",\n    \"data_points\": 63,\n    \"history\": [\n      {\n        \"date\": \"2025-12-01\",\n        \"open\": 178.50,\n        \"high\": 180.20,\n        \"low\": 177.80,\n        \"close\": 179.90,\n        \"volume\": 48500000\n      }\n    ],\n    \"points_consumed\": 5\n  }\n}\n\nGET /market-data/search\n\nSearch for stocks/crypto by keyword.\n\nQuery Parameters:\n\nParameter\tType\tRequired\tDefault\tDescription\nkeyword\tstring\t✅\t-\tSearch keyword\nmarket\tstring\tNo\tUS\tMarket code\nlimit\tinteger\tNo\t10\tResult count, range 1-50\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/market-data/search?keyword=apple&market=US&limit=5\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\nPOST /market-data/batch-quote\n\nGet quotes for multiple symbols in a single request. Max 20 symbols. Cost = 5 points × number of symbols.\n\nRequest Body (JSON):\n\nParameter\tType\tRequired\tDescription\nsymbols\tstring[]\t✅\tList of stock/crypto tickers (max 20)\nmarket\tstring\t✅\tMarket code: US, CN, HK, CRYPTO\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/market-data/batch-quote\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbols\": [\"AAPL\", \"TSLA\", \"GOOGL\"], \"market\": \"US\"}'\n\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"market\": \"US\",\n    \"count\": 3,\n    \"successful\": 3,\n    \"results\": [\n      {\n        \"symbol\": \"AAPL\",\n        \"name\": \"Apple Inc.\",\n        \"success\": true,\n        \"price\": 185.50,\n        \"change\": 2.30,\n        \"change_percent\": 1.26\n      },\n      {\n        \"symbol\": \"TSLA\",\n        \"name\": \"Tesla Inc.\",\n        \"success\": true,\n        \"price\": 245.00,\n        \"change\": -3.20,\n        \"change_percent\": -1.29\n      },\n      {\n        \"symbol\": \"GOOGL\",\n        \"name\": \"Alphabet Inc.\",\n        \"success\": true,\n        \"price\": 142.80,\n        \"change\": 1.10,\n        \"change_percent\": 0.78\n      }\n    ],\n    \"points_consumed\": 15\n  }\n}\n\nSkill 3: Technical Analysis\n\nCalculate technical indicators and generate trading signals for a given stock. Each call costs 5 points.\n\nPOST /technical/analyze\n\nRequest Body (JSON):\n\nParameter\tType\tRequired\tDefault\tDescription\nsymbol\tstring\t✅\t-\tStock/crypto ticker\nmarket\tstring\t✅\t-\tMarket code: US, CN, HK, CRYPTO\nindicators\tstring[]\tNo\t[\"rsi\",\"macd\",\"bollinger\",\"kdj\"]\tIndicators: rsi, macd, bollinger, kdj, sma, ema\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/technical/analyze\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"AAPL\", \"market\": \"US\", \"indicators\": [\"rsi\", \"macd\", \"bollinger\", \"kdj\"]}'\n\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"current_price\": 185.50,\n    \"indicators\": {\n      \"rsi_14\": { \"value\": 55.3, \"signal\": \"neutral\" },\n      \"macd\": { \"macd\": 1.25, \"signal\": 0.98, \"histogram\": 0.27, \"signal_type\": \"bullish\" },\n      \"bollinger\": { \"upper\": 192.0, \"middle\": 185.0, \"lower\": 178.0, \"position\": 0.54 },\n      \"kdj\": { \"k\": 65.2, \"d\": 58.7, \"j\": 78.2 }\n    },\n    \"signals\": [\n      { \"type\": \"bullish\", \"indicator\": \"MACD\" },\n      { \"type\": \"neutral\", \"indicator\": \"RSI\" }\n    ],\n    \"overall_signal\": \"bullish\",\n    \"signal_strength\": 0.5,\n    \"points_consumed\": 5\n  }\n}\n\nSkill 4: Market Sentiment\n\nGet market sentiment data including Fear & Greed Index and market overview. Each call costs 5 points.\n\nGET /sentiment/fear-greed\n\nGet the crypto market Fear & Greed Index.\n\nQuery Parameters:\n\nParameter\tType\tRequired\tDefault\tDescription\ndays\tinteger\tNo\t1\tHistory days, 1=current only, range 1-365\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/sentiment/fear-greed?days=1\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"value\": 72,\n    \"classification\": \"greed\",\n    \"previous_value\": 68,\n    \"change\": 4,\n    \"points_consumed\": 5\n  }\n}\n\nGET /sentiment/market-overview\n\nGet comprehensive market overview (breadth, hot sectors, major indices).\n\nQuery Parameters:\n\nParameter\tType\tRequired\tDefault\tDescription\nmarket\tstring\tNo\tCN\tMarket code: CN, US\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/sentiment/market-overview?market=CN\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\nSkill 5: AI Stock Analysis (Async)\n\nSingle-stock AI analysis report using LLM. Costs 58 points. Supports CN, US, CRYPTO markets.\n\n⚠️ Async Mode: Analysis typically takes 15-60 seconds, so this endpoint uses async mode.\n\nPOST /analysis/stock → Returns task_id immediately\nGET /analysis/task/{task_id} → Poll for status; get results when status=completed\n\nRecommended polling interval: 5 seconds. Max wait: 5 minutes.\n\nPOST /analysis/stock\n\nSubmit a stock analysis task. Returns task ID immediately.\n\nRequest Body (JSON):\n\nParameter\tType\tRequired\tDefault\tDescription\nsymbol\tstring\t✅\t-\tStock/crypto ticker\nmarket\tstring\t✅\t-\tMarket code: US, CN, CRYPTO\nlocale\tstring\tNo\tzh-CN\tReport language: zh-CN, en-US\ncallback_url\tstring\tNo\t-\tWebhook URL; results are POSTed on completion\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/analysis/stock\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"AAPL\", \"market\": \"US\", \"locale\": \"en-US\"}'\n\n\nExample Response (immediate):\n\n{\n  \"success\": true,\n  \"data\": {\n    \"task_id\": \"task_abc123def456\",\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"status\": \"pending\",\n    \"points_consumed\": 58,\n    \"poll_url\": \"/api/external/v1/analysis/task/task_abc123def456\",\n    \"callback_url\": null,\n    \"message\": \"Stock analysis started. Poll the task URL every 5 seconds for results.\"\n  }\n}\n\nSkill 6: Deep Analysis (Async)\n\nMulti-agent collaborative deep analysis evaluating stocks from 5 dimensions: technical, fundamental, capital flow, sentiment, and macro environment. Costs 150 points.\n\n⚠️ Async Mode: Deep analysis typically takes 30-120 seconds, so this endpoint uses async mode.\n\nPOST /analysis/comprehensive → Returns task_id immediately\nGET /analysis/task/{task_id} → Poll for status; get results when status=completed\n\nRecommended polling interval: 5 seconds. Max wait: 5 minutes.\n\nPOST /analysis/comprehensive\n\nSubmit a deep analysis task. Returns task ID immediately.\n\nRequest Body (JSON):\n\nParameter\tType\tRequired\tDefault\tDescription\nsymbol\tstring\t✅\t-\tStock/crypto ticker\nmarket\tstring\t✅\t-\tMarket code: US, CN, HK, CRYPTO\nlocale\tstring\tNo\tzh-CN\tReport language: zh-CN, en-US\ncallback_url\tstring\tNo\t-\tWebhook URL; results are POSTed on completion\n\nExample Request:\n\ncurl -X POST \"https://www.gprophet.com/api/external/v1/analysis/comprehensive\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"symbol\": \"AAPL\", \"market\": \"US\", \"locale\": \"en-US\"}'\n\n\nExample Response (immediate):\n\n{\n  \"success\": true,\n  \"data\": {\n    \"task_id\": \"task_abc123def456\",\n    \"symbol\": \"AAPL\",\n    \"market\": \"US\",\n    \"status\": \"pending\",\n    \"points_consumed\": 150,\n    \"poll_url\": \"/api/external/v1/analysis/task/task_abc123def456\",\n    \"callback_url\": null,\n    \"message\": \"Analysis started. Poll the task URL every 5 seconds for results.\"\n  }\n}\n\nWebhook Callback\n\nBoth /analysis/stock and /analysis/comprehensive accept an optional callback_url parameter. When provided, the API will POST the task result to that URL upon completion or failure:\n\nCallback Payload (success):\n\n{\n  \"task_id\": \"task_abc123def456\",\n  \"status\": \"completed\",\n  \"result\": { ... }\n}\n\n\nCallback Payload (failure):\n\n{\n  \"task_id\": \"task_abc123def456\",\n  \"status\": \"failed\",\n  \"error\": \"Analysis service timeout\"\n}\n\nGET /analysis/task/{task_id}\n\nPoll analysis task status and results.\n\nPath Parameters:\n\nParameter\tType\tDescription\ntask_id\tstring\tTask ID returned by analysis endpoints\n\nStatus Flow: pending → running (progress 0-100) → completed / failed\n\nExample Response (completed):\n\n{\n  \"success\": true,\n  \"data\": {\n    \"task_id\": \"task_abc123def456\",\n    \"status\": \"completed\",\n    \"progress\": 100,\n    \"message\": \"Analysis completed\",\n    \"result\": {\n      \"symbol\": \"AAPL\",\n      \"asset_type\": \"stock_us\",\n      \"analysis\": {\n        \"overall_rating\": \"bullish\",\n        \"confidence\": 0.75,\n        \"agents\": {\n          \"technical\": { \"rating\": \"bullish\", \"confidence\": 0.80 },\n          \"fundamental\": { \"rating\": \"neutral\", \"confidence\": 0.65 },\n          \"capital_flow\": { \"rating\": \"bullish\", \"confidence\": 0.70 },\n          \"sentiment\": { \"rating\": \"neutral\", \"confidence\": 0.60 },\n          \"macro\": { \"rating\": \"cautious\", \"confidence\": 0.55 }\n        },\n        \"final_recommendation\": \"Short-term bullish, consider buying on dips\",\n        \"risk_level\": \"medium\"\n      }\n    },\n    \"error\": null\n  }\n}\n\nAccount Endpoints\nGET /account/balance\n\nCheck current API Key's points balance and quota usage. Free, no points consumed.\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/account/balance\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"available_points\": 1250,\n    \"key_name\": \"My Trading Bot\",\n    \"key_prefix\": \"gp_sk_abc\",\n    \"scopes\": [\"predictions\", \"market_data\", \"technical\", \"sentiment\", \"analysis\"],\n    \"rate_limit_per_minute\": 60,\n    \"daily_quota\": 1000,\n    \"daily_used\": 42,\n    \"monthly_quota\": 0,\n    \"monthly_used\": 856\n  }\n}\n\nGET /account/usage\n\nGet call history statistics for the current API Key. Free, no points consumed.\n\nQuery Parameters:\n\nParameter\tType\tRequired\tDefault\tDescription\ndays\tinteger\tNo\t7\tHistory days, range 1-90\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/account/usage?days=7\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\n\nExample Response:\n\n{\n  \"success\": true,\n  \"data\": {\n    \"key_prefix\": \"gp_sk_abc\",\n    \"period_days\": 7,\n    \"daily\": [\n      {\n        \"date\": \"2026-03-09\",\n        \"total_calls\": 85,\n        \"success_calls\": 82,\n        \"avg_response_ms\": 1250\n      }\n    ],\n    \"by_endpoint\": [\n      { \"endpoint\": \"/api/external/v1/predictions/predict\", \"calls\": 45 },\n      { \"endpoint\": \"/api/external/v1/market-data/quote\", \"calls\": 30 }\n    ]\n  }\n}\n\nGET /info\n\nGet API metadata: supported markets, algorithms, pricing table, authentication info. Free, no points consumed.\n\nExample Request:\n\ncurl \"https://www.gprophet.com/api/external/v1/info\" \\\n  -H \"X-API-Key: gp_sk_[REDACTED]_your_key\"\n\nError Codes\nCode\tHTTP Status\tDescription\nMISSING_API_KEY\t401\tMissing X-API-Key header\nINVALID_KEY_FORMAT\t401\tInvalid API Key format (must start with gp_sk_)\nINVALID_API_KEY\t401\tInvalid API Key\nAPI_KEY_DISABLED\t403\tAPI Key has been disabled\nAPI_KEY_EXPIRED\t403\tAPI Key has expired\nINSUFFICIENT_SCOPE\t403\tAPI Key lacks permission for this Skill\nINSUFFICIENT_POINTS\t402\tInsufficient points\nPOINTS_DEDUCTION_FAILED\t500\tFailed to deduct points\nOWNER_NOT_FOUND\t403\tAPI Key owner account not found\nRATE_LIMITED\t429\tRequest frequency exceeded per-minute limit\nQUOTA_EXCEEDED\t429\tDaily or monthly call quota exhausted\nINVALID_MARKET\t400\tUnsupported market code\nUNSUPPORTED_MARKET\t400\tMarket not supported for this endpoint\nSYMBOL_NOT_FOUND\t404\tStock/crypto ticker not found\nNO_DATA\t404\tUnable to retrieve data\nTOO_MANY_ALGORITHMS\t400\tToo many algorithms (max 6)\nPREDICTION_FAILED\t500\tPrediction service error\nANALYSIS_FAILED\t500\tAnalysis service error\nTASK_NOT_FOUND\t404\tAsync task not found or expired\nFORBIDDEN\t403\tAccess denied (e.g. querying another user's task)\nDATA_UNAVAILABLE\t503\tData source temporarily unavailable\nINTERNAL_ERROR\t500\tInternal service error\nMCP Tools Definitions\n\nMCP (Model Context Protocol) tool definitions for use with Claude, Kiro, and other MCP-compatible agents:\n\ngprophet_predict\n{\n  \"name\": \"gprophet_predict\",\n  \"description\": \"Predict stock/crypto price using AI. Markets: US, CN, HK, CRYPTO. Algorithms: auto, gprophet2026v1, lstm, transformer, random_forest, ensemble. IMPORTANT: The response includes 'symbol', 'name' (official stock name), and 'market' fields — always use these values directly, never infer or fabricate the stock name from the symbol.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\", \"description\": \"Stock/crypto symbol (e.g., AAPL, 600519, BTCUSDT)\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] },\n      \"days\": { \"type\": \"integer\", \"minimum\": 1, \"maximum\": 30, \"default\": 7 },\n      \"algorithm\": { \"type\": \"string\", \"default\": \"auto\" }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}\n\ngprophet_quote\n{\n  \"name\": \"gprophet_quote\",\n  \"description\": \"Get real-time stock/crypto quote.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\", \"description\": \"Stock/crypto symbol\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}\n\ngprophet_batch_quote\n{\n  \"name\": \"gprophet_batch_quote\",\n  \"description\": \"Get quotes for multiple symbols at once (max 20). Cost = 5 points × number of symbols.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbols\": { \"type\": \"array\", \"items\": { \"type\": \"string\" }, \"description\": \"List of symbols (max 20)\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] }\n    },\n    \"required\": [\"symbols\", \"market\"]\n  }\n}\n\ngprophet_history\n{\n  \"name\": \"gprophet_history\",\n  \"description\": \"Get historical OHLCV price data.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] },\n      \"period\": { \"type\": \"string\", \"enum\": [\"1w\", \"1m\", \"3m\", \"6m\", \"1y\", \"2y\"], \"default\": \"3m\" }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}\n\ngprophet_search\n{\n  \"name\": \"gprophet_search\",\n  \"description\": \"Search for stocks/crypto by keyword.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"keyword\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"], \"default\": \"US\" },\n      \"limit\": { \"type\": \"integer\", \"minimum\": 1, \"maximum\": 50, \"default\": 10 }\n    },\n    \"required\": [\"keyword\"]\n  }\n}\n\ngprophet_technical\n{\n  \"name\": \"gprophet_technical\",\n  \"description\": \"Calculate technical indicators (RSI, MACD, Bollinger, KDJ, SMA, EMA) and generate trading signals.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] },\n      \"indicators\": { \"type\": \"array\", \"items\": { \"type\": \"string\", \"enum\": [\"rsi\", \"macd\", \"bollinger\", \"kdj\", \"sma\", \"ema\"] }, \"default\": [\"rsi\", \"macd\", \"bollinger\", \"kdj\"] }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}\n\ngprophet_fear_greed\n{\n  \"name\": \"gprophet_fear_greed\",\n  \"description\": \"Get crypto market Fear & Greed Index.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"days\": { \"type\": \"integer\", \"minimum\": 1, \"maximum\": 365, \"default\": 1 }\n    }\n  }\n}\n\ngprophet_market_overview\n{\n  \"name\": \"gprophet_market_overview\",\n  \"description\": \"Get market overview: breadth, hot concepts, major indices.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"market\": { \"type\": \"string\", \"enum\": [\"CN\", \"US\"], \"default\": \"CN\" }\n    }\n  }\n}\n\ngprophet_analyze_stock\n{\n  \"name\": \"gprophet_analyze_stock\",\n  \"description\": \"Run AI stock analysis report (58 points, async). Returns task_id for polling via gprophet_task_status. Supports US, CN, CRYPTO markets.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"CRYPTO\"] },\n      \"locale\": { \"type\": \"string\", \"enum\": [\"zh-CN\", \"en-US\"], \"default\": \"en-US\" }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}\n\ngprophet_analyze_comprehensive\n{\n  \"name\": \"gprophet_analyze_comprehensive\",\n  \"description\": \"Run multi-agent comprehensive analysis (150 points, async). Returns task_id for polling via gprophet_task_status. Evaluates from 5 dimensions: technical, fundamental, capital flow, sentiment, macro.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"symbol\": { \"type\": \"string\" },\n      \"market\": { \"type\": \"string\", \"enum\": [\"US\", \"CN\", \"HK\", \"CRYPTO\"] },\n      \"locale\": { \"type\": \"string\", \"enum\": [\"zh-CN\", \"en-US\"], \"default\": \"en-US\" }\n    },\n    \"required\": [\"symbol\", \"market\"]\n  }\n}\n\ngprophet_task_status\n{\n  \"name\": \"gprophet_task_status\",\n  \"description\": \"Check the status of an async analysis task. Poll every 5 seconds until status is 'completed' or 'failed'.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"task_id\": { \"type\": \"string\", \"description\": \"Task ID returned by analysis endpoints\" }\n    },\n    \"required\": [\"task_id\"]\n  }\n}\n\ngprophet_balance\n{\n  \"name\": \"gprophet_balance\",\n  \"description\": \"Check current points balance, quota usage, and API key info. Free.\",\n  \"inputSchema\": { \"type\": \"object\", \"properties\": {}, \"required\": [] }\n}\n\ngprophet_info\n{\n  \"name\": \"gprophet_info\",\n  \"description\": \"Get API metadata: supported markets, algorithms, pricing table. Free.\",\n  \"inputSchema\": { \"type\": \"object\", \"properties\": {}, \"required\": [] }\n}\n\nIntegration Guide\nTypical Prediction Flow\n1. Call gprophet_predict to get prediction results (sync, typically 5-30 seconds)\n2. Use data.direction and data.confidence to assess the trend\n3. Optional: Call gprophet_technical for technical confirmation\n\nTypical Stock Analysis Flow\n1. Call gprophet_analyze_stock to submit analysis task → get task_id\n2. Poll gprophet_task_status every 5 seconds\n3. When status = \"completed\", read the analysis report from result\n4. When status = \"failed\", read the failure reason from error\n\nTypical Deep Analysis Flow\n1. Call gprophet_analyze_comprehensive to submit analysis task → get task_id\n2. Poll gprophet_task_status every 5 seconds\n3. When status = \"completed\", read the full report from result.analysis\n4. When status = \"failed\", read the failure reason from error\n\nWebhook Integration Flow\n1. Call POST /analysis/stock or /analysis/comprehensive with callback_url\n2. Continue processing other tasks (no need to poll)\n3. Receive POST to your callback_url when task completes or fails\n4. Verify task_id and process the result\n\nAgent Integration Tips\nSearch before predicting: If unsure about a ticker, use gprophet_search to confirm first\nCombine skills: Prediction + Technical Analysis + Sentiment = more comprehensive judgment\nPoints management: Use gprophet_balance to check points before expensive operations\nBatch operations: Use gprophet_batch_quote instead of multiple single quotes to save API calls\nError handling: Check the success field; on failure, refer to error.code for retry logic\nRate limiting: Respect X-RateLimit-Remaining header; back off when approaching 0\nWebhooks: Use callback_url for analysis tasks to avoid polling overhead\nPython SDK\n\nInstall the official Python SDK for easier integration:\n\npip install gprophet\n\nfrom gprophet import GProphet\n\nclient = GProphet(api_key=\"gp_sk_...\")\n\n# Predict stock price\nresult = client.predict(\"AAPL\", market=\"US\", days=7)\n\n# Batch quote\nquotes = client.batch_quote([\"AAPL\", \"TSLA\", \"GOOGL\"], market=\"US\")\n\n# Stock analysis (auto-polls until complete)\nanalysis = client.analyze_stock(\"AAPL\", market=\"US\", wait=True)\n\n# Check balance\nbalance = client.balance()\n\nMCP Server\n\nRun the standalone MCP server for AI agent integration:\n\n{\n  \"mcpServers\": {\n    \"gprophet\": {\n      \"command\": \"python\",\n      \"args\": [\"path/to/gprophet_mcp_server.py\"],\n      \"env\": { \"GPROPHET_API_KEY\": \"gp_sk_...\" }\n    }\n  }\n}\n\nSupported Market Codes\nCode\tMarket\tTicker Format\tExample Tickers\nCN\tChina A-shares\t6-digit number. 6xxxxx=Shanghai, 0/3xxxxx=Shenzhen\t600519, 000001, 300750\nUS\tUS Stocks\tAlphabetic ticker symbol\tAAPL, TSLA, GOOGL, MSFT\nHK\tHong Kong Stocks\tNumeric code (no zero-padding needed)\t700, 9988, 1810, 3007\nCRYPTO\tCryptocurrency\tTrading pair (ending in USDT)\tBTCUSDT, ETHUSDT, SOLUSDT\n\n⚠️ A-share Ticker Notes:\n\nA-share tickers are 6-digit numbers; different prefixes indicate different exchanges/boards\n6xxxxx = Shanghai Stock Exchange (Main Board / STAR Market)\n0xxxxx = Shenzhen Stock Exchange (Main Board / SME Board)\n3xxxxx = Shenzhen Stock Exchange (ChiNext / Growth Enterprise Market)\nMake sure to pass the correct 6-digit code, e.g. 600986 and 000001 are different stocks\nSupported Prediction Algorithms\nAlgorithm\tDescription\nauto\tAutomatically select the best algorithm\ngprophet2026v1\tG-Prophet2026V1 proprietary model (recommended)\nlstm\tLong Short-Term Memory network\ntransformer\tTransformer model\nrandom_forest\tRandom Forest\nensemble\tEnsemble learning (multi-algorithm fusion)"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/filwu8/gprophet-api",
    "publisherUrl": "https://clawhub.ai/filwu8/gprophet-api",
    "owner": "filwu8",
    "version": "1.0.6",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/gprophet-api",
    "downloadUrl": "https://openagent3.xyz/downloads/gprophet-api",
    "agentUrl": "https://openagent3.xyz/skills/gprophet-api/agent",
    "manifestUrl": "https://openagent3.xyz/skills/gprophet-api/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/gprophet-api/agent.md"
  }
}