Get Historic Indicators

Retrieve historical proprietary trading indicators for a specific liquidity pool over a given time range.

Endpoint

GET https://enterprise.guardis.io/v1/indicators/historic

Authentication

Include your API key in the X-API-Key header.

X-API-Key: your_api_key_here

---

Query Parameters

Parameter	Type	Required	Description
pair_address	string	Yes	The on-chain address of the liquidity pool
from	string	Yes	Start of the time range (ISO 8601 format)
to	string	Yes	End of the time range (ISO 8601 format)

---

Example Request

curl -X GET "https://enterprise.guardis.io/v1/indicators/historic?pair_address=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU&from=2025-01-15T00:00:00Z&to=2025-01-15T12:00:00Z" \
  -H "X-API-Key: your_api_key_here"

---

Response Format

Returns an array of indicator snapshots ordered chronologically within the specified time range.

{
  "pair_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "from": "2025-01-15T00:00:00Z",
  "to": "2025-01-15T12:00:00Z",
  "count": 720,
  "indicators": [
    {
      "pair_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "token_address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "total_wallets": 4521,
      "organic_wallets": 3102,
      "organic_profitable_wallets": 1720,
      "organic_to_total_wallets_ratio": "0.6862",
      "bot_to_total_wallets_ratio": "0.3138",
      "profitable_organic_to_total_organic_ratio": "0.5545",
      "total_volume_usd": "1142847.29",
      "organic_volume_usd": "782941.47",
      "bot_volume_ratio": "0.3149",
      "organic_volume_ratio": "0.6851",
      "organic_mean_hold_seconds": "4102.50",
      "organic_mean_trade_frequency_seconds": "947.25",
      "smart_money_score": "68.92",
      "price_usd": "0.000312847",
      "social_sentiment_score": "0.782",
      "social_blast_radius_score": 247829,
      "status": "active",
      "attempts": 1,
      "smart_money_influx_10min": "42847.29",
      "smart_money_outflux_10min": "18293.47",
      "raw_smart_money_score": "64.28",
      "raw_smart_money_influx": "47293.82",
      "raw_smart_money_outflux": "21847.29",
      "smart_holders": 782,
      "raw_holders": 3102,
      "smart_to_raw_holders_ratio": "0.2521",
      "profitable_volume": "547829.47",
      "profitable_volume_total_volume_ratio": "0.4793",
      "created_at": "2025-01-15T00:00:00.000Z"
    },
    {
      "pair_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "token_address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "total_wallets": 4539,
      "organic_wallets": 3118,
      "organic_profitable_wallets": 1734,
      "organic_to_total_wallets_ratio": "0.6870",
      "bot_to_total_wallets_ratio": "0.3130",
      "profitable_organic_to_total_organic_ratio": "0.5561",
      "total_volume_usd": "1148293.47",
      "organic_volume_usd": "787293.82",
      "bot_volume_ratio": "0.3143",
      "organic_volume_ratio": "0.6857",
      "organic_mean_hold_seconds": "4087.75",
      "organic_mean_trade_frequency_seconds": "942.50",
      "smart_money_score": "69.14",
      "price_usd": "0.000318293",
      "social_sentiment_score": "0.789",
      "social_blast_radius_score": 249847,
      "status": "active",
      "attempts": 1,
      "smart_money_influx_10min": "43293.47",
      "smart_money_outflux_10min": "17847.29",
      "raw_smart_money_score": "64.87",
      "raw_smart_money_influx": "47829.47",
      "raw_smart_money_outflux": "21293.82",
      "smart_holders": 789,
      "raw_holders": 3118,
      "smart_to_raw_holders_ratio": "0.2531",
      "profitable_volume": "552847.29",
      "profitable_volume_total_volume_ratio": "0.4815",
      "created_at": "2025-01-15T00:00:00.000Z"
    }
  ]
}

---

Field Reference

Response Wrapper

Field	Type	Description
pair_address	string	The queried pool address
from	string	Start of the requested time range
to	string	End of the requested time range
count	integer	Number of indicator snapshots returned
indicators	array	Array of indicator snapshots ordered chronologically

Indicator Snapshot

Identification

Field	Type	Description
pair_address	string	The on-chain address of the liquidity pool
token_address	string	The mint address of the token

Wallet Metrics

Field	Type	Description
total_wallets	integer	Total number of unique wallets that have traded this token
organic_wallets	integer	Number of wallets classified as organic (non-bot) traders
organic_profitable_wallets	integer	Number of organic wallets currently in profit
organic_to_total_wallets_ratio	string	Ratio of organic wallets to total wallets (0-1)
bot_to_total_wallets_ratio	string	Ratio of bot wallets to total wallets (0-1)
profitable_organic_to_total_organic_ratio	string	Ratio of profitable organic wallets to total organic wallets (0-1)

Volume Metrics

Field	Type	Description
total_volume_usd	string	Total trading volume in USD
organic_volume_usd	string	Trading volume from organic wallets in USD
bot_volume_ratio	string	Ratio of bot volume to total volume (0-1)
organic_volume_ratio	string	Ratio of organic volume to total volume (0-1)
profitable_volume	string	Volume from profitable trades in USD
profitable_volume_total_volume_ratio	string	Ratio of profitable volume to total volume (0-1)

Behavioral Metrics

Field	Type	Description
organic_mean_hold_seconds	string	Average hold time for organic wallets in seconds
organic_mean_trade_frequency_seconds	string	Average time between trades for organic wallets in seconds

Smart Money Metrics

Field	Type	Description
smart_money_score	string	Proprietary score indicating smart money activity (0-100)
raw_smart_money_score	string	Unadjusted smart money score before normalization
smart_money_influx_10min	string	Smart money inflow over the last 10 minutes in USD
smart_money_outflux_10min	string	Smart money outflow over the last 10 minutes in USD
raw_smart_money_influx	string	Unadjusted smart money inflow in USD
raw_smart_money_outflux	string	Unadjusted smart money outflow in USD
smart_holders	integer	Number of wallets classified as smart money
raw_holders	integer	Total number of current holders
smart_to_raw_holders_ratio	string	Ratio of smart money holders to total holders (0-1)

Social Metrics

Field	Type	Description
social_sentiment_score	string	Sentiment score derived from social signals (-1 to 1)
social_blast_radius_score	integer	Estimated social reach/exposure metric

Price & Status

Field	Type	Description
price_usd	string	Token price in USD at this snapshot
status	string	Processing status of the indicator
attempts	integer	Number of calculation attempts
created_at	string	ISO 8601 timestamp when the indicator was first created

Note: Decimal values are returned as strings to preserve precision. Indicators are generated every minute, so a 12-hour range would return up to 720 snapshots.

---

Example Usage

JavaScript:

const pairAddress = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU";
const from = "2025-01-15T00:00:00Z";
const to = "2025-01-15T12:00:00Z";

const response = await fetch(
  `https://enterprise.guardis.io/v1/indicators/historic?pair_address=${pairAddress}&from=${from}&to=${to}`,
  {
    headers: {
      "X-API-Key": "your_api_key_here"
    }
  }
);

const data = await response.json();

console.log(`Retrieved ${data.count} snapshots`);

// Calculate average smart money score over the period
const avgScore = data.indicators.reduce(
  (sum, ind) => sum + parseFloat(ind.smart_money_score), 0
) / data.indicators.length;

console.log(`Average Smart Money Score: ${avgScore.toFixed(2)}`);

// Find peak organic ratio
const peakOrganic = Math.max(
  ...data.indicators.map(ind => parseFloat(ind.organic_to_total_wallets_ratio))
);

console.log(`Peak Organic Ratio: ${(peakOrganic * 100).toFixed(1)}%`);

Python:

import requests

pair_address = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

response = requests.get(
    "https://enterprise.guardis.io/v1/indicators/historic",
    params={
        "pair_address": pair_address,
        "from": "2025-01-15T00:00:00Z",
        "to": "2025-01-15T12:00:00Z"
    },
    headers={"X-API-Key": "your_api_key_here"}
)

data = response.json()

print(f"Retrieved {data['count']} snapshots")

# Calculate average smart money score over the period
avg_score = sum(
    float(ind['smart_money_score']) for ind in data['indicators']
) / len(data['indicators'])

print(f"Average Smart Money Score: {avg_score:.2f}")

# Find peak organic ratio
peak_organic = max(
    float(ind['organic_to_total_wallets_ratio']) for ind in data['indicators']
)

print(f"Peak Organic Ratio: {peak_organic * 100:.1f}%")

---

Error Responses

Status Code	Description
400	Missing or invalid parameters
401	Missing or invalid API key
404	No indicators found for the provided pair address and time range
422	Invalid date format or date range
500	Internal server error

{
  "code": 400,
  "message": "Missing required parameter: pair_address"
}

{
  "code": 422,
  "message": "Invalid date format. Use ISO 8601 format (e.g., 2025-01-15T00:00:00Z)"
}

{
  "code": 422,
  "message": "Invalid date range: 'from' must be before 'to'"
}

{
  "code": 404,
  "message": "No indicators found for the provided pair address and time range"
}