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

```json
{
  "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

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

## Points Cost

| Skill | Endpoint | Points/Call |
|-------|----------|-------------|
| Stock Predic...

---
name: gprophet-api
description: AI-powered stock prediction and market analysis for global markets
homepage: https://www.gprophet.com
metadata:
  clawdbot:
    emoji: "📈"
    requires:
      env: ["GPROPHET_API_KEY"]
    primaryEnv: "GPROPHET_API_KEY"
---

# G-Prophet API Skills

AI-powered stock prediction and market analysis capabilities for OpenClaw agents.

## Features

- 📈 Stock price prediction (1-30 days)
- 🌍 Multi-market support (US, CN, HK, Crypto)
- 🤖 Multiple AI algorithms (G-Prophet2026V1, LSTM, Transformer, etc.)
- 📊 Technical analysis (RSI, MACD, Bollinger Bands, KDJ)
- 💹 Market sentiment analysis
- 🔍 Deep multi-agent analysis

## Quick Start

Get up and running in 5 minutes:

1. Get API key at https://www.gprophet.com/settings/api-keys
2. Set environment variable: `export GPROPHET_API_KEY="gp_sk_..."`
3. Make your first prediction:

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

See [QUICK_START.md](./QUICK_START.md) for more examples.

## Security & Authentication

This skill requires a G-Prophet API key to access the external prediction service.

### Getting Your API Key

1. Visit https://www.gprophet.com/settings/api-keys
2. Create a new API key (format: `gp_sk_*`)
3. For testing, consider creating a limited-scope key with minimal permissions

### Secure Configuration

**Recommended**: Use environment variables to store your API key securely:

```bash
export GPROPHET_API_KEY="gp_sk_your_key_here"
```

**Alternative**: Use OpenClaw's secure credential store (if available in your platform)

⚠️ **Security Best Practices**:
- Never commit API keys to version control
- Use test/limited keys for evaluation
- Rotate keys regularly
- Monitor usage and billing at https://www.gprophet.com/dashboard
- Revoke keys immediately if compromised

## Usage

### Predict Stock Price
``...