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

contract_addressstringRequired

symbolany ofOptional

stringOptional

or

nullOptional

nameany ofOptional

stringOptional

or

nullOptional

fdv_usdany ofOptional

numberOptional

or

nullOptional

is_deadany ofOptional

booleanOptional

or

nullOptional

is_honeypotany ofOptional

booleanOptional

or

nullOptional

audit_last_checkedany ofOptional

string · date-timeOptional

or

nullOptional

liquidity_usdany ofOptional

numberOptional

or

nullOptional

volume_24h_usdany ofOptional

numberOptional

or

nullOptional

volume_1h_usdany ofOptional

numberOptional

or

nullOptional

volume_5m_usdany ofOptional

numberOptional

or

nullOptional

volume_6h_usdany ofOptional

numberOptional

or

nullOptional

token_price_last_checkedany ofOptional

string · date-timeOptional

or

nullOptional

earliest_pair_deployedany ofOptional

string · date-timeOptional

or

nullOptional

twitter_usernameany ofOptional

stringOptional

or

nullOptional

twitter_idany ofOptional

stringOptional

or

nullOptional

twitter_urlany ofOptional

stringOptional

or

nullOptional

profitable_shillers_scoreany ofOptional

numberOptional

or

nullOptional

social_scoreany ofOptional

numberOptional

or

nullOptional

score_last_updatedany ofOptional

string · date-timeOptional

or

nullOptional

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": "2026-02-20T04:14:37.514Z",
  "liquidity_usd": 1,
  "volume_24h_usd": 1,
  "volume_1h_usd": 1,
  "volume_5m_usd": 1,
  "volume_6h_usd": 1,
  "token_price_last_checked": "2026-02-20T04:14:37.514Z",
  "earliest_pair_deployed": "2026-02-20T04:14:37.514Z",
  "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": "2026-02-20T04:14:37.514Z"
    }
  ],
  "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": "2026-02-20T04:14:37.514Z"
    }
  ],
  "score_last_updated": "2026-02-20T04:14:37.514Z"
}

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

tweet_idstringRequired

tweet_urlany ofOptional

stringOptional

or

nullOptional

tweet_textany ofOptional

stringOptional

or

nullOptional

tweet_hashtagsany ofOptional

or

nullOptional

tweet_cashtagsany ofOptional

or

nullOptional

tweet_mentioned_usersany ofOptional

or

nullOptional

tweet_dateany ofOptional

string · date-timeOptional

or

nullOptional

tweet_like_countany ofOptional

integerOptional

or

nullOptional

tweet_retweet_countany ofOptional

integerOptional

or

nullOptional

tweet_reply_countany ofOptional

integerOptional

or

nullOptional

tweet_quote_countany ofOptional

integerOptional

or

nullOptional

tweet_view_countany ofOptional

integerOptional

or

nullOptional

tweet_bookmark_countany ofOptional

integerOptional

or

nullOptional

user_idany ofOptional

stringOptional

or

nullOptional

user_usernameany ofOptional

stringOptional

or

nullOptional

user_nameany ofOptional

stringOptional

or

nullOptional

user_bioany ofOptional

stringOptional

or

nullOptional

user_locationany ofOptional

stringOptional

or

nullOptional

user_profile_image_urlany ofOptional

stringOptional

or

nullOptional

user_profile_banner_urlany ofOptional

stringOptional

or

nullOptional

user_created_atany ofOptional

string · date-timeOptional

or

nullOptional

user_verifiedany ofOptional

booleanOptional

or

nullOptional

user_restrictedany ofOptional

booleanOptional

or

nullOptional

user_blueany ofOptional

booleanOptional

or

nullOptional

user_protectedany ofOptional

booleanOptional

or

nullOptional

user_friends_countany ofOptional

integerOptional

or

nullOptional

user_followers_countany ofOptional

integerOptional

or

nullOptional

user_statuses_countany ofOptional

integerOptional

or

nullOptional

user_favourites_countany ofOptional

integerOptional

or

nullOptional

user_social_scoreany ofOptional

numberOptional

or

nullOptional

user_profitability_scoreany ofOptional

numberOptional

or

nullOptional

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": "2026-02-20T04:14:37.514Z",
    "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": "2026-02-20T04:14:37.514Z",
    "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

token_addressstringRequired

token_symbolany ofOptional

stringOptional

or

nullOptional

token_nameany ofOptional

stringOptional

or

nullOptional

token_fdv_usdnumberRequired

token_liquidity_usdnumberRequired

token_is_deadany ofOptional

booleanOptional

or

nullOptional

token_is_honeypotany ofOptional

booleanOptional

or

nullOptional

token_price_last_checkedany ofOptional

string · date-timeOptional

or

nullOptional

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": "2026-02-20T04:14:37.514Z",
  "price_history": [
    {
      "price_native": 1,
      "price_usd": 1,
      "liquidity_usd": 1,
      "fdv_usd": 1,
      "profitability_score": 1,
      "social_score": 1,
      "timestamp": "2026-02-20T04:14:37.514Z"
    }
  ]
}

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

profile_idstringRequired

profile_usernameany ofOptional

stringOptional

or

nullOptional

profile_nameany ofOptional

stringOptional

or

nullOptional

total_number_of_shillsintegerRequired

number_of_profitable_shillsintegerRequired

profitabilitynumberRequired

profitability_scoreany ofOptional

numberOptional

or

nullOptional

social_scoreany ofOptional

numberOptional

or

nullOptional

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": "2026-02-20T04:14:37.514Z",
      "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

limitintegerRequired

offsetintegerRequired

totalany ofOptional

integerOptional

or

nullOptional

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

totalintegerRequired

limitintegerRequired

offsetintegerRequired

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": "2026-02-20T04:14:37.514Z",
      "token_earliest_pair_created_at": "2026-02-20T04:14:37.514Z"
    }
  ],
  "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

profile_idstringRequired

usernameany ofOptional

stringOptional

or

nullOptional

nameany ofOptional

stringOptional

or

nullOptional

social_scoreany ofOptional

numberOptional

or

nullOptional

profitability_scoreany ofOptional

numberOptional

or

nullOptional

total_number_of_shillsintegerRequired

number_of_profitable_shillsintegerRequired

shills_last_checkedany ofOptional

string · date-timeOptional

or

nullOptional

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": "2026-02-20T04:14:37.514Z"
}