> For the complete documentation index, see [llms.txt](https://docs.alphagate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alphagate.io/developer-api/endpoints.md).

# Endpoints

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

{% hint style="info" %}
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`.
{% endhint %}

| Endpoint                                           | What it returns    | Cost                   |
| -------------------------------------------------- | ------------------ | ---------------------- |
| [`GET /user/contracts`](#user-contracts)           | User Contracts     | 2 credits              |
| [`GET /user/deleted-tweets`](#deleted-tweets)      | Deleted Tweets     | 4 credits              |
| [`GET /user/key-followers`](#key-followers)        | Key Followers      | 4 credits              |
| [`GET /user/first-follows`](#first-follows)        | First Follows      | 3 credits              |
| [`GET /user/alpha`](#user-alpha)                   | User Alpha         | 6 credits              |
| [`GET /user/prev-usernames`](#previous-usernames)  | Previous Usernames | 0.5 credits            |
| [`GET /user/bio-history`](#bio-history)            | Bio History        | 2 credits              |
| [`GET /user/id`](#username-to-id)                  | Username to ID     | 0.1 credits            |
| [`GET /x/user/overview`](#live-user-profile)       | Live User Profile  | 0.1 credits            |
| [`GET /x/user/followers`](#live-followers)         | Live Followers     | 1 credit               |
| [`GET /x/user/following`](#live-following)         | Live Following     | 1 credit               |
| [`GET /x/user/latest-tweets`](#live-latest-tweets) | Live Latest Tweets | 0.1 credits per result |
| [`GET /balance`](#balance)                         | Balance            | Free                   |
| [`GET /usage/history`](#usage-history)             | Usage History      | Free                   |
| [`GET /usage/summary`](#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. |

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

<details>

<summary>Example <code>data</code></summary>

```json
{
  "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
    }
  ]
}
```

</details>

### 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).       |

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

<details>

<summary>Example <code>data</code></summary>

```json
[
  {
    "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
  }
]
```

</details>

### 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).                                                                              |

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

<details>

<summary>Example <code>data</code></summary>

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

</details>

### 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. |

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

<details>

<summary>Example <code>data</code></summary>

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

</details>

### 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. |

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

<details>

<summary>Example <code>data</code></summary>

```json
{
  "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
}
```

</details>

### 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. |

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

<details>

<summary>Example <code>data</code></summary>

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

</details>

### 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).                                        |

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

<details>

<summary>Example <code>data</code></summary>

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

</details>

## 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 @). |

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

<details>

<summary>Example <code>data</code></summary>

```json
{
  "id": "44196397"
}
```

</details>

### 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 @). |

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

<details>

<summary>Example <code>data</code></summary>

```json
{
  "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"
}
```

</details>

### 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. |

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

<details>

<summary>Example <code>data</code></summary>

```json
[
  {
    "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/..."
  }
]
```

</details>

### 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. |

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

<details>

<summary>Example <code>data</code></summary>

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

</details>

### 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.                       |

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

<details>

<summary>Example <code>data</code></summary>

```json
[
  {
    "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"
    }
  }
]
```

</details>

## Account

Your own balance and usage. These calls are free.

### Balance

`GET /balance` · **Free**

Get current credit balance and plan info.

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

<details>

<summary>Example <code>data</code></summary>

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

</details>

### Usage History

`GET /usage/history` · **Free**

Paginated log of all API calls made.

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

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

<details>

<summary>Example <code>data</code></summary>

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

</details>

### Usage Summary

`GET /usage/summary` · **Free**

Aggregated usage stats for the last 30 days.

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

<details>

<summary>Example <code>data</code></summary>

```json
{
  "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
    }
  ]
}
```

</details>

## 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.