gprophet-api

G-Prophet AI Skills Documentation

Stock prediction and market analysis capabilities for AI agents

Overview

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.

Basic Information

Item	Description
API Base URL	https://www.gprophet.com/api/external/v1
Authentication	X-API-Key header
Key Format	gp_sk_ prefix (e.g. gp_sk_live_a1b2c3...)
Response Format	JSON
Billing	Points-based, each call consumes corresponding points

Authentication

All requests must include an API Key in the HTTP header:

X-API-Key: gp_sk_live_your_api_key_here

API Keys can be created in the G-Prophet platform under "Settings → API Key Management".

Security Recommendations

• Store API keys in environment variables (GPROPHET_API_KEY), not in code
• Use test/limited-scope keys for development and evaluation
• Monitor usage and billing regularly at https://www.gprophet.com/dashboard
• Rotate keys periodically and revoke compromised keys immediately
• Never commit API keys to version control or share them publicly

Unified Response Format

Success Response

{
  "success": true,
  "data": { ... },
  "metadata": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-18T10:30:00Z",
    "processing_time_ms": 1250,
    "api_version": "v1"
  },
  "error": null
}

Error Response

{
  "success": false,
  "data": null,
  "metadata": { ... },
  "error": {
    "code": "INVALID_SYMBOL",
    "message": "Stock symbol 'XXXXX' not found",
    "details": {}
  }
}

Points Cost

Skill	Endpoint	Points/Call
Stock Prediction	POST /predictions/predict	CN 10, HK 15, US 20, Crypto 20
Algorithm Compare	POST /predictions/compare	Single prediction cost × number of algorithms
Quote	GET /market-data/quote	5
History	GET /market-data/history	5
Search	GET /market-data/search	5
Technical Analysis	POST /technical/analyze	5
Fear & Greed Index	GET /sentiment/fear-greed	5
Market Overview	GET /sentiment/market-overview	5
Deep Analysis	POST /analysis/comprehensive	150
Task Polling	GET /analysis/task/{task_id}	0 (free)

---

Skill 1: Stock Price Prediction

Predict future stock/cryptocurrency price movements using AI algorithms. Supports G-Prophet2026V1, LSTM, Transformer, and more.

POST /predictions/predict

Request Body (JSON):

Parameter	Type	Required	Default	Description
symbol	string	✅	-	Stock/crypto ticker (e.g. AAPL, 600519, BTCUSDT)
market	string	✅	-	Market code: US, CN, HK, CRYPTO
days	integer	No	7	Prediction days, range 1-30
algorithm	string	No	auto	Algorithm: auto, gprophet2026v1, lstm, transformer, random_forest, ensemble

Example Request:

curl -X POST "https://www.gprophet.com/api/external/v1/predictions/predict" \
  -H "X-API-Key: gp_sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"symbol": "AAPL", "market": "US", "days": 7, "algorithm": "auto"}'

Example Response:

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "market": "US",
    "current_price": 185.50,
    "predicted_price": 191.20,
    "change_percent": 3.07,
    "direction": "up",
    "confidence": 0.78,
    "prediction_days": 7,
    "algorithm_used": "gprophet2026v1",
    "data_quality": {
      "completeness": 1.0,
      "anomaly_count": 82,
      "missing_values": 0,
      "overall_score": 80
    },
    "points_consumed": 20
  }
}

POST /predictions/compare

Multi-algorithm comparison prediction. Returns results from each algorithm and the best recommendation. Points cost = single prediction cost × number of algorithms.

Request Body (JSON):

Parameter	Type	Required	Default	Description
symbol	string	✅	-	Stock/crypto ticker
market	string	✅	-	Market code: US, CN, HK, CRYPTO
days	integer	No	5	Prediction days, range 1-30
algorithms	string[]	No	["gprophet2026v1","lstm","transformer","ensemble"]	Algorithm list, max 6

Example Request:

curl -X POST "https://www.gprophet.com/api/external/v1/predictions/compare" \
  -H "X-API-Key: gp_sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"symbol": "TSLA", "market": "US", "days": 5, "algorithms": ["gprophet2026v1", "lstm", "transformer"]}'

Example Response:

{
  "success": true,
  "data": {
    "symbol": "TSLA",
    "market": "US",
    "current_price": 245.00,
    "prediction_days": 5,
    "results": [
      {
        "algorithm": "gprophet2026v1",
        "predicted_price": 252.30,
        "change_percent": 2.98,
        "direction": "up",
        "confidence": 0.82,
        "success": true
      },
      {
        "algorithm": "lstm",
        "predicted_price": 248.10,
        "change_percent": 1.27,
        "direction": "up",
        "confidence": 0.71,
        "success": true
      }
    ],
    "best_algorithm": "gprophet2026v1",
    "consensus_direction": "up",
    "average_predicted_price": 250.20,
    "points_consumed": 60
  }
}

---

Skill 2: Market Data

Get real-time quotes, historical OHLCV data, and search for stocks/crypto. Each call costs 5 points.

GET /market-data/quote

Get real-time quote.

Query Parameters:

Parameter	Type	Required	Description
symbol	string	✅	Stock/crypto ticker
market	string	✅	Market code: US, CN, HK, CRYPTO

Example Request:

curl "https://www.gprophet.com/api/external/v1/market-data/quote?symbol=AAPL&market=US" \
  -H "X-API-Key: gp_sk_live_your_key"

Example Response:

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "market": "US",
    "name": "Apple Inc.",
    "price": 185.50,
    "open": 183.90,
    "high": 186.80,
    "low": 183.20,
    "volume": 52340000,
    "previous_close": 183.20,
    "change": 2.30,
    "change_percent": 1.26,
    "points_consumed": 5
  }
}

GET /market-data/history

Get historical OHLCV candlestick data.

Query Parameters:

Parameter	Type	Required	Default	Description
symbol	string	✅	-	Stock/crypto ticker
market	string	✅	-	Market code
period	string	No	3m	Time range: 1w, 1m, 3m, 6m, 1y, 2y

Example Request:

curl "https://www.gprophet.com/api/external/v1/market-data/history?symbol=AAPL&market=US&period=3m" \
  -H "X-API-Key: gp_sk_live_your_key"

Example Response:

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "market": "US",
    "period": "3m",
    "data_points": 63,
    "history": [
      {
        "date": "2025-12-01",
        "open": 178.50,
        "high": 180.20,
        "low": 177.80,
        "close": 179.90,
        "volume": 48500000
      }
    ],
    "points_consumed": 5
  }
}

GET /market-data/search

Search for stocks/crypto by keyword.

Query Parameters:

Parameter	Type	Required	Default	Description
keyword	string	✅	-	Search keyword