Summary Statistics

Retrieve aggregate social metrics for a token including sentiment, reach, and post volume.

Note: Social data collection begins only after a token has migrated from a launchpad or has locked liquidity. This prevents spam from low-quality tokens.

Endpoint

GET https://enterprise.guardis.io/v1/socials/summary

Authentication

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

X-API-Key: your_api_key_here

---

Query Parameters

Parameter	Type	Required	Description
token_address	string	Yes	The mint address of the token

---

Example Request

curl -X GET "https://enterprise.guardis.io/v1/socials/summary?token_address=5GTRGGnmbMCjCUnc3xMweCgVqDEtSDxTdvVdwutcpump" \
  -H "X-API-Key: your_api_key_here"

---

Response Format

{
  "token_address": "5GTRGGnmbMCjCUnc3xMweCgVqDEtSDxTdvVdwutcpump",
  "total_social_sentiment": 0.72,
  "total_social_reach": 1847293,
  "total_number_of_posts": 842,
  "tracking_since": "2025-12-01T14:32:08.000Z",
  "last_updated": "2025-12-07T18:45:22.000Z"
}

---

Field Reference

Field	Type	Description
token_address	string	The mint address of the token
total_social_sentiment	number	Aggregate sentiment score from -1.0 (negative) to 1.0 (positive)
total_social_reach	integer	Total follower count across all accounts that have posted about this token
total_number_of_posts	integer	Total number of social posts collected for this token
tracking_since	string	ISO 8601 timestamp when social tracking began for this token
last_updated	string	ISO 8601 timestamp when metrics were last updated

Sentiment Score Guide

Range	Interpretation
0.5 to 1.0	Strongly positive sentiment
0.1 to 0.5	Moderately positive sentiment
-0.1 to 0.1	Neutral sentiment
-0.5 to -0.1	Moderately negative sentiment
-1.0 to -0.5	Strongly negative sentiment

---

Example Usage

JavaScript:

const tokenAddress = "5GTRGGnmbMCjCUnc3xMweCgVqDEtSDxTdvVdwutcpump";

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

const summary = await response.json();

console.log(`Social Summary for ${tokenAddress}`);
console.log(`Sentiment: ${summary.total_social_sentiment.toFixed(2)}`);
console.log(`Total Reach: ${summary.total_social_reach.toLocaleString()} followers`);
console.log(`Total Posts: ${summary.total_number_of_posts}`);

Python:

import requests

token_address = "5GTRGGnmbMCjCUnc3xMweCgVqDEtSDxTdvVdwutcpump"

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

summary = response.json()

print(f"Social Summary for {token_address}")
print(f"Sentiment: {summary['total_social_sentiment']:.2f}")
print(f"Total Reach: {summary['total_social_reach']:,} followers")
print(f"Total Posts: {summary['total_number_of_posts']}")

---

Error Responses

Status Code	Description
400	Missing or invalid token_address parameter
401	Missing or invalid API key
404	Token not found or social tracking not yet active
422	Invalid Solana mint address format
500	Internal server error

{
  "code": 404,
  "message": "Social data not available. Token may not have migrated or locked liquidity yet"
}