# Introduction

On-chain data is a goldmine of information, but only if you know where to look. With thousands of new tokens launching and millions of trades happening daily, it’s impossible to manually keep up. And while the data is all out in the open, turning that noise into an actual trading edge feels impossible - that’s where Market Stalker comes in.

Instead of you sifting through endless on-chain activity, we do the heavy lifting. Since August 2024, we’ve built and refined The Market Stalker, a real-time, multi-layered wallet tracking system that generates signals based on wallets that consistently provide the best opportunities, avoid scams, and provide attainable high returns.

Our algorithm analyses each trade as it happens and re-tiers wallets on a trade-by-trade basis to ensure you’re always getting signals from the top performers, not old wallets that hit high profits once.&#x20;


# Mission

To create an enviroment where anyone can trade like a pro.

We believe the best trading opportunities shouldn’t be reserved for insiders or locked away in private chats. Every trader should have access to tools that allow them to move fast, make smart decisions, and capture real momentum.&#x20;

The Marker Stalkers' core focus is to make on-chain intelligence effortless to access and act on. By tracking top-performing wallets in real time and detecting where momentum is forming, we can turn complex data into simple, actionable signals.

Long term, we aim to continue to enhance automation and provide greater access to data, how it can be visualised and allow users to fine-tune their preferences for the types of signals they receive based on their strategies.&#x20;


# Roadmap

{% hint style="info" %}
This roadmap highlights where we are heading. However, priorities may shift based on market activity, user feedback, and where the strongest edge lies.&#x20;
{% endhint %}

The Market Stalker is built to move fast and with the market. Whilst our current focus is on wallet intelligence, we are actively expanding toward a broader set of tools that put traders fully in control of what they track, how they act, and when they take profit.

#### **So what's coming next?**

* [x] TG Signal Bot (In DMs) with simple filtering
* [x] Enhancement to filtering
* [x] Custom User-Added Wallets
* [x] Auto-posting shareable gain cards
* [x] Introducing Whale Tracking
* [x] Stalk Telegram Users - group joining notifications
  * [x] Beta Access for premium users
  * [x] Integration into main Market Stalker Bot
* [x] Multiple Signal Rules (Premium)
* [ ] Premium Dashboard Overhaul (Required to go multi-chain)
  * [x] Search all tokens - regardless of signals
  * [x] Dashboard Landing Page (adjusted to your filters)
  * [ ] Discover Wallets - Top user-added wallets
  * [x] Signal History - view all signals regardless of filters
  * [x] Custom Filters - Adjust your filters on the dashboard or Telegram
  * [x] Your tracked wallets - Your own personally sourced wallet list.
  * [x] Telegram user lookup
  * [x] Telegram Members list (on Token pages)
  * [x] Telegram user Analytics
  * [ ] Wallet Analytics and Profitable Wallet Scanner
  * [x] Early block buyers & holding status
* [ ] Solana chain support
  * [x] Beta Access on Signals for premium users
  * [x] Full Integration of Signals into main Market Stalker Bot
  * [x] Dashboard Supporting SOL tokens
* [ ] Base chain support
  * [ ] Integration of Signals into main Market Stalker Bot
  * [x] Dashboard Supporting Base tokens
* [ ] BSC chain support
  * [ ] Integration of Signals into main Market Stalker Bot
  * [x] Dashboard Supporting BSC tokens
* [ ] Call Fusion Merger - CallFusion.app is to be completley consumed by Market Stalker **Premium**
* [ ] Auto-Trading Bot


# Telegram Bot

{% hint style="info" %}
Telegram Bot will soon transition from channel access to DM's with the Telegram bot to make way for future upgrades such as filtering, automated trading and more.
{% endhint %}

The Market Stalker Telegram Bot is currently undergoing a complete restructuring. For now, signals are currently presented in either the **Market Stalker Signals** channel or **Market Stalker Premium Signals** channel.&#x20;

Both channels provide the same signals, but the information that comes with the signal is more in-depth in the Premium channel.

<table><thead><tr><th></th><th data-type="checkbox">Standard</th><th data-type="checkbox">Premium</th></tr></thead><tbody><tr><td>Tier Info</td><td>true</td><td>true</td></tr><tr><td>Token Age</td><td>false</td><td>true</td></tr><tr><td>Tracked Buyer Count</td><td>true</td><td>true</td></tr><tr><td>Large Buy Indicator</td><td>false</td><td>true</td></tr><tr><td>Social Links</td><td>false</td><td>true</td></tr><tr><td>Volume Stats</td><td>false</td><td>true</td></tr><tr><td>Security Info</td><td>false</td><td>true</td></tr><tr><td>Funder Info</td><td>false</td><td>true</td></tr></tbody></table>

An example of basic & Premium notifications can be seen below.

<figure><img src="/files/hlHzOcuHzFDJmDYCtmc3" alt=""><figcaption></figcaption></figure>

{% content-ref url="/pages/orIGTrclQxbAH8KJCOnf" %}
[Access Our Tools](/our-tools/access-our-tools)
{% endcontent-ref %}

{% content-ref url="/pages/ts2SLNMRf2WJ5dW6MyKj" %}
[Compare Plans](/packages/compare-plans)
{% endcontent-ref %}


# Premium Dashboard

The premium dashboard is an extra layer of access exclusive to those users subscribing to the premium plan or holding over 500,000 $STLKR tokens.&#x20;

The dashboard provides a unified view of the latest 20 signals. It brings real-time data from a range of sources, which allows users to make truly informed decisions.

The dashboard provides the following information at a glance:

* Project info (Name, Symbol, Age)
* Socials and DexScreener Logo/Banner
* Market Cap, Liquidity, Volume, Holders and TXs info
* Live Chart
* Unique tracked buyers and their tiers
* Holding / Buying more status of tracked wallets
* Calls/KOLs who have mentioned the project with links to calls and timestamp & mcap
* Bundle info
* Security info&#x20;
* Funder info (kyc rating - green, orange, red)&#x20;

<figure><img src="/files/BOLXzxfCfpI1WmuivOnY" alt=""><figcaption></figcaption></figure>


# Access Our Tools

The Market Stalker tools are a suite of tools exclusive to subscribers and $STLKR holders. By registering through the [@TheMarketStalker\_Bot](https://t.me/TheMarketStalker_Bot), users can gain access to their desired plan.

Users can gain access to The Market Stalker tools by [paying monthly](/packages/pay-monthly) from $120 or by [holding supply](/packages/holders-access) with a minimum of 0.25%.&#x20;

To get started:

* DM @TheMarketStalker\_Bot
* Type /subscribe and pick the option to suit you.
* Follow the steps in the bot to gain access.


# Partner API

The Market Stalker API provides detailed insights into Telegram activity and KOL shares across X and Telegram channels.

{% hint style="info" %}
The API is **not public**. To request access, please contact **Market Stalker** directly with your intended use case.

Each approved partner receives an API key and limited quota for selected endpoints.
{% endhint %}

<details>

<summary>Get Telegram User Profile</summary>

**Purpose:** Returns detailed user data including historic display/usernames, recent activity, and group roles.

Request:

```
GET /admin-roles?query=<user_id|@username>
Header: x-api-key: YOUR_PARTNER_KEY
```

Example:&#x20;

```
curl -H "x-api-key: YOUR_PARTNER_KEY"
".../user-report?query=DataWizz"
```

Response:

```
{
  "user_id": 6137747116,
  "display_name": "DataWizz 🧙 (Market Stalker)",
  "username": "DataWizz",
  "first_seen": "2025-09-13T22:40:31+00:00",
  "last_seen": "2025-11-04T06:41:29+00:00",
  "history": {
    "previous_display_names_count": 2,
    "previous_display_names": [
      "DataWizz 🧙",
      "DataWizz (Channel in bio)"
    ],
    "previous_usernames_count": 0,
    "previous_usernames": []
  },
  "groups_summary": {
    "total_groups": 5,
    "active_in_last_7_days": 5,
    "admin_in_group_count": 1
  },
  "groups": [
    {
      "group_id": -1002282510595,
      "name": "The Market Stalker Community",
      "first_seen_in_group": "2025-09-13T22:40:31+00:00",
      "last_seen_in_group": "2025-11-04T06:41:29+00:00",
      "members_count": 2285,
      "token": {
        "address": "0x522Ec96bCed6dc26325120EdF3931d34E417a620",
        "chain": "ethereum",
        "symbol": "STLKR"
      },
      "telegram": {
        "link": "https://t.me/themarketstalker",
        "link_type": "portal"
      },
      "admin": {
        "is_admin": true,
        "is_owner": true,
        "role": "owner",
        "admin_tag": "Owner",
        "rights": {
          "change_info": true,
          "ban_users": true,
          "delete_messages": true,
          "pin_messages": true,
          "add_admins": true
        }
      }
    },
    {
      "group_id": -1003178265398,
      "name": "White Monkey",
      "first_seen_in_group": "2025-10-30T23:20:55+00:00",
      "last_seen_in_group": "2025-10-30T23:20:55+00:00",
      "members_count": 1977,
      "token": null,
      "telegram": {
        "link": "https://t.me/whitemonkeyportal",
        "link_type": "portal"
      },
      "admin": {
        "is_admin": false,
        "is_owner": false,
        "role": null,
        "admin_tag": null,
        "rights": null
      }
    },
    {
      "group_id": -1002812191154,
      "name": "Marie Rose - SPX Mascot 💹🧲🌹",
      "first_seen_in_group": "2025-10-29T22:52:13+00:00",
      "last_seen_in_group": "2025-10-29T22:52:13+00:00",
      "members_count": 1591,
      "token": {
        "address": "0xcaa1E525ACb44aeC4e0D17a0e2467AA3Ea7EE3A6",
        "chain": "ethereum",
        "symbol": "MARIE"
      },
      "telegram": {
        "link": "https://t.me/marieroseethereum",
        "link_type": "portal"
      },
      "admin": {
        "is_admin": false,
        "is_owner": false,
        "role": null,
        "admin_tag": null,
        "rights": null
      }
    },
    {
      "group_id": -1003072270133,
      "name": "FRENLY COMMUNITY",
      "first_seen_in_group": "2025-10-28T08:45:06+00:00",
      "last_seen_in_group": "2025-10-28T08:45:06+00:00",
      "members_count": 1335,
      "token": {
        "address": "0x26EcB65d997CBFf18FCa447cB85f6aF1175a22B0",
        "chain": "base",
        "symbol": "FRENLY"
      },
      "telegram": {
        "link": "https://t.me/frenly_portal",
        "link_type": "portal"
      },
      "admin": {
        "is_admin": false,
        "is_owner": false,
        "role": null,
        "admin_tag": null,
        "rights": null
      }
    },
    {
      "group_id": -1002947732445,
      "name": "Rhino - Official Ethereum Macot",
      "first_seen_in_group": "2025-10-24T22:36:59+00:00",
      "last_seen_in_group": "2025-10-24T22:36:59+00:00",
      "members_count": 678,
      "token": null,
      "telegram": {
        "link": "https://t.me/rhinoeth",
        "link_type": "portal"
      },
      "admin": {
        "is_admin": false,
        "is_owner": false,
        "role": null,
        "admin_tag": null,
        "rights": null
      }
    }
  ],
  "admin_groups": [
    {
      "group_id": -1002282510595,
      "name": "The Market Stalker Community",
      "last_seen_in_group": "2025-11-04T06:41:29+00:00",
      "members_count": 2285,
      "telegram": {
        "link": "https://t.me/themarketstalker",
        "link_type": "portal"
      },
      "role": "owner",
      "admin_tag": "Owner",
      "rights": {
        "change_info": true,
        "ban_users": true,
        "delete_messages": true,
        "pin_messages": true,
        "add_admins": true
      }
    }
  ]
}

```

</details>

<details>

<summary>Get Groups &#x26; Roles (Queried User Has Admin Rights)</summary>

**Purpose:** Returns only the groups where the user has admin privileges, with a normalized `role` (`owner`, `super_admin`, `mod`), optional `admin_tag`, and a best join link.

Request:

```
GET /admin-roles?query=<user_id|@username>
Header: x-api-key: YOUR_PARTNER_KEY
```

Example:&#x20;

```
curl -H "x-api-key: YOUR_PARTNER_KEY"
".../admin-roles?query=Cryptodevbsctg"
```

Response:

```
{
  "status": "ok",
  "meta": {
    "query": "Cryptodevbsctg"
  },
  "user": {
    "id": 6171169457,
    "username": "Cryptodevbsctg",
    "display_name": "⚡Synergy⚡ OG",
    "username_history": [],
    "display_name_history": [
      "⚡ Synergy⚡ OG",
      "⚡Synergy⚡ OG",
      "Synergy ⚡💹🧲🟦⚡ OG",
      "Synergy 💹🧲🟦 OG"
    ]
  },
  "admin_summary": {
    "owner": 6,
    "super_admin": 3,
    "mod": 4
  },
  "groups_with_admin": [
    {
      "id": -1003195316992,
      "name": "$CORGI CULT",
      "role": "owner",
      "admin_tag": "OG",
      "link_type": "public",
      "join_url": "https://t.me/corgiog"
    },
    {
      "id": -1002914932974,
      "name": "Holder Guard",
      "role": "owner",
      "admin_tag": "—",
      "link_type": "public",
      "join_url": "https://t.me/holderguardtg"
    },
    {
      "id": -1003001951506,
      "name": "Mandela effect",
      "role": "owner",
      "admin_tag": "Admin",
      "link_type": "public",
      "join_url": "https://t.me/mandelaeffecttg"
    },
    {
      "id": -1002993540678,
      "name": "PumpBase Lounge",
      "role": "owner",
      "admin_tag": "Dev PumpBase",
      "link_type": "public",
      "join_url": "https://t.me/pumpbaseshillgroup"
    },
    {
      "id": -1003255276513,
      "name": "Pumpit",
      "role": "owner",
      "admin_tag": "Pumpit",
      "link_type": "private",
      "join_url": "https://t.me/+PL4QgMPDIcE3NjI5"
    },
    {
      "id": -1003000895346,
      "name": "⚡PumpBase⚡",
      "role": "owner",
      "admin_tag": "Base maxi",
      "link_type": "public",
      "join_url": "https://t.me/pumpbasepad"
    },
    {
      "id": -1003112342557,
      "name": "Group -1003112342557",
      "role": "super_admin",
      "admin_tag": "—",
      "link_type": "—",
      "join_url": "—"
    },
    {
      "id": -1001733141232,
      "name": "Playbunny",
      "role": "super_admin",
      "admin_tag": "—",
      "link_type": "public",
      "join_url": "https://t.me/playbunnycoin"
    },
    {
      "id": -1002994396194,
      "name": "Shield | Base",
      "role": "super_admin",
      "admin_tag": "Support",
      "link_type": "public",
      "join_url": "https://t.me/shieldcoinbase"
    },
    {
      "id": -1002737779964,
      "name": "$Kandy On Base",
      "role": "mod",
      "admin_tag": "—",
      "link_type": "portal",
      "join_url": "https://t.me/kandyonchain"
    },
    {
      "id": -1003185428621,
      "name": "$PUMPBULL",
      "role": "mod",
      "admin_tag": "Chad",
      "link_type": "portal",
      "join_url": "https://t.me/pumpbulll"
    },
    {
      "id": -1002444269034,
      "name": "Ape Alliance | Alpha Lounge",
      "role": "mod",
      "admin_tag": "OG SYNERGY",
      "link_type": "private",
      "join_url": "https://t.me/+Rm_PtVxosmdiYmNh"
    },
    {
      "id": -1002489355941,
      "name": "Yellow Pill CTO 🟨💊",
      "role": "mod",
      "admin_tag": "Support",
      "link_type": "portal",
      "join_url": "https://t.me/yellowpill_cto"
    }
  ]
}
```

**Role Logic**

* `owner` → user is group owner.
* `super_admin` → admin with `admin_rights.add_admins = true`.
* `mod` → admin (or has rights) but **without** `add_admins`.

**Link Preference**

* `portal` → `public` → `invite`. If none, returns `—` with `join_url: "—"`.

</details>

<details>

<summary>Get Group Members, Including Recent Activity + Admin List</summary>

**Purpose:** Return a group’s member list, recent activity windows (today / last 7 days), and a concise admin list.

Search by **token address** or by a **group username** (we match against both `portal_username` and `group_public_username`).

If multiple groups match, we pick the one with the **most recent `last_logged_at`**.

Request:

```
GET /group-members?token_address=<ca> | /group-members?group_username=<portal_or_public_username>
Header: x-api-key: YOUR_PARTNER_KEY
```

Example:&#x20;

```
# by group username (matches portal_username or group_public_username)
curl -H "x-api-key: YOUR_PARTNER_KEY" \
  ".../group-members?group_username=themarketstalker"

# by token address
curl -H "x-api-key: YOUR_PARTNER_KEY" \
  ".../group-members?token_address=0x522Ec96bCed6dc26325120EdF3931d34E417a620"

```

Response:

```
{
  "status": "ok",
  "meta": {
    "match_by": "token_address",
    "value": "0x522Ec96bCed6dc26325120EdF3931d34E417a620"
  },
  "group": {
    "group_id": -1002282510595,
    "group_name": "The Market Stalker Community",
    "portal_username": "themarketstalker",
    "group_public_username": null,
    "members_count": 2285
  },
  "overview": {
    "total_members_seen": 2285
  },
  "today": {
    "active": 23,
    "joined": 2
  },
  "last_7_days": {
    "active": 95,
    "joined": 35
  },
  "members": [
    { "user_id": 7202168682, "display_name": "BlindSilentNinja", "first_seen": "2025-09-13T22:46:51+00:00", "last_seen": "2025-11-04T10:19:00+00:00", "admin": true, "admin_tag": "Owner" },
    { "user_id": 6137747116, "display_name": "DataWizz 🧙 (Market Stalker)", "first_seen": "2025-09-13T22:40:31+00:00", "last_seen": "2025-11-04T06:41:29+00:00", "admin": true, "admin_tag": "Owner" },
    { "user_id": 2103605856, "display_name": "Syncieman.eth🐺", "first_seen": "2025-09-13T22:49:22+00:00", "last_seen": "2025-11-04T11:01:20+00:00", "admin": true, "admin_tag": "Mod" },
    { "user_id": 6068830149, "display_name": "Bill Kenn", "first_seen": "2025-09-13T23:36:50+00:00", "last_seen": "2025-11-03T20:37:31+00:00", "admin": true, "admin_tag": "Bill" },
    { "user_id": 567713533, "display_name": "𝘿𝙍𝗖𝗥𝗬𝗣𝗧𝗢🅳🅰️🆆🅶 $xᴀʟᴘʜᴀ | ᴄᴏᴛ ᴇʟɪᴛᴇ 🏠", "first_seen": "2025-09-14T07:32:22+00:00", "last_seen": "2025-11-02T13:17:20+00:00", "admin": true, "admin_tag": "DrCrypto" },
    { "user_id": 1361785012, "display_name": "Risk", "first_seen": "2025-09-14T07:35:43+00:00", "last_seen": "2025-10-31T17:26:48+00:00", "admin": true, "admin_tag": "Risk" },
    { "user_id": 6016060428, "display_name": "CubeETH", "first_seen": "2025-09-14T09:07:27+00:00", "last_seen": "2025-10-31T17:26:48+00:00", "admin": true, "admin_tag": "Cube" },
    { "user_id": 563515153, "display_name": "V - American Pepe $APE", "first_seen": "2025-09-15T04:39:19+00:00", "last_seen": "2025-10-31T17:26:48+00:00", "admin": true, "admin_tag": "V-Guy" },
    { "user_id": 6387792471, "display_name": "🎩 𝐌𝐫.🆆🅷🅰️🅻🅴 🐳", "first_seen": "2025-09-15T04:39:19+00:00", "last_seen": "2025-10-31T17:26:48+00:00", "admin": true, "admin_tag": "Whale" },
    { "user_id": 7031045125, "display_name": "GOAT", "first_seen": "2025-09-15T11:43:55+00:00", "last_seen": "2025-11-04T11:23:31+00:00", "admin": false, "admin_tag": null },
    { "user_id": 6724355432, "display_name": "ΞTM", "first_seen": "2025-09-14T04:41:45+00:00", "last_seen": "2025-11-04T10:55:47+00:00", "admin": false, "admin_tag": null },
    { "user_id": 1540594318, "display_name": "The Fox | SES | XDC | MMKK | (Ronin Arc)", "first_seen": "2025-09-15T11:43:55+00:00", "last_seen": "2025-11-04T10:53:50+00:00", "admin": false, "admin_tag": null }
  ]
}

```

**Behavior & Notes**

* **Query params:** provide **exactly one** of `token_address` or `group_username`.
  * `group_username` checks **both** `portal_username` and `group_public_username`.
* **Multi-match resolution:** if multiple group docs match, we return the one with the **latest `last_logged_at`** (most up-to-date snapshot).
* **Activity windows:**
  * **Today** = last 24 hours (UTC).
  * **Last 7 days** = rolling 7 days (UTC).
* **Sorting:** `members` are sorted by **most recent `last_seen`** (fallback to `first_seen`).
* **Admin fields:** When a member is an admin, we include `admin: true` and `admin_tag` (if available).

</details>

<details>

<summary>Get Most Recent Groups Queried User Has Been Active In</summary>

**Purpose:** Return the most recent groups a user has been seen in (sorted by `last_seen_in_group` desc) and includes token details when available.

Request:

```
GET /recent-groups?query=<user_id|@username>&limit=<n>
Header: x-api-key: YOUR_PARTNER_KEY
```

**Query Params**

* `query` (required): Telegram `user_id` or `@username`.
* `limit` (optional, default 5, max 25): Number of groups to return.

Examples:&#x20;

**cURL (by @username)**

```
curl -H "x-api-key: YOUR_PARTNER_KEY" \
  ".../recent-groups?query=@DataWizz&limit=5"
```

**cURL (by user\_id)**

```
curl -H "x-api-key: YOUR_PARTNER_KEY" \
  ".../recent-groups?query=6137747116&limit=5"

```

Response:

```
{
  "status": "ok",
  "meta": {
    "query": "DataWizz",
    "limit": 5
  },
  "user": {
    "id": 6137747116,
    "username": "DataWizz",
    "display_name": "DataWizz 🧙 (Market Stalker)"
  },
  "results": [
    {
      "group_id": -1002282510595,
      "group_name": "The Market Stalker Community",
      "last_seen_in_group": "2025-11-04T06:41:29+00:00",
      "telegram": {
        "link": "https://t.me/themarketstalker",
        "link_type": "portal"
      },
      "token": {
        "address": "0x522Ec96bCed6dc26325120EdF3931d34E417a620",
        "chain": "ethereum",
        "symbol": "STLKR"
      }
    },
    {
      "group_id": -1003178265398,
      "group_name": "White Monkey",
      "last_seen_in_group": "2025-10-30T23:20:55+00:00",
      "telegram": {
        "link": "https://t.me/whitemonkeyportal",
        "link_type": "portal"
      },
      "token": null
    },
    {
      "group_id": -1002812191154,
      "group_name": "Marie Rose - SPX Mascot 💹🧲🌹",
      "last_seen_in_group": "2025-10-29T22:52:13+00:00",
      "telegram": {
        "link": "https://t.me/marieroseethereum",
        "link_type": "portal"
      },
      "token": {
        "address": "0xcaa1E525ACb44aeC4e0D17a0e2467AA3Ea7EE3A6",
        "chain": "ethereum",
        "symbol": "MARIE"
      }
    },
    {
      "group_id": -1003072270133,
      "group_name": "FRENLY COMMUNITY",
      "last_seen_in_group": "2025-10-28T08:45:06+00:00",
      "telegram": {
        "link": "https://t.me/frenly_portal",
        "link_type": "portal"
      },
      "token": {
        "address": "0x26EcB65d997CBFf18FCa447cB85f6aF1175a22B0",
        "chain": "base",
        "symbol": "FRENLY"
      }
    },
    {
      "group_id": -1002947732445,
      "group_name": "Rhino - Official Ethereum Macot",
      "last_seen_in_group": "2025-10-24T22:36:59+00:00",
      "telegram": {
        "link": "https://t.me/rhinoeth",
        "link_type": "portal"
      },
      "token": null
    }
  ]
}

```

* Sorted by `last_seen_in_group` (desc). If missing, falls back to `first_seen_in_group`.
* `token` block is only returned if data stored includes token metadata (`token_address`, `token_chain`, `token_symbol`).

</details>

<details>

<summary>Get Telegram Group by CA</summary>

**Purpose:** Resolve a token **contract address** to its Telegram group(s). Useful for new launches that haven’t updated listing sites yet. If multiple groups match the same CA, results are sorted by the most recently updated group document (`last_logged_at` desc).

Request:

```
GET /group-by-ca?token_address=<ca>&limit=<n>
Header: x-api-key: YOUR_PARTNER_KEY
```

Example:&#x20;

```
curl -H "x-api-key: YOUR_PARTNER_KEY" \
  ".../group-by-ca?token_address=GFcSfsnVE1jnS6NmSMoYqXWJ1ZgPug9379byxYpump&limit=3"
```

Response:

```
{
  "status": "ok",
  "meta": {
    "token_address": "GFcSfsnVE1jnS6NmSMoYqXWJ1ZgPug9379byxYpump",
    "limit": 3
  },
  "results": [
    {
      "group_id": -1003275229931,
      "group_name": "THE 3 CULT CTO",
      "members_count": 113,
      "last_logged_at": "2025-11-04T11:56:21+00:00",
      "telegram": {
        "link": "https://t.me/the_3_cult_takeover",
        "link_type": "public"
      },
      "token": {
        "address": "GFcSfsnVE1jnS6NmSMoYqXWJ1ZgPug9379byxYpump",
        "chain": "solana",
        "symbol": "3",
        "name": "Three"
      }
    },
    {
      "group_id": -1003145003968,
      "group_name": "THE 3 CULT",
      "members_count": 1436,
      "last_logged_at": "2025-10-30T11:23:00+00:00",
      "telegram": {
        "link": "https://t.me/entryportal_3",
        "link_type": "portal"
      },
      "token": {
        "address": "GFcSfsnVE1jnS6NmSMoYqXWJ1ZgPug9379byxYpump",
        "chain": "solana",
        "symbol": "3",
        "name": "Three"
      }
    }
  ]
}

```

* **Multi-match resolution:**\
  Results are sorted by `last_logged_at` (most recent first).\
  This ensures the most active or recently updated group appears first.
* **Link resolution order:**\
  `portal_username` → `group_public_username` → `invite_link`.\
  If none are found, `link_type` will be `"—"`.
* **Token block:**\
  Includes `address`, `chain`, `symbol`, and  `name` to simplify integration with on-chain data tools.

</details>

<details>

<summary>KOLS by CA</summary>

**Purpose:** Return all **Telegram** and **X (Twitter)** KOLs (Key Opinion Leaders) who mentioned or called a specific token contract.

Each platform includes the **timestamp**, **market cap**, **price at post**, and **source link**.\
This endpoint is designed for influencer analysis, narrative tracking, and first-call detection.

Request:

```
GET /kols-by-ca?token_address=<ca>
Header: x-api-key: YOUR_PARTNER_KEY
```

Example:&#x20;

```
curl -H "x-api-key: YOUR_PARTNER_KEY" \
  ".../kols-by-ca?token_address=8fdBKZq7wo9fJbsZEZhq6omCgvKzLt97HY9XaGgqpump"

```

Response:

```
{
  "status": "ok",
  "meta": {
    "token_address": "8fdBKZq7wo9fJbsZEZhq6omCgvKzLt97HY9XaGgqpump",
    "chain": "sol"
  },
  "token": {
    "name": "Neo 1x Companion",
    "symbol": "NEO"
  },
  "telegram_kols": [
    {
      "account": "ranma_calls_solana",
      "post_url": "https://t.me/Ranma_Calls_Solana/47879",
      "post_timestamp": "2025-10-28T12:08:13Z",
      "post_mc": 72937,
      "post_price": 0.0000729
    },
    {
      "account": "shitcoingemsalert",
      "post_url": "https://t.me/shitcoingemsalert/110433",
      "post_timestamp": "2025-10-28T12:08:34Z",
      "post_mc": 77467,
      "post_price": 0.0000774
    },
    {
      "account": "sultanplays",
      "post_url": "https://t.me/SultanPlays/49102",
      "post_timestamp": "2025-10-28T12:49:06Z",
      "post_mc": 481889,
      "post_price": 0.0004819
    },
    {
      "account": "mreduplays",
      "post_url": "https://t.me/MrEduPlays/4268",
      "post_timestamp": "2025-10-28T13:09:58Z",
      "post_mc": 604311,
      "post_price": 0.0006043
    },
    {
      "account": "wizzytrades",
      "post_url": "https://t.me/WizzyTrades/18662",
      "post_timestamp": "2025-10-28T13:28:08Z",
      "post_mc": 1112042,
      "post_price": 0.001112
    },
    {
      "account": "maybachcalls",
      "post_url": "https://t.me/MaybachCalls/11355",
      "post_timestamp": "2025-10-28T15:59:22Z",
      "post_mc": 3114912,
      "post_price": 0.003115
    }
  ],
  "x_kols": [
    {
      "account": "owarieth",
      "post_type": "tweet",
      "method": "cashtag",
      "post_url": "https://x.com/OwariETH/status/1983340550209319048",
      "post_mc": 1363448,
      "post_price": 0.001363,
      "post_timestamp": "2025-10-28T12:10:10Z"
    },
    {
      "account": "pastelalpha",
      "post_type": "tweet",
      "method": "cashtag",
      "post_url": "https://x.com/PastelAlpha/status/1983394635914637489",
      "post_mc": 3990620,
      "post_price": 0.00399,
      "post_timestamp": "2025-10-28T13:58:25Z"
    },
    {
      "account": "mariuscrypt0",
      "post_type": "quote",
      "method": "cashtag",
      "post_url": "https://x.com/MariusCrypt0/status/1983457468198846914",
      "post_mc": 2913715,
      "post_price": 0.002913,
      "post_timestamp": "2025-10-28T15:41:25Z"
    },
    {
      "account": "evee0x",
      "post_type": "quote",
      "method": "cashtag",
      "post_url": "https://x.com/evee0x/status/1983502049573536250",
      "post_mc": 4182195,
      "post_price": 0.004182,
      "post_timestamp": "2025-10-28T16:11:54Z"
    },
    {
      "account": "traderpaw",
      "post_type": "tweet",
      "method": "cashtag",
      "post_url": "https://x.com/traderpaw/status/1984386148450648446",
      "post_mc": 4223974,
      "post_price": 0.004224,
      "post_timestamp": "2025-10-29T08:45:00Z"
    }
  ]
}

```

#### **Field Reference & Notes**

**Shared Fields (Telegram & X)**

| Field            | Type   | Description                                                     |
| ---------------- | ------ | --------------------------------------------------------------- |
| `account`        | string | The username or channel handle (Telegram or X).                 |
| `post_url`       | string | Direct link to the post or Telegram message.                    |
| `post_timestamp` | string | When the KOL mentioned or posted about the token (ISO8601 UTC). |
| `post_mc`        | number | Market cap at the time of the post (USD).                       |
| `post_price`     | number | Token price at that same time (USD).                            |

**X-Specific Fields**

| Field       | Type   | Description                                                                                |
| ----------- | ------ | ------------------------------------------------------------------------------------------ |
| `post_type` | string | Indicates if the post was an original `tweet`, `retweet`, `quote`, or `reply`.             |
| `method`    | string | How the token was referenced — e.g., `cashtag` (`$NEO`), `ticker`, or direct `CA` mention. |

**Ordering**

* Entries are sorted chronologically (earliest → latest) so you can visualize narrative momentum.
* For first-mention analysis, look at the earliest `post_timestamp` across both platforms.

**Use Cases**

* Identify **who called the token first** on either platform.
* Track **cross-platform hype correlation** (e.g., Telegram calls preceding X posts).
* Detect **organic narrative spreads** vs. coordinated call activity.

</details>

Custom endpoints are available upon request and data avaliablity. Pricing varies by requirements. Contact @DataWizz on Telegram to enquire further.


# Compare Plans

The Market Stalker offers 2 plans: Standard & Premium. Both give access to our Telegram bot however, Premium users gain additional bot benefits & web app access.

See below our comparison table for reference:

<table><thead><tr><th width="187"></th><th data-type="checkbox">Market Stalker (Bot)</th><th data-type="checkbox">Premium (Bot)</th><th data-type="checkbox">Premium (Web App)</th></tr></thead><tbody><tr><td>Instant Alerts</td><td>true</td><td>true</td><td>true</td></tr><tr><td>Unique Tracked Wallet Count</td><td>true</td><td>true</td><td>true</td></tr><tr><td>Unique Tracked Buy Count</td><td>true</td><td>true</td><td>true</td></tr><tr><td>Holding Status of Tracked Wallets</td><td>false</td><td>false</td><td>true</td></tr><tr><td>Quick Buy Functions</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Token Age</td><td>false</td><td>true</td><td>true</td></tr><tr><td>Social Links Scraping</td><td>false</td><td>true</td><td>true</td></tr><tr><td>Volume Info</td><td>false</td><td>true</td><td>true</td></tr><tr><td>Token Safety Checks</td><td>false</td><td>true</td><td>true</td></tr><tr><td>Source of Funds</td><td>false</td><td>true</td><td>true</td></tr><tr><td>Clog Status</td><td>false</td><td>true</td><td>false</td></tr><tr><td>Bundle Info</td><td>false</td><td>false</td><td>true</td></tr><tr><td>Dex Updates</td><td>false</td><td>false</td><td>true</td></tr><tr><td>DexS Boost</td><td>false</td><td>false</td><td>true</td></tr><tr><td>Tracked Calls/KOLs</td><td>false</td><td>false</td><td>true</td></tr><tr><td>Live Charting</td><td>false</td><td>false</td><td>true</td></tr></tbody></table>


# Pay Monthly

Suitable for those who want to try before committing to holding minimum supply requirements, pay monthly offers flexibility and affordability.

There are 2 plans available to choose from, which you can compare [here](/packages/compare-plans).&#x20;

Standard: $149/m (payable in ETH) or $119/m (payable in $STLKR)\
Premium: $389/m (payable in ETH) or $311/m (payable in $STLKR)

To get started:

* DM @TheMarketStalker\_Bot
* Type /subscribe and pick the option to suit you.
* Follow the steps in the bot to gain access.


# Holders Access

Suitable for long-term users holding minimum supply requirements. Buy & Hold to retain access. Sell your tokens at any point without locks.

Depending on how much supply you hold, you have access to one of the following plans, which you can compare [here](/packages/compare-plans).&#x20;

Standard: Hold a minimum of 250,000 $STLKR\
Premium: Hold a minimum of 500,000 $STLKR

To get started:

* DM @TheMarketStalker\_Bot
* Type /subscribe and pick the option to suit you.
* Follow the steps in the bot to gain access.


# Tokenomics

Token Name: Market Stalker\
Symbol: $STLKR

Total Supply: 100,000,000\
Decimals: 18\
Buy Tax: 5%\
Sell Tax: 5%

Contract Address: TBC\
Chain: Ethereum


# Holder Benefits

When considering an investment in $STLKR tokens, it's only natural to ask, what are the benefits of Holding? In this section, we'll break down the 3 main reasons to hold the official Market Stalker token.

### **Access to our tools**

Our larger supporters can gain access without needing to subscribe to a monthly plan!

Holders with at least 0.25% supply (250,000 $STLKR tokens) can gain access without a monthly fee to the standard Market Stalker bot. Holders with at least 0.5% supply (500,000 $STLKR tokens) can gain access to the premium package without a monthly fee.

### **Provide suggestions and participate in votes on changes.**

As part of our ongoing enhancement approach and community-led vision, all holders can provide suggestions and participate in voting on proposed changes. Larger holders will have more weight applied to their votes, and smaller holders can group up to achieve their desired outcome.

### **Price Speculation**

Investors want their investments to grow in value. That is why we have taken all possible steps to ensure that an investment in $STLKR tokens is desirable.&#x20;

Through a range of approaches, we've created some enticing reasons for holders to hold supply, which in turn makes supply scarce, leading to a price increase.&#x20;

The $STLKR token is the most popular way to access our tools. Either pay directly in $STLKR tokens or hold enough $STLKR tokens that a monthly subscription is not required.&#x20;

By ensuring there are holder benefits beyond price speculation, we unlock the ability for supply to become limited due to a lack of holders wanting to part with their tokens.&#x20;


# Community

The Market Stalker community is an active space where we discuss everything related to Market Stalker as well as the signals that are being called by the bot.

Join our community to connect and engage:

* Telegram: [Join us on Telegram](https://t.me/TheMarketStalker)
* X (formerly Twitter): [Follow us on X](https://x.com/MarketStalker_x)


# Contact

We hope that you have been able to find all the information out in the documentation provided however, if you still have questions, our team are always around and happy to help.

At first, please reach out in our community Telegram: [@TheMarketStalker](https://t.me/TheMarketStalker) where one of the admins will answer your question or be able to best route your enquiry.

You can also contact us by email: <themarketstalker@hotmail.com>


# Terms

By accessing and using The Market Stalker platform, you agree to comply with the following terms. The Market Stalker offers tools related to cryptocurrency, such as analytics, alerts, token discovery, and influencer tracking. It does not provide financial advice, investment recommendations, or any guarantees. All information is for general informational purposes only. You are solely responsible for your investment decisions and are encouraged to conduct your own research and due diligence before acting on any insights from the platform.

Access to any features requires holding an amount of $STLKR tokens or a subscription paid in $STLKR tokens to ETH. Details regarding pricing, tiers, and available functionality can be found in the Tiers & Access section. All payments and sales are final unless explicitly stated otherwise. By using our services, you agree to the terms related to token use and understand that access depends on an active subscription.

The Market Stalker reserves the right to change, suspend, or discontinue any part of the platform, including paid features, at any time without prior notice. Any misuse of the platform, including but not limited to fraud, account manipulation, unauthorised data scraping, spam, interference with bots or alert systems, or intellectual property violations, may lead to immediate suspension or permanent termination of your account. We also reserve the right to restrict or revoke access if your actions negatively affect other users or the platform’s stability.


# Privacy

The Market Stalker values and respects your privacy. We only collect and store data essential for delivering our services effectively, personalising your experience, and maintaining platform performance. Data collected may include, but is not limited to your Telegram user ID and alert preferences.

We do not collect sensitive information such as financial account data or private keys. The Market Stalker will never sell, lease, or disclose your personal information to third parties. Any third-party services integrated with the platform, such as Telegram or blockchain explorers, may have separate privacy policies.

All data is stored securely using encrypted protocols and strict access control. You have the right to request access, correction, or deletion of your personal data by contacting our support team through the Help Center. Account deletion requests will result in the removal of all user-linked data within a reasonable time frame, subject to compliance requirements.


