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	Default	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)
interval	string	No	1m	Time interval between snapshots. Valid values: 1m, 5m, 15m, 30m, 1h, 4h, 1d
fields	string	No	all	Comma-separated list of indicator fields to include in the response. If omitted, all fields are returned

---

Interval Values

Value	Description	Max Range Recommended
1m	1 minute	24 hours
5m	5 minutes	7 days
15m	15 minutes	14 days
30m	30 minutes	30 days
1h	1 hour	90 days
4h	4 hours	180 days
1d	1 day	365 days

When using intervals greater than 1m, indicator values are aggregated using the following methods:

• Numeric metrics (e.g., total_wallets, smart_holders): Last value in the interval

• Volume metrics (e.g., total_volume_usd, organic_volume_usd): Sum over the interval

• Ratio metrics (e.g., organic_to_total_wallets_ratio, smart_money_score): Time-weighted average

• Price (price_usd): Last value in the interval (close price)

---

Available Fields

The fields parameter accepts any combination of the following values:

Wallet Metrics

• total_wallets

• organic_wallets

• organic_profitable_wallets

• organic_to_total_wallets_ratio

• bot_to_total_wallets_ratio

• profitable_organic_to_total_organic_ratio

Volume Metrics

• total_volume_usd

• organic_volume_usd

• bot_volume_ratio

• organic_volume_ratio

• profitable_volume

• profitable_volume_total_volume_ratio

Behavioral Metrics

• organic_mean_hold_seconds

• organic_mean_trade_frequency_seconds

Smart Money Metrics

• smart_money_score

• raw_smart_money_score

• smart_money_influx_10min

• smart_money_outflux_10min

• raw_smart_money_influx

• raw_smart_money_outflux

• smart_holders

• raw_holders

• smart_to_raw_holders_ratio

Price & Status

• price_usd

Note: The created_at timestamp is always included in each indicator snapshot regardless of field selection.

---

Example Request

Basic request (all fields, 1-minute intervals):

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"

With specific fields and interval:

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&interval=5m&fields=smart_money_score,total_wallets,price_usd" \
  -H "X-API-Key: your_api_key_here"

---

Response Format

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

Full response (all fields):

{
  "pair_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "token_address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "from": "2025-01-15T00:00:00Z",
  "to": "2025-01-15T12:00:00Z",
  "interval": "1m",
  "fields": null,
  "count": 720,
  "indicators": [
    {
      "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",
      "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"
    },
    {
      "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",
      "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:01:00.000Z"
    }
  ]
}

Filtered response (specific fields with 5-minute interval):

{
  "pair_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "token_address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "from": "2025-01-15T00:00:00Z",
  "to": "2025-01-15T12:00:00Z",
  "interval": "5m",
  "fields": ["smart_money_score", "total_wallets", "price_usd"],
  "count": 144,
  "indicators": [
    {
      "smart_money_score": "68.92",
      "total_wallets": 4521,
      "price_usd": "0.000312847",
      "created_at": "2025-01-15T00:00:00.000Z"
    },
    {
      "smart_money_score": "69.47",
      "total_wallets": 4587,
      "price_usd": "0.000321293",
      "created_at": "2025-01-15T00:05:00.000Z"
    },
    {
      "smart_money_score": "70.12",
      "total_wallets": 4634,
      "price_usd": "0.000329847",
      "created_at": "2025-01-15T00:10:00.000Z"
    }
  ]
}

---

Field Reference

Response Wrapper

Field	Type	Description
pair_address	string	The queried pool address
token_address	string	The mint address of the token
from	string	Start of the requested time range
to	string	End of the requested time range
interval	string	The interval used for aggregation
fields	array|null	List of requested fields, or null if all fields were returned
count	integer	Number of indicator snapshots returned
indicators	array	Array of indicator snapshots ordered chronologically

Indicator Snapshot

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)

Price & Status

Field	Type	Description
price_usd	string	Token price in USD at this snapshot
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 at 1m interval 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";

// Request only specific fields with 5-minute intervals
const params = new URLSearchParams({
  pair_address: pairAddress,
  from: from,
  to: to,
  interval: "5m",
  fields: "smart_money_score,total_wallets,price_usd"
});

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

const data = await response.json();

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

// 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)}`);

// Track wallet growth
const walletGrowth = data.indicators[data.indicators.length - 1].total_wallets 
  - data.indicators[0].total_wallets;

console.log(`Wallet Growth: ${walletGrowth}`);

Python:

import requests

pair_address = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

# Request only specific fields with 15-minute intervals
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",
        "interval": "15m",
        "fields": "smart_money_score,organic_to_total_wallets_ratio,price_usd"
    },
    headers={"X-API-Key": "your_api_key_here"}
)

data = response.json()

print(f"Retrieved {data['count']} snapshots at {data['interval']} intervals")
print(f"Fields returned: {data['fields']}")

# 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, date range, interval, or field name
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": 422,
  "message": "Invalid interval: 'invalid'. Valid values are: 1m, 5m, 15m, 30m, 1h, 4h, 1d"
}

{
  "code": 422,
  "message": "Invalid field name: 'invalid_field'. See documentation for available fields."
}

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