Forecast API Documentation

1. Generate Forecast

Endpoint: /forecast/v2/forecast
Method: POST
Description: Generates price forecasts for cryptocurrency tokens on the Solana blockchain, providing price predictions, volatility information, and support/resistance levels.

Request

Headers:

Content-Type: application/json
Authorization: Bearer <your_token>

Body:

{
  "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "timeframe": 60,
}

Parameters

Response

Success (200 OK):

{
  "token_details": {
    "name": "USD Coin",
    "symbol": "USDC",
    "description": "USD Coin (USDC) is a stablecoin pegged to the US dollar",
    "supply": "5234532100000000",
    "decimals": 6,
    "price_per_token": 1.00
  },
  "current_price": 1.00,
  "consensus_score": 0.89,
  "forecast": [
    {
      "timestamp": "2025-02-26T14:00:00.000Z",
      "price": 1.0002
    },
    {
      "timestamp": "2025-02-26T15:00:00.000Z",
      "price": 1.0001
    },
    // Additional forecast points...
  ],
  "input_data": [
    {
      "timestamp": "2025-02-25T14:00:00.000Z",
      "price": 0.9998
    },
    {
      "timestamp": "2025-02-25T15:00:00.000Z",
      "price": 0.9999
    },
    // Additional historical data points...
  ],
  "volatility_info": {
    "annualized_stdev_estimate": 0.0012,
    "atr": 0.0005
  },
  "support_resistance": [
    {
      "price": 0.9995,
      "type": "support"
    },
    {
      "price": 1.0005,
      "type": "resistance"
    }
  ],
  "trade_levels": {
    "action": "BUY",
    "entry_price": 0.9998,
    "stop_loss": 0.9992,
    "take_profit": 1.0006,
    "support_levels": [0.9995, 0.9990],
    "resistance_levels": [1.0005, 1.0010],
    "hit_probabilities": {
      "p_hit_tp": 0.68,
      "p_hit_sl": 0.22,
      "p_no_hit": 0.10
    }
  },
  "technical_indicators": {
    "ma20_latest": 0.9999,
    "ma50_latest": 1.0001,
    "rsi": 54.2,
    "stoch_rsi": 62.5,
    "stoch_rsi_k": 65.3,
    "stoch_rsi_d": 58.7,
    "ma20_series": [
      {
        "timestamp": "2025-02-25T10:00:00.000Z",
        "value": 0.9997
      },
      // Additional MA20 data points...
    ],
    "ma50_series": [
      // MA50 data points...
    ]
  }
}

Response Fields

2. Get Last Predictions

Endpoint: /forecast/v2/last-predictions
Method: GET
Description: Retrieves the most recent predictions made by the system.

Request

Headers:

Authorization: Bearer <your_token>

Query Parameters:

limit=10

Response

Success (200 OK):

{
  "predictions": [
    {
      "timestamp": "2025-02-27T12:30:45.000Z",
      "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "response_body": {
        // Full forecast response
      }
    },
    // Other predictions
  ]
}

Using cURL

Example: Generate Forecast

curl -X POST https://api.dith.ai/forecast/v2/forecast \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_token>" \
  -d '{
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "timeframe": 60
  }'

Example: Get Last Predictions

curl -X GET https://api.dith.ai/forecast/v2/last-predictions?limit=5 \
  -H "Authorization: Bearer <your_token>"

Using Python (Requests)

Example: Generate Forecast

import requests
import json

url = "https://api.dith.ai/forecast/v2/forecast"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <your_token>"
}
payload = {
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "timeframe": 60
}

response = requests.post(url, headers=headers, json=payload)

if response.status_code == 200:
    forecast_data = response.json()
    print(f"Current Price: {forecast_data['current_price']}")
    print(f"Consensus Score: {forecast_data['consensus_score']}")
    print(f"Forecast Points: {len(forecast_data['forecast'])}")
    print(f"Trading Action: {forecast_data['trade_levels']['action']}")
else:
    print(f"Error: {response.status_code} - {response.text}")

Example: Get Last Predictions

import requests

url = "https://api.dith.ai/forecast/v2/last-predictions"
params = {"limit": 5}
headers = {
    "Authorization": "Bearer <your_token>"
}

response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:
    predictions = response.json()['predictions']
    for i, pred in enumerate(predictions):
        print(f"Prediction {i+1}:")
        print(f"  Token: {pred['token_address']}")
        print(f"  Time: {pred['timestamp']}")
        print(f"  Current Price: {pred['response_body']['current_price']}")
        print()
else:
    print(f"Error: {response.status_code} - {response.text}")