Number of Posts over Time

Retrieve the number of social posts per minute for a token over a specified time range.

Note: Social data collection begins only after a token has migrated from a launchpad or has locked liquidity.

Endpoint

GET https://enterprise.guardis.io/v1/socials/posts-over-time

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
from_date	string	Yes	Start of the time range (ISO 8601 format)
to_date	string	No	End of the time range (ISO 8601 format). Defaults to current time

---

Example Request

curl -X GET "https://enterprise.guardis.io/v1/socials/posts-over-time?token_address=5GTRGGnmbMCjCUnc3xMweCgVqDEtSDxTdvVdwutcpump&from_date=2025-12-07T00:00:00Z&to_date=2025-12-07T12:00:00Z" \
  -H "X-API-Key: your_api_key_here"

---

Response Format

{
  "token_address": "5GTRGGnmbMCjCUnc3xMweCgVqDEtSDxTdvVdwutcpump",
  "from_date": "2025-12-07T00:00:00Z",
  "to_date": "2025-12-07T12:00:00Z",
  "interval": "1m",
  "data_points": [
    {
      "timestamp": "2025-12-07T00:00:00Z",
      "count": 3
    },
    {
      "timestamp": "2025-12-07T00:01:00Z",
      "count": 5
    },
    {
      "timestamp": "2025-12-07T00:02:00Z",
      "count": 2
    },
    {
      "timestamp": "2025-12-07T00:03:00Z",
      "count": 8
    },
    {
      "timestamp": "2025-12-07T00:04:00Z",
      "count": 12
    }
  ]
}

---

Field Reference

Response Wrapper

Field	Type	Description
token_address	string	The mint address of the token
from_date	string	Start of the requested time range
to_date	string	End of the requested time range
interval	string	Data aggregation interval (always 1m for per-minute)
data_points	array	Array of time-series data points

Data Point

Field	Type	Description
timestamp	string	ISO 8601 timestamp for this data point
count	integer	Number of posts during this minute

---

Example Usage

JavaScript:

const params = new URLSearchParams({
  token_address: "5GTRGGnmbMCjCUnc3xMweCgVqDEtSDxTdvVdwutcpump",
  from_date: "2025-12-07T00:00:00Z",
  to_date: "2025-12-07T12:00:00Z"
});

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

const data = await response.json();

console.log(`Post Volume Over Time (${data.data_points.length} data points)`);

// Find peak activity
const peak = data.data_points.reduce((max, dp) => dp.count > max.count ? dp : max);
console.log(`Peak: ${peak.count} posts at ${peak.timestamp}`);

// Calculate total
const total = data.data_points.reduce((sum, dp) => sum + dp.count, 0);
console.log(`Total Posts: ${total}`);

Python:

import requests

response = requests.get(
    "https://enterprise.guardis.io/v1/socials/posts-over-time",
    params={
        "token_address": "5GTRGGnmbMCjCUnc3xMweCgVqDEtSDxTdvVdwutcpump",
        "from_date": "2025-12-07T00:00:00Z",
        "to_date": "2025-12-07T12:00:00Z"
    },
    headers={"X-API-Key": "your_api_key_here"}
)

data = response.json()

print(f"Post Volume Over Time ({len(data['data_points'])} data points)")

# Find peak activity
peak = max(data["data_points"], key=lambda dp: dp["count"])
print(f"Peak: {peak['count']} posts at {peak['timestamp']}")

# Calculate total
total = sum(dp["count"] for dp in data["data_points"])
print(f"Total Posts: {total}")

---

Error Responses

Status Code	Description
400	Missing required parameters
401	Missing or invalid API key
404	Token not found or social tracking not yet active
422	Invalid date format or date range
500	Internal server error

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

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