Get Current Indicators

Retrieve the latest proprietary trading indicators for a specific liquidity pool.

Endpoint

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

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

---

Example Request

curl -X GET "https://enterprise.guardis.io/v1/indicators/current?pair_address=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" \
  -H "X-API-Key: your_api_key_here"

---

Response Format

{
  "pair_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "token_address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "total_wallets": 4827,
  "organic_wallets": 3241,
  "organic_profitable_wallets": 1847,
  "organic_to_total_wallets_ratio": "0.6714",
  "bot_to_total_wallets_ratio": "0.3286",
  "profitable_organic_to_total_organic_ratio": "0.5699",
  "total_volume_usd": "1284729.47",
  "organic_volume_usd": "847293.82",
  "bot_volume_ratio": "0.3404",
  "organic_volume_ratio": "0.6596",
  "organic_mean_hold_seconds": "3847.25",
  "organic_mean_trade_frequency_seconds": "892.50",
  "smart_money_score": "72.45",
  "price_usd": "0.000346289",
  "social_sentiment_score": "0.847",
  "social_blast_radius_score": 284729,
  "status": "active",
  "attempts": 1,
  "created_at": "2025-01-15T10:32:08.000Z",
  "updated_at": "2025-01-15T14:32:00.000Z",
  "smart_money_influx_10min": "48293.47",
  "smart_money_outflux_10min": "12847.82",
  "raw_smart_money_score": "68.92",
  "raw_smart_money_influx": "52847.29",
  "raw_smart_money_outflux": "14293.47",
  "smart_holders": 847,
  "raw_holders": 3241,
  "smart_to_raw_holders_ratio": "0.2613",
  "profitable_volume": "629472.18",
  "profitable_volume_total_volume_ratio": "0.4899"
}

---

Field Reference

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	Current token price in USD
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
updated_at	string	ISO 8601 timestamp when the indicator was last updated

Note: Decimal values are returned as strings to preserve precision.

---

Example Usage

JavaScript:

const pairAddress = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU";

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

const indicator = await response.json();

console.log(`Token: ${indicator.token_address}`);
console.log(`Smart Money Score: ${indicator.smart_money_score}`);
console.log(`Organic Ratio: ${(parseFloat(indicator.organic_to_total_wallets_ratio) * 100).toFixed(1)}%`);
console.log(`10min Net Flow: $${parseFloat(indicator.smart_money_influx_10min) - parseFloat(indicator.smart_money_outflux_10min)}`);

Python:

import requests

pair_address = "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

response = requests.get(
    "https://enterprise.guardis.io/v1/indicators/current",
    params={"pair_address": pair_address},
    headers={"X-API-Key": "your_api_key_here"}
)

indicator = response.json()

print(f"Token: {indicator['token_address']}")
print(f"Smart Money Score: {indicator['smart_money_score']}")
print(f"Organic Ratio: {float(indicator['organic_to_total_wallets_ratio']) * 100:.1f}%")

net_flow = float(indicator['smart_money_influx_10min']) - float(indicator['smart_money_outflux_10min'])
print(f"10min Net Flow: ${net_flow:,.2f}")

---

Error Responses

Status Code	Description
400	Missing or invalid pair_address parameter
401	Missing or invalid API key
404	Indicators not found for the provided pair address
500	Internal server error

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

{
  "code": 404,
  "message": "Indicators not found for the provided pair address"
}