Tokens API

Token Social x on-chain data

get

https://api.web3graph.xyzhttp://localhost:8000

/api/v1/tokens/{token_request}/lookup

Get Token on-chain and social data

Authorizations

APIKeyQueryAPIKeyHeader

api_keystringRequired

Path parameters

token_requeststringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/v1/tokens/{token_request}/lookup

HTTPcURLJavaScriptPython

GET /api/v1/tokens/{token_request}/lookup HTTP/1.1
Host: api.web3graph.xyz
Accept: */*

{
  "contract_address": "text",
  "symbol": "text",
  "name": "text",
  "fdv_usd": 1,
  "is_dead": true,
  "is_honeypot": true,
  "audit_last_checked": "2025-12-25T21:32:07.047Z",
  "liquidity_usd": 1,
  "volume_24h_usd": 1,
  "volume_1h_usd": 1,
  "volume_5m_usd": 1,
  "volume_6h_usd": 1,
  "token_price_last_checked": "2025-12-25T21:32:07.047Z",
  "earliest_pair_deployed": "2025-12-25T21:32:07.047Z",
  "twitter_username": "text",
  "twitter_id": "text",
  "twitter_url": "text",
  "profitable_shillers_score": 1,
  "top_profitable_shillers": [
    {
      "id": "text",
      "username": "text",
      "name": "text",
      "bio": "text",
      "profile_image_url": "text",
      "profile_banner_url": "text",
      "followers_count": 1,
      "friends_count": 1,
      "social_score": 1,
      "shill_type": "text",
      "shill_tweet_id": "text",
      "shill_tweet_text": "text",
      "shill_date": "2025-12-25T21:32:07.047Z"
    }
  ],
  "social_score": 1,
  "top_social_shillers": [
    {
      "id": "text",
      "username": "text",
      "name": "text",
      "bio": "text",
      "profile_image_url": "text",
      "profile_banner_url": "text",
      "followers_count": 1,
      "friends_count": 1,
      "social_score": 1,
      "shill_type": "text",
      "shill_tweet_id": "text",
      "shill_tweet_text": "text",
      "shill_date": "2025-12-25T21:32:07.047Z"
    }
  ],
  "score_last_updated": "2025-12-25T21:32:07.047Z"
}

Token Mentions on X

get

https://api.web3graph.xyzhttp://localhost:8000

/api/v1/tokens/{token_request}/mentions

Get Token Mentions on X

Authorizations

APIKeyQueryAPIKeyHeader

api_keystringRequired

Path parameters

token_requeststringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/v1/tokens/{token_request}/mentions

HTTPcURLJavaScriptPython

GET /api/v1/tokens/{token_request}/mentions HTTP/1.1
Host: api.web3graph.xyz
Accept: */*

[
  {
    "tweet_id": "text",
    "tweet_url": "text",
    "tweet_text": "text",
    "tweet_hashtags": [],
    "tweet_cashtags": [],
    "tweet_mentioned_users": [],
    "tweet_date": "2025-12-25T21:32:07.047Z",
    "tweet_like_count": 1,
    "tweet_retweet_count": 1,
    "tweet_reply_count": 1,
    "tweet_quote_count": 1,
    "tweet_view_count": 1,
    "tweet_bookmark_count": 1,
    "user_id": "text",
    "user_username": "text",
    "user_name": "text",
    "user_bio": "text",
    "user_location": "text",
    "user_profile_image_url": "text",
    "user_profile_banner_url": "text",
    "user_created_at": "2025-12-25T21:32:07.047Z",
    "user_verified": true,
    "user_restricted": true,
    "user_blue": true,
    "user_protected": true,
    "user_friends_count": 1,
    "user_followers_count": 1,
    "user_statuses_count": 1,
    "user_favourites_count": 1,
    "user_social_score": 1,
    "user_profitability_score": 1
  }
]

Token Price History

get

https://api.web3graph.xyzhttp://localhost:8000

/api/v1/tokens/{token_request}/price_history

Get Token Price History

Authorizations

APIKeyQueryAPIKeyHeader

api_keystringRequired

Path parameters

token_requeststringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/v1/tokens/{token_request}/price_history

HTTPcURLJavaScriptPython

GET /api/v1/tokens/{token_request}/price_history HTTP/1.1
Host: api.web3graph.xyz
Accept: */*

{
  "token_address": "text",
  "token_symbol": "text",
  "token_name": "text",
  "token_fdv_usd": 1,
  "token_liquidity_usd": 1,
  "token_is_dead": true,
  "token_is_honeypot": true,
  "token_price_last_checked": "2025-12-25T21:32:07.047Z",
  "price_history": [
    {
      "price_native": 1,
      "price_usd": 1,
      "liquidity_usd": 1,
      "fdv_usd": 1,
      "profitability_score": 1,
      "social_score": 1,
      "timestamp": "2025-12-25T21:32:07.047Z"
    }
  ]
}

X account token shills history

get

https://api.web3graph.xyzhttp://localhost:8000

/api/v1/tokens/{username_or_id}/token_shills_history

Get X account token shills history

Authorizations

APIKeyQueryAPIKeyHeader

api_keystringRequired

Path parameters

username_or_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/v1/tokens/{username_or_id}/token_shills_history

HTTPcURLJavaScriptPython

GET /api/v1/tokens/{username_or_id}/token_shills_history HTTP/1.1
Host: api.web3graph.xyz
Accept: */*

{
  "profile_id": "text",
  "profile_username": "text",
  "profile_name": "text",
  "total_number_of_shills": 1,
  "number_of_profitable_shills": 1,
  "profitability": 1,
  "profitability_score": 1,
  "social_score": 1,
  "shills_history": [
    {
      "contract_address": "text",
      "symbol": "text",
      "name": "text",
      "fdv_at_shill_usd": 1,
      "price_at_shill_usd": 1,
      "profitable": true,
      "roi": 1,
      "max_roi": 1,
      "minutes_to_max_price": 1,
      "shilled_at": "2025-12-25T21:32:07.047Z",
      "shill_type": "text"
    }
  ]
}

Leaderboard

get

https://api.web3graph.xyzhttp://localhost:8000

/api/v1/tokens/leaderboard

Get paginated leaderboard of profiles ranked by social score and/or profitability.

Authorizations

APIKeyQueryAPIKeyHeader

api_keystringRequired

Query parameters

limitintegerOptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/v1/tokens/leaderboard

HTTPcURLJavaScriptPython

GET /api/v1/tokens/leaderboard HTTP/1.1
Host: api.web3graph.xyz
Accept: */*

{
  "profiles": [
    {
      "profile_id": "text",
      "profile_username": "text",
      "profile_name": "text",
      "total_number_of_shills": 1,
      "number_of_profitable_shills": 1,
      "score": 1,
      "social_score": 1
    }
  ],
  "limit": 1,
  "offset": 1,
  "total": 1
}

Get Profile Token Shills

get

https://api.web3graph.xyzhttp://localhost:8000

/api/v1/tokens/{username_or_id}/token_shills

Get paginated token shills for a specific profile (by username or ID).

Authorizations

APIKeyQueryAPIKeyHeader

api_keystringRequired

Path parameters

username_or_idstringRequired

Query parameters

limitintegerOptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/v1/tokens/{username_or_id}/token_shills

HTTPcURLJavaScriptPython

GET /api/v1/tokens/{username_or_id}/token_shills HTTP/1.1
Host: api.web3graph.xyz
Accept: */*

{
  "tokens": [
    {
      "token_address": "text",
      "token_name": "text",
      "token_symbol": "text",
      "token_is_dead": true,
      "token_fdv_usd": 1,
      "token_score_v2": 1,
      "token_chain": "text",
      "shill_methods": [],
      "shill_count": 1,
      "first_shill_at": "2025-12-25T21:32:07.047Z",
      "token_earliest_pair_created_at": "2025-12-25T21:32:07.047Z"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Analyze Shiller

post

https://api.web3graph.xyzhttp://localhost:8000

/api/v1/tokens/{username_or_id}/analyze_shiller

Analyze a shiller's profile and token shills.

Authorizations

APIKeyQueryAPIKeyHeader

api_keystringRequired

Path parameters

username_or_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/api/v1/tokens/{username_or_id}/analyze_shiller

HTTPcURLJavaScriptPython

POST /api/v1/tokens/{username_or_id}/analyze_shiller HTTP/1.1
Host: api.web3graph.xyz
Accept: */*

{
  "profile_id": "text",
  "username": "text",
  "name": "text",
  "social_score": 1,
  "profitability_score": 1,
  "total_number_of_shills": 1,
  "number_of_profitable_shills": 1,
  "shills_last_checked": "2025-12-25T21:32:07.047Z"
}