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

# Getting started

## 1. Open the bot and press Start

Search for @taligatebot on Telegram and send `/start`. Two things happen: your account is created (no email, no KYC, nothing to fill in), and a **7-day Pro trial** activates automatically. During the trial you have 20 wallet slots, instant alerts within roughly a minute of a trade, and a daily digest. When it ends you drop to the Free plan and nothing is charged - there is no payment method on file.

## 2. Find a wallet worth tracking

Any Polymarket profile URL contains the wallet address:

```
polymarket.com/profile/0x1f2a...c4d9
                        ^^^^^^^^^^^^ this part
```

The address is a 0x-prefixed, 42-character hex string. Common places to find ones worth following: the Polymarket leaderboard, the holder list on a market you are watching, and X threads where people post screenshots of large bets. Copy the address directly from the URL bar or from whatever the post linked.

## 3. Track it

Tap the **Track** button in your keyboard, or send `/track` followed by the address. The bot fetches the trader's public Polymarket name and offers it as the default nickname. Type your own name, or send `/skip` to keep theirs. Either way you can rename it later from `/list`.

To add several at once, paste up to 25 addresses in a single message, separated by spaces or line breaks. Bulk adds skip the per-wallet prompt and assign Polymarket names automatically. The bot replies with a summary: how many were added, how many were already in your list, how many were over your plan limit, and how many were invalid.

The first poll after tracking only records the current snapshot. You will not get a wave of "new position" alerts for trades the wallet already holds - only changes from that point on.

## 4. Tune the noise

Most traders make a lot of small moves. Without filters, a busy whale will spam your chat. There are two places to set them.

`/settings` sets your account defaults: the four event types (New position, Closed, Increased, Decreased) you can toggle on or off, four numeric thresholds (minimum position value in USD, minimum size change as a percent, minimum absolute shares change, minimum PnL in USD), and the consensus setting. A threshold of 0 means no filter. These defaults apply to every wallet you track unless you override them individually.

For a single wallet, open `/list`, find the wallet card, and tap **Alerts**. Each threshold shows as "inherited" (using your account default) or "custom". Change it for that wallet only, or tap Reset to go back to the default. A starting point for a high-volume wallet: set a minimum position value around $500 and a minimum size change around 10%.

Muting a wallet from its card in `/list` stops alerts without removing the wallet. The bot keeps polling it in the background, so unmuting does not trigger a false-alarm flood of old changes.

Consensus alerts are off by default. Turn them on in `/settings` by setting a number N greater than zero. When N or more of your tracked wallets hold the same market outcome, you get a single grouped alert instead of separate ones for each.

For a full breakdown of every filter option, see the Alerts and filters page.

## 5. Read the digest

During your trial and on any paid plan, the bot sends a daily digest at 09:00 UTC. Each wallet gets its own summary: open position count, total current value, total PnL, how that PnL changed since yesterday, and the top positions by size. On a busy day this is often easier to read than catching individual alerts.

You can pull the digest any time with `/digest`. On the Free plan it covers your one tracked wallet and includes a note about what a paid plan adds. The automatic morning push is a paid-plan feature only.

## Next steps

* `/top` ranks your active wallets by current unrealized PnL (top 10, with medals for the top three).
* `/plan` shows the four tiers - Free, Basic at $5/month, Pro at $10/month, Whale at $20/month - and lets you subscribe or upgrade.
* `/ref` gives you a referral link. You earn 20% of every payment your invitees make, credited to an internal balance you can spend on your own subscription or withdraw from $20.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.taligate.com/getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
