Endpoints

Every endpoint of the Alphagate API, with parameters, credit cost and an example response.

This page is generated from the live API description at https://api.alphagate.io/api/info, so it lists exactly what the API serves today. Base URL for every call: https://api.alphagate.io/api/v2.

Endpoint	What it returns	Cost
GET /user/contracts	User Contracts	2 credits
GET /user/deleted-tweets	Deleted Tweets	4 credits
GET /user/key-followers	Key Followers	4 credits
GET /user/first-follows	First Follows	3 credits
GET /user/alpha	User Alpha	6 credits
GET /user/prev-usernames	Previous Usernames	0.5 credits
GET /user/bio-history	Bio History	2 credits
GET /user/id	Username to ID	0.1 credits
GET /x/user/overview	Live User Profile	0.1 credits
GET /x/user/followers	Live Followers	1 credit
GET /x/user/following	Live Following	1 credit
GET /x/user/latest-tweets	Live Latest Tweets	0.1 credits per result
GET /balance	Balance	Free
GET /usage/history	Usage History	Free
GET /usage/summary	Usage Summary	Free

Database

Alphagate's own records: what we have stored about an account over time.

User Contracts

GET /user/contracts · 2 credits

Get the smart contract addresses associated with a user: the 100 most recent, oldest first. contracts lists the addresses; mentioned_contracts lists the same contracts in the same order, each with its chain, the token symbol and name, and when the account first mentioned it (Unix seconds, null when not known).

Parameter	Type	Required	Description
username	string	No	Twitter username. Provide username or twitterId.
twitterId	string	No	Twitter numeric ID. Provide username or twitterId.

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/user/contracts?username=alphagate_io"

Example data

{
  "username": "example_project",
  "id": "123456789",
  "contracts": [
    "0xabc...",
    "5Yh...pump"
  ],
  "mentioned_contracts": [
    {
      "address": "0xabc...",
      "chain": "base",
      "symbol": "EXMPL",
      "name": "Example",
      "first_mentioned_at": 1773325906
    },
    {
      "address": "5Yh...pump",
      "chain": "solana",
      "symbol": null,
      "name": null,
      "first_mentioned_at": null
    }
  ]
}

Deleted Tweets

GET /user/deleted-tweets · 4 credits

Get deleted tweets from a user.

Parameter	Type	Required	Description
username	string	No	Twitter username. Provide username or twitterId.
twitterId	string	No	Twitter numeric ID. Provide username or twitterId.
limit	number	No	Max tweets to return (default 100, max 100).

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/user/deleted-tweets?username=alphagate_io"

Example data

[
  {
    "id": "1234567890",
    "text": "This tweet was deleted...",
    "created_at": "2026-03-14T12:00:00Z",
    "username": "trader",
    "author_id": "99999",
    "contracts": [
      "0xabc..."
    ],
    "is_retweet": false,
    "is_reply": false
  }
]

Key Followers

GET /user/key-followers · 4 credits

Get key followers (influencers/KOLs) that follow this user, with the time of each follow. A follow that already existed when we started tracking that key profile has no known time and is not listed.

Parameter	Type	Required	Description
username	string	No	Twitter username. Provide username or twitterId.
twitterId	string	No	Twitter numeric ID. Provide username or twitterId.
sort	string	No	Sort order: "recent" (default) or "oldest".
page	number	No	Page number (default: 1). No maximum: page through the full list; a page past the end returns an empty list.
limit	number	No	Page size (default 20, max 50).

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/user/key-followers?username=alphagate_io"

Example data

[
  {
    "username": "VitalikButerin",
    "followers_count": 5200000,
    "key_followers_count": 3200,
    "profile_image_url": "https://pbs.twimg.com/...",
    "description": "...",
    "tag": [
      "Ethereum Founder"
    ],
    "timestamp": 1773325906
  }
]

First Follows

GET /user/first-follows · 3 credits

Get the first accounts that followed this user (early supporters).

Parameter	Type	Required	Description
username	string	No	Twitter username. Provide username or twitterId.
twitterId	string	No	Twitter numeric ID. Provide username or twitterId.

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/user/first-follows?username=alphagate_io"

Example data

[
  {
    "id": "111222333",
    "username": "early_supporter",
    "description": "Crypto enthusiast",
    "profile_image_url": "https://pbs.twimg.com/..."
  }
]

User Alpha

GET /user/alpha · 6 credits

Get key intelligence on a user: contract activity, community creation, and name changes.

Parameter	Type	Required	Description
username	string	No	Twitter username. Provide username or twitterId.
twitterId	string	No	Twitter numeric ID. Provide username or twitterId.

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/user/alpha?username=alphagate_io"

Example data

{
  "id": "44196397",
  "username": "elonmusk",
  "key_followers_count": 4450,
  "prev_usernames_count": 1,
  "prev_usernames": [
    "previous_handle"
  ],
  "has_contracts": true,
  "contracts_count": 2,
  "contracts": [
    "0xdef...",
    "0xabc..."
  ],
  "has_comms_created": false,
  "comms_created_count": 0
}

Previous Usernames

GET /user/prev-usernames · 0.5 credits

Get previous usernames for a user.

Parameter	Type	Required	Description
username	string	No	Twitter username. Provide username or twitterId.
twitterId	string	No	Twitter numeric ID. Provide username or twitterId.

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/user/prev-usernames?username=alphagate_io"

Example data

{
  "id": "44196397",
  "username": "elonmusk",
  "prev_usernames": [
    "previous_handle"
  ]
}

Bio History

GET /user/bio-history · 2 credits

Get bio change history for a user. Returns previous and new bio values with timestamps.

Parameter	Type	Required	Description
username	string	No	Twitter username. Provide username or twitterId.
twitterId	string	No	Twitter numeric ID. Provide username or twitterId.
page	number	No	Page number (default: 1, max: 30; a later page returns an empty list).
limit	number	No	Page size (default 20, max 50).

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/user/bio-history?username=alphagate_io"

Example data

[
  {
    "from": "Old bio text here",
    "to": "New bio text here",
    "timestamp": 1773325906,
    "twitter_username": "elonmusk"
  }
]

Live Twitter

Read straight from X at the moment you call. Results reflect X right now.

Username to ID

GET /user/id · 0.1 credits

Convert a Twitter username to a numeric user ID in real time.

Parameter	Type	Required	Description
username	string	Yes	Twitter handle (without @).

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/user/id?username=alphagate_io"

Example data

{
  "id": "44196397"
}

Live User Profile

GET /x/user/overview · 0.1 credits

Get a full Twitter user profile in real time.

Parameter	Type	Required	Description
username	string	Yes	Twitter handle (without @).

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/x/user/overview?username=alphagate_io"

Example data

{
  "id": "44196397",
  "screen_name": "elonmusk",
  "name": "Elon Musk",
  "description": "",
  "location": "",
  "verified_type": "Blue",
  "followers_count": 236549663,
  "friends_count": 1296,
  "statuses_count": 99161,
  "media_count": 4389,
  "profile_image_url_https": "https://pbs.twimg.com/profile_images/.../photo_normal.jpg",
  "created_at": "Tue Jun 02 20:12:29 +0000 2009"
}

Live Followers

GET /x/user/followers · 1 credit

Get a user's 50 most recent followers from Twitter in real time. There are no further pages.

Parameter	Type	Required	Description
twitterId	string	No	Twitter numeric user ID. Required if username not provided.
username	string	No	Twitter handle (without @). Required if twitterId not provided.

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/x/user/followers?username=alphagate_io"

Example data

[
  {
    "id": "123456789",
    "screen_name": "someuser",
    "name": "Some User",
    "followers_count": 15000,
    "friends_count": 500,
    "verified_type": "Blue",
    "profile_image_url_https": "https://pbs.twimg.com/..."
  }
]

Live Following

GET /x/user/following · 1 credit

Get the 50 accounts a user followed most recently on Twitter, in real time. There are no further pages.

Parameter	Type	Required	Description
twitterId	string	No	Twitter numeric user ID. Required if username not provided.
username	string	No	Twitter handle (without @). Required if twitterId not provided.

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/x/user/following?username=alphagate_io"

Example data

[
  {
    "id": "987654321",
    "screen_name": "followeduser",
    "name": "Followed User",
    "followers_count": 50000,
    "friends_count": 200,
    "profile_image_url_https": "https://pbs.twimg.com/..."
  }
]

Live Latest Tweets

GET /x/user/latest-tweets · 0.1 credits per result

Get a user's latest tweets in real time (replies excluded): one page of up to 20 tweets (fewer with count). There are no further pages.

Parameter	Type	Required	Description
twitterId	string	No	Twitter numeric user ID. Required if username not provided.
username	string	No	Twitter handle (without @). Required if twitterId not provided.
count	number	No	Number of tweets to return, up to 20 (default 20). A larger count returns 20.
raw	string	No	Set to "true" to get the tweets in X's original format.

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/x/user/latest-tweets?username=alphagate_io"

Example data

[
  {
    "id": "2032832937578868792",
    "full_text": "RT @art_muse: Skater Girl https://t.co/7oxIDUC23a",
    "created_at": "Sat Mar 14 14:55:15 +0000 2026",
    "user_id_str": "44196397",
    "favorite_count": 0,
    "retweet_count": 397,
    "reply_count": 0,
    "entities": {
      "hashtags": [],
      "user_mentions": [
        {
          "screen_name": "art_muse"
        }
      ]
    },
    "user": {
      "id": "44196397",
      "screen_name": "elonmusk"
    }
  }
]

Account

Your own balance and usage. These calls are free.

Balance

GET /balance · Free

Get current credit balance and plan info.

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/balance"

Example data

{
  "credits": 19831,
  "plan": "Developer",
  "monthlyCredits": 20000
}

Usage History

GET /usage/history · Free

Paginated log of all API calls made.

Parameter	Type	Required	Description
page	number	No	Page number (default: 1).

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/usage/history"

Example data

[
  {
    "route": "user/contracts",
    "cost": 2,
    "balanceAfter": 19860,
    "query": {
      "username": "seedstrio"
    },
    "timestamp": "2026-03-13T07:15:38.439Z"
  }
]

Usage Summary

GET /usage/summary · Free

Aggregated usage stats for the last 30 days.

curl -H "x-api-key: $ALPHAGATE_API_KEY" "https://api.alphagate.io/api/v2/usage/summary"

Example data

{
  "period": {
    "from": "2026-02-11T...",
    "to": "2026-03-13T..."
  },
  "totalRequests": 23,
  "totalCreditsSpent": 140,
  "creditsRemaining": 19831,
  "plan": "Developer",
  "monthlyCredits": 20000,
  "lastReset": 1773292908121,
  "breakdown": [
    {
      "route": "user/key-followers",
      "requests": 4,
      "creditsSpent": 72,
      "costPerResult": 2
    }
  ]
}

Paging

Endpoints that page take page and limit. The default page size is 20 and the largest is 50. Where a page cap applies, it is 30; an endpoint's own parameter notes say when there is no cap.

Rate limit

Every plan: at most 180 requests per minute per API key (3 a second on average). Over it the API answers 429.