# Sign-in and balance (https://docs.scannor.xyz/account)

## Sign in [#sign-in]

Sign in on scannor.xyz with X, Google, email or a Solana wallet. No card and no wallet are needed to start. Your agent opens the sign-in page the first time it calls scannor; in Telegram there is nothing to sign in to.

## The free $2 [#the-free-2]

A new account starts with $2 free. At $0.01 for most answers, that is up to 200 answers before you pay anything.

## Balance [#balance]

scannor runs on a prepaid balance in dollars. Each paid answer takes its price from the balance and says what it cost and what is left, for example: "This scan cost $0.07, $9.81 left." Ask the free [`balance`](/tools/balance) tool any time for the balance and your last calls.

When the balance is too low for a call, the answer says so and gives your top-up link. Nothing is charged.

## Top up [#top-up]

Ask scannor for a top-up link, in Telegram or in your agent (the free [`topup`](/tools/topup) tool). You get a page with your account's own deposit address. Send any amount of SOL or USDC there and it is added to the balance once it lands. There is no subscription and nothing renews.

## Wallet alerts [#wallet-alerts]

Tracking a wallet is billed per alert: each buy or sell of a tracked wallet is $0.01 from the balance. When the balance runs out, tracking that wallet stops; top up and track it again. See [`track_wallet`](/tools/track-wallet).


# Coverage (https://docs.scannor.xyz/coverage)

## Chains [#chains]

| Chain | What scannor reads | Tracking |
| --- | --- | --- |
| Solana | Tokens, holders, launches and wallet profiles | Yes |
| Robinhood Chain | Tokens, holders, launches and wallet profiles | Not yet |

Token and wallet tools read the chain from the address: a base58 address is Solana, a `0x` address is Robinhood Chain. [`launched`](/tools/launched), [`trending`](/tools/trending) and [`new_launches`](/tools/new-launches) take `chain`: `solana` (the default), `robinhood` or `all`. Base and BNB Chain come after v1.

## Launchpads [#launchpads]

| Chain | Launchpads read |
| --- | --- |
| Solana | pump.fun, letsbonk.fun, Meteora, bags |
| Robinhood Chain | pons, ape.store, long.xyz, wormbook |

Each token answer says which launchpad it came from and whether it is still on its curve or graduated. On Robinhood Chain, tokens deployed directly, without a launchpad, are read too.

## Social [#social]

| Platform | What scannor reads |
| --- | --- |
| X | Posts spreading now, any search, single posts with their replies, what named accounts posted, posts naming a contract address, the curators' nightly recaps |
| TikTok | Videos matching a story: views, likes, author, the credited original |
| Instagram | Reels matching a story: views, likes, author, the credited original |

Social platforms have no chain: one story search covers tokens on both chains.

## How fresh [#how-fresh]

Token and market reads are at most a minute or two old; X reads a few minutes; wallet profiles up to an hour. Each answer's `cached_s` says how old it is. Every tool page lists its own freshness.

scannor reads X and the chains itself.


# FAQ (https://docs.scannor.xyz/faq)

## What is scannor? [#what-is-scannor]

A research agent for onchain traders. It reads X, TikTok, Instagram and the launchpads on Solana and Robinhood Chain, links stories to the tokens launched on them, and checks those tokens and the wallets behind them. You use it in Telegram, or in Claude Code, Codex, Cursor and any MCP client.

## What does it cost? [#what-does-it-cost]

Your first $2 is free. After that you pay per answer: $0.01 or $0.02 for most checks, about $0.06 for a full scan of what is running. Top up in SOL or USDC. No subscription, and failed calls cost nothing. Every price is on [Pricing](/pricing).

## Do I need a wallet to start? [#do-i-need-a-wallet-to-start]

No. Sign in with X, Google or email. You only need SOL or USDC when you top up.

## What does it read? [#what-does-it-read]

Posts and videos on X, TikTok and Instagram, and the tokens, holders and wallets on the launchpads of Solana and Robinhood Chain. scannor reads all of it itself. See [Coverage](/coverage).

## How is it different from a chart or a token screener? [#how-is-it-different-from-a-chart-or-a-token-screener]

A chart starts when the token exists. scannor starts with the story: what is spreading, whether it has a token yet, who launched it, who bought first and whether those wallets were early in other launches. It puts a story's reach and a token's holders in the same answer.

## Where do the facts come from? [#where-do-the-facts-come-from]

From tool answers only. scannor never invents a story, a reason a token ran, or who is behind a wallet. When something could not be verified (a deleted post, a fake market, a count that is only a floor), the answer says so.

## Does it label wallets? [#does-it-label-wallets]

No. It reports what a wallet did, in numbers: when it bought, what it holds, who funded it. It never calls a wallet an insider or names a person unless a tool answer says so with a source.

## Does it trade for me? [#does-it-trade-for-me]

No. scannor reads and reports. It never holds your funds and never places a trade. A top-up link only shows your deposit address; it never pays or sends anything.

## Can others see what I track? [#can-others-see-what-i-track]

No. scannor never shows who else tracks a wallet, or how many do.

## How do I use it from my own agent? [#how-do-i-use-it-from-my-own-agent]

Add the MCP server `https://mcp.scannor.xyz/mcp`, or install the plugin for Claude Code or Codex. Agents can read these docs in one fetch at [/llms-full.txt](https://docs.scannor.xyz/llms-full.txt). See the [quickstart](/quickstart).

## Is this financial advice? [#is-this-financial-advice]

No. scannor shows what it found, with the numbers next to it. You decide what to do.


# What is scannor (https://docs.scannor.xyz/)

Every token that runs starts as a story: a post on X, a video on TikTok, a reel on Instagram. By the time it shows up on a chart, the early part is over.

scannor reads X, TikTok, Instagram and the launchpads on Solana and Robinhood Chain as one feed. It connects every story to the tokens launched on it, and every token to its dev, its first buyers and its risks. You ask in plain words; it answers with the numbers and the links next to them.

## What it answers [#what-it-answers]

- **What is starting to run right now**, and which stories have no token yet.
- **Is this story launched**, and which token leads it.
- **Is this token bundled**: who bought in the launch block, what the dev holds, which holders share a funder.
- **The lore of a token**: where it started, who pushed it, how much X really talks about it.
- **Did a big name touch anything**: what the accounts you name posted or replied to.
- **Who is this wallet**, and alerts on every buy and sell it makes.

## Where it lives [#where-it-lives]

In Telegram as [@scannorxyzbot](https://t.me/scannorxyzbot), and in AI agents: Claude Code, Codex, Cursor and any MCP client, through the server at `https://mcp.scannor.xyz/mcp` and the scannor skills. The [quickstart](/quickstart) takes a minute.

## What it costs [#what-it-costs]

Pay per answer from a prepaid balance. Answers from $0.01, a token check $0.02, a full scan of what is running about $0.06. The first $2 is free, and failed calls cost nothing. See [Pricing](/pricing).

## What makes it different [#what-makes-it-different]

- **Stories and chains in one place.** Social reach and onchain data in the same answer, so you see a story's views next to its token's cap and holders.
- **A memory of wallets.** Every check adds to scannor's own graph of devs and early wallets, so a check tells you which holders it has seen early in launches before, and how those launches did.
- **Facts, not verdicts.** Every claim comes from a tool answer, with what could not be verified said plainly. scannor reads and reports. It never holds your funds and never places a trade.

<Cards>
  <Card title="Quickstart" href="/quickstart" description="Telegram, Claude Code, Codex, Cursor or any MCP client." />
  <Card title="Use cases" href="/use-cases/running-now" description="The questions scannor is built for." />
  <Card title="Tools" href="/tools" description="All 17 tools, their inputs and prices." />
  <Card title="Pricing" href="/pricing" description="Every price, cheapest first." />
</Cards>


# Pricing (https://docs.scannor.xyz/pricing)

Pay per answer from a prepaid balance in dollars. A new account starts with $2 free: up to 200 answers. No subscription, nothing renews, and you top up in SOL or USDC.

## Every tool, cheapest first [#every-tool-cheapest-first]

| Tool | Answers | Price |
| --- | --- | --- |
| [`balance`](/tools/balance) | Your balance and last calls | Free |
| [`topup`](/tools/topup) | A link to add balance | Free |
| [`tracked`](/tools/tracked) | Recent trades of your tracked wallets | Free |
| [`viral`](/tools/viral) | Posts spreading across X now | $0.01 |
| [`recaps`](/tools/recaps) | The curators' nightly lists of what ran and why | $0.01 |
| [`search_x`](/tools/search-x) | Posts for any X search | $0.01 |
| [`post`](/tools/post) | One post, its parent and top replies | $0.01 |
| [`launched`](/tools/launched) | Tokens launched on a story | $0.01 |
| [`token`](/tools/token) | One token: links, origin post, market numbers | $0.01 |
| [`trending`](/tools/trending) | Launchpad tokens with the most real buyers | $0.01 |
| [`new_launches`](/tools/new-launches) | The newest launches with buyers | $0.01 |
| [`wallet_profile`](/tools/wallet-profile) | One wallet: early buys, funder, history | $0.01 |
| [`track_wallet`](/tools/track-wallet) | Alerts on a wallet's buys and sells | $0.01 an alert |
| [`attention`](/tools/attention) | Posts on X naming a token's address | $0.01 a page |
| [`big_names`](/tools/big-names) | What the accounts you name posted | $0.01 per 10 accounts |
| [`search_video`](/tools/search-video) | A story on TikTok or Instagram | $0.01 per platform |
| [`check_token`](/tools/check-token) | Whether a token is bundled | $0.02 |

## What a question usually costs [#what-a-question-usually-costs]

| Question | What it runs | Cost |
| --- | --- | --- |
| [Track a wallet](/use-cases/track-wallet) | `wallet_profile`, then an alert on each buy or sell | $0.01 + $0.01 an alert |
| [Check a token](/use-cases/check-token) | `check_token` and `token` | $0.03 |
| [Big names](/use-cases/big-name-touch) | `big_names`, `post`, `launched` for 10 accounts | $0.03 to $0.06 |
| [Is this story launched](/use-cases/story-launched) | `post`, `search_x`, `launched`, `check_token` | $0.04 to $0.06 |
| [Betas](/use-cases/beta) | `launched`, `post`, `attention` | $0.05 to $0.08 |
| [Token lore](/use-cases/token-lore) | `token`, `post`, `attention`, `launched`, `check_token` | about $0.06 |
| [What is running now](/use-cases/running-now) | `viral`, `trending`, `recaps`, `launched` | about $0.06 |

Before running more than $0.10 of calls for one question, scannor says the plan and its cost.

## What is never charged [#what-is-never-charged]

- **Failed calls.** When a source is down or the chain is slow, the price is refunded and the answer says "Nothing was charged".
- **Bad input.** A wrong address, a chain scannor does not read yet, or too many calls at once cost nothing.
- **Free tools.** `balance`, `topup` and `tracked`, and starting or stopping tracking.

An empty answer is still an answer and costs the call's price: "No token on this story yet" can mean the story is open, and that is worth knowing.

## Wallet alerts [#wallet-alerts]

Each buy or sell of a wallet you track is one alert at $0.01, from your balance. There are no free wallets and no monthly fee. When the balance runs out, tracking that wallet stops.

## Every answer shows its cost [#every-answer-shows-its-cost]

Each paid answer carries what it cost and what is left, so the agent ends with a line like "This scan cost $0.07, $9.81 left." When the balance is too low, the answer gives your top-up link and charges nothing.


# Quickstart (https://docs.scannor.xyz/quickstart)

The quickest way to set up an agent: tell it `set up scannor - scannor.xyz/llms.txt`. It reads the steps for its own app and runs them. The steps by hand are below.

## Telegram [#telegram]

No setup. Open [@scannorxyzbot](https://t.me/scannorxyzbot) and say hi.

## Claude Code [#claude-code]

Type these two slash commands in Claude Code (they are Claude Code commands, not shell commands):

```text
/plugin marketplace add scannorxyz/scannor-skills
/plugin install scannor@scannor
```

The plugin brings the scannor MCP server and the scannor skills. Then sign in: type `/mcp`, pick scannor, then pick Authenticate. A sign-in page on scannor.xyz opens in the browser.

Server only, without the skills:

```bash
claude mcp add --transport http scannor https://mcp.scannor.xyz/mcp
```

## Codex [#codex]

```bash
codex plugin marketplace add scannorxyz/scannor-skills
codex plugin add scannor@scannor
codex mcp login scannor
```

The last command opens the sign-in page on scannor.xyz. Server only, without the skills:

```bash
codex mcp add scannor --url https://mcp.scannor.xyz/mcp
```

## Cursor [#cursor]

Add scannor as an MCP server in `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

```json
{
  "mcpServers": {
    "scannor": { "url": "https://mcp.scannor.xyz/mcp" }
  }
}
```

Sign in when Cursor asks. A sign-in page on scannor.xyz opens in the browser.

## Any other MCP client [#any-other-mcp-client]

Add the remote MCP server `https://mcp.scannor.xyz/mcp` (streamable HTTP). It uses OAuth: the client opens the sign-in page when the first call has no token.

## Check that it works [#check-that-it-works]

Call the [`balance`](/tools/balance) tool. It is free and shows the balance left. Then ask a first question:

- What is starting to run on X right now?
- What is going viral on TikTok with no token yet?
- Is $SWORDCAT bundled?
- Who is this wallet, and what did it buy early?

If a call answers "Sign in to scannor first", repeat the sign-in step for your app.


# attention (https://docs.scannor.xyz/tools/attention)

It searches the contract address itself, never the ticker, so bots shilling other addresses under the same ticker stay out.

**Price:** $0.01 a page.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `mint` | The token: a contract address. | Required |
| `pages` | How many pages of posts: 1 to 3. | 1 |

## What comes back [#what-comes-back]

- `posts`, `authors` and their reach
- `posts_under_100_views`: often bots
- `other_mints_named`: other tokens posted next to this one, often its betas
- `page_full`: the counts are a floor
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 5 minutes: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> Nobody on X has posted this contract address yet.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# balance (https://docs.scannor.xyz/tools/balance)

Call it first to check that scannor is set up.

**Price:** Free.

## Inputs [#inputs]

None.

## What comes back [#what-comes-back]

- `left`: the balance in dollars
- `tracked`: how many wallets you track
- `last_calls`: your last five paid calls, with what each cost

## Freshness [#freshness]

Live: read on every call.


# big_names (https://docs.scannor.xyz/tools/big-names)

scannor keeps no list of its own: you pick the accounts. A reply is often only an emoji: call [`post`](/tools/post) on it to read the parent, which is the story.

**Price:** $0.01 per 10 accounts. Very busy accounts get a search of their own, so 8 accounts plus one very busy one is $0.02.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `accounts` | With or without the @: 1 to 20 X handles. | Required |
| `hours` | How far back to look: 1 to 48. | 12 |
| `replies` | Include replies, not only posts: true or false. | On |

## What comes back [#what-comes-back]

- `posts`: each post or reply, with `reply_to` (the post it answers) and `tokens_linking`
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 5 minutes: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.


# check_token (https://docs.scannor.xyz/tools/check-token)

Block-0 is the launch's own block: only wallets ready before the launch buy there. Its findings are facts about the token, never verdicts about a person.

**Price:** $0.02.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `mint` | The token: a contract address. | Required |
| `chain` | Only needed to override: base58 is Solana, `0x` is Robinhood Chain: `solana` or `robinhood`. | Read from the address |

## What comes back [#what-comes-back]

- `findings`: plain sentences, the ones worth a second look first (`look: true`)
- `stats.block0`: wallets, the share they bought and the share they hold now
- `stats.dev`, `stats.top10`, `stats.linked`, `stats.fresh` and `stats.wash`
- `graph.wallets`: holders scannor has seen before, how many launches each was early in and how many ran past $1M
- `stats.covered`: false when the read stopped early on a busy launch, so early numbers are a floor
- Robinhood Chain also gives `launchpad` and `holders_count`
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 1 minute: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> No trades found for this token.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# All tools (https://docs.scannor.xyz/tools)

Every tool is on the MCP server at `https://mcp.scannor.xyz/mcp`. Clients prefix the names: `mcp__scannor__launched`, or `mcp__plugin_scannor_scannor__launched` from the plugin. In Telegram, the bot picks the tools for you.

## X, TikTok and Instagram [#x-tiktok-and-instagram]

| Tool | Answers | Price |
| --- | --- | --- |
| [`viral`](/tools/viral) | Posts spreading across all of X right now, ranked by likes in a 1h, 6h or 24h window. | $0.01 |
| [`recaps`](/tools/recaps) | The curators' nightly "what you missed today" lists: which tokens ran and why, in their words. | $0.01 |
| [`big_names`](/tools/big-names) | What the X accounts you name (1 to 20 handles) posted or replied to lately. | $0.01 per 10 accounts |
| [`search_x`](/tools/search-x) | Posts for any X search in X's own syntax: quoted phrases, OR, from:, min_faves:. | $0.01 |
| [`post`](/tools/post) | One X post by link or id: its numbers, its author, the post it replies to, and its top replies. | $0.01 |
| [`search_video`](/tools/search-video) | Whether a story is on TikTok or Instagram Reels, and how big: matching videos with views, likes, author, post time and link. | $0.01 per platform |

## Tokens [#tokens]

| Tool | Answers | Price |
| --- | --- | --- |
| [`launched`](/tools/launched) | Tokens already launched on a story (a name, ticker or short phrase) on Solana, Robinhood Chain or both. | $0.01 |
| [`token`](/tools/token) | One token by contract address: its links, its origin post, market numbers, and what scannor already knows about its dev and early wallets. | $0.01 |
| [`attention`](/tools/attention) | How much X talks about a token: posts naming its contract address, their authors and reach, and the share of posts under 100 views, which are often bots. | $0.01 a page |
| [`trending`](/tools/trending) | Launchpad tokens trading most right now, ranked by real buyers, with big established tokens left out. | $0.01 |
| [`new_launches`](/tools/new-launches) | The newest launches that already have holders or buyers, newest first. | $0.01 |

## Holders and wallets [#holders-and-wallets]

| Tool | Answers | Price |
| --- | --- | --- |
| [`check_token`](/tools/check-token) | Whether a token is bundled: the Block-0 share, what the dev bought and holds, the top 10, holders linked by a shared funder or one transaction, new wallets, and what scannor knows about those wallets. | $0.02 |
| [`wallet_profile`](/tools/wallet-profile) | One wallet: its early buys, the launches it was early in and how they did, its funder, its X mentions, and what scannor already knows. | $0.01 |

## Tracking [#tracking]

| Tool | Answers | Price |
| --- | --- | --- |
| [`track_wallet`](/tools/track-wallet) | Start or stop tracking a Solana wallet you chose. Each buy or sell it makes is one alert. | $0.01 an alert |
| [`tracked`](/tools/tracked) | Recent buys and sells of your tracked wallets, and tokens two or more of them bought. | Free |

## Account [#account]

| Tool | Answers | Price |
| --- | --- | --- |
| [`balance`](/tools/balance) | Your balance in dollars, how many wallets you track, and your last paid calls. | Free |
| [`topup`](/tools/topup) | A link where you add balance in SOL or USDC. | Free |


# launched (https://docs.scannor.xyz/tools/launched)

It matches names, not meaning: read each row's name and `x` link to check it is the same story. A token flagged `thin` has a cap or market that is not real: it is never the leader.

**Price:** $0.01.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `story` | A name, ticker or short phrase: 1 to 60 characters. | Required |
| `max` | How many tokens: 1 to 20. | 10 |
| `include_dead` | Include tokens that no longer trade: true or false. | Off |
| `chain` | Which chain to read: `solana`, `robinhood` or `all`. | `solana` |

## What comes back [#what-comes-back]

- `tokens`: cap, holders, age, launchpad, curve or graduated, the dev with `dev_launches` and `dev_graduated`, `change_1h_pct`, `net_buyers_24h`, the `x` link and the `thin` flag
- `leader_share_pct`: over 80 means the story has one token; under 50, buyers are split
- `saturation_24h`: how many tokens launched on the story in the last day
- `dropped_dead`: tokens launched on it that no longer trade
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 2 minutes: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> No token on 'takur' yet. That can mean the story is open.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# new_launches (https://docs.scannor.xyz/tools/new-launches)

Most new tokens never trade, so an empty list is a real answer.

**Price:** $0.01.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `hours` | How far back to look: 1 to 24. | 1 |
| `max` | How many tokens: 1 to 30. | 20 |
| `chain` | Which chain to read: `solana`, `robinhood` or `all`. | `solana` |

## What comes back [#what-comes-back]

- `with_buyers`: new tokens that already have buyers
- `just_now`: launches from the last minutes
- `dropped_empty`: launches left out because nobody bought
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 1 minute: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> No new launch with buyers in the last 6 hours.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# post (https://docs.scannor.xyz/tools/post)

If the answer says the post is gone, it is gone: scannor never guesses what it said.

**Price:** $0.01.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `post` | The X post: a link or id. | Required |
| `replies` | How many top replies to read: 0 to 40. | 20 |

## What comes back [#what-comes-back]

- `post`: text, views, likes, author
- `reply_to`: the parent post, which is often the story
- `replies`: the top replies
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 10 minutes: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> That post is gone: deleted or private.
> That post is gone: the account that posted it is suspended.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# recaps (https://docs.scannor.xyz/tools/recaps)

Each line is the curator's claim: cite it as theirs. Use recaps as context for which kinds of story are paying this week.

**Price:** $0.01.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `days` | How many nights of recaps: 1 to 3. | 1 |

## What comes back [#what-comes-back]

- `posts`: each recap, with the tokens it names and the reason the curator gives
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 5 minutes: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> No recap posted since 2026-10-26 yet. Curators post around 22:00 to 00:00 UTC.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# search_video (https://docs.scannor.xyz/tools/search-video)

Only videos whose caption matches the story count, and the answer says how many were off topic. It also shows whom captions credit as the original.

**Price:** $0.01 per platform. Both platforms is $0.02.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `query` | The story: up to 100 characters. | Required |
| `platform` | Where to look: `tiktok`, `instagram` or `both`. | `both` |
| `days` | How far back to look: 1, 7 or 30. | 7 |

## What comes back [#what-comes-back]

- `videos`: views, likes, author, post time and link
- the credited original, and how many matches were off topic
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 10 minutes: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> No TikTok video from the last 7 days matches 'cat in armor'.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# search_x (https://docs.scannor.xyz/tools/search-x)

Bare words must all match: use a quoted phrase or OR, never a list of loose words. Search a token by its contract address, never by its ticker: tickers are shared by unrelated tokens and bots.

**Price:** $0.01.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `query` | The search, in X's syntax: up to 300 characters. | Required |
| `mode` | Most engaged first, or newest first: `top` or `latest`. | `top` |
| `hours` | Only posts from the last hours: 1 to 168. | Optional |
| `min_likes` | Only posts with at least this many likes: a number. | Optional |
| `cursor` | The next page, from the last answer: text. | Optional |

## What comes back [#what-comes-back]

- `posts`: text, author, likes, views and link of each match
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 3 minutes: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> X found nothing for that search. Fewer words, or OR between them: bare words must all match.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# token (https://docs.scannor.xyz/tools/token)

Metadata links were set at launch, profile links later: the answer says which is which.

**Price:** $0.01.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `mint` | The token: a contract address. | Required |
| `chain` | Only needed to override: base58 is Solana, `0x` is Robinhood Chain: `solana` or `robinhood`. | Read from the address |

## What comes back [#what-comes-back]

- `links` and `origin_post`: where the token says it comes from
- market numbers: cap, holders, age, `traders_24h`, `organic_buyers_24h`
- the dev with `dev_launches` and `dev_graduated`
- `chart` and `explorer` links
- `graph`: what scannor has seen of the dev and early wallets before
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 1 minute: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> No market for this address yet: it may be brand new or not a token.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# topup (https://docs.scannor.xyz/tools/topup)

It only makes a link: it never pays or sends anything. The page shows your account's own deposit address, and any amount of SOL or USDC sent there is added once it lands.

**Price:** Free.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `usd` | The amount the page suggests: 10, 25 or 50. | 10 |

## What comes back [#what-comes-back]

- `url`: your top-up page
- `gets`: the dollars the suggested amount adds

## Freshness [#freshness]

Live: read on every call.


# track_wallet (https://docs.scannor.xyz/tools/track-wallet)

In Telegram each trade arrives as a message; in Claude Code, Codex and Cursor ask [`tracked`](/tools/tracked) for them. When the balance runs out, tracking that wallet stops. scannor never shows who else tracks a wallet, or how many do.

**Price:** $0.01 an alert. Starting and stopping are free. Each buy or sell of the wallet is one alert at $0.01, from the balance.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `wallet` | The wallet to track: a Solana wallet. | Required |
| `label` | Your name for it, shown on each alert: up to 40 characters. | Optional |
| `stop` | Stop tracking it: true or false. | Off |

## What comes back [#what-comes-back]

- the wallet, its label, and whether it is now tracked
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Live: read on every call.

## Answers that stop it [#answers-that-stop-it]

> Tracking covers Solana wallets for now.
> Tracking needs a balance above $0: top up at https://scannor.xyz/topup


# tracked (https://docs.scannor.xyz/tools/tracked)

**Price:** Free.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `wallet` | Only this wallet: a tracked wallet. | All of them |
| `hours` | How far back to look: 1 to 168. | 24 |

## What comes back [#what-comes-back]

- `trades`: time, buy or sell, token and SOL
- `together`: tokens two or more tracked wallets bought
- `stopped`: wallets no longer tracked because the balance ran out

## Freshness [#freshness]

Live: read on every call.


# trending (https://docs.scannor.xyz/tools/trending)

Real buyers count more than volume, and the answer gives both.

**Price:** $0.01.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `window` | The trading window: `5m`, `1h`, `6h` or `24h`. | `1h` |
| `max` | How many tokens: 1 to 20. | 10 |
| `launchpad` | Only tokens from one launchpad: a launchpad name. | `any` |
| `chain` | Which chain to read: `solana`, `robinhood` or `all`. | `solana` |

## What comes back [#what-comes-back]

- `tokens`: ranked by real buyers, with volume, cap, holders and age
- `left_out_big`: how many big established tokens were left out
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 1 minute: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> No launchpad token is trading much in the last 1h.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# viral (https://docs.scannor.xyz/tools/viral)

Use it to find stories, then call [`launched`](/tools/launched) on each story to see which tokens are already on it.

**Price:** $0.01.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `window` | How far back to look: `1h`, `6h` or `24h`. | `24h` |
| `min_likes` | Only posts with at least this many likes: 100 to 1,000,000. | Set for the window |
| `media` | Only posts with a picture or video. Memes are pictures and videos: true or false. | Off |
| `lang` | Language of the posts: language code. | `en` |
| `cursor` | The next page, from the last answer: text. | Optional |

## What comes back [#what-comes-back]

- `posts`: text, author, likes, views and the link of each post
- `tokens_linking`: how many tokens scannor already knows that link the post. Above 0 means the story is launched.
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 3 minutes: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> Nothing on X passed 3000 likes in the last 6h. Lower min_likes.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# wallet_profile (https://docs.scannor.xyz/tools/wallet-profile)

It reports numbers only, and never labels the wallet or names a person.

**Price:** $0.01.

## Inputs [#inputs]

| Input | What it takes | Default |
| --- | --- | --- |
| `wallet` | The wallet: a wallet address. | Required |
| `chain` | Only needed to override: base58 is Solana, `0x` is Robinhood Chain: `solana` or `robinhood`. | Read from the address |

## What comes back [#what-comes-back]

- `early_in`: launches where it bought within 60 seconds of the create
- `early_tokens_ran_past_1m`: how many of those ran past $1M
- `funder`, and `busy` when the funder is an exchange
- `x_posts`: posts on X that name the wallet
- `graph.shares_funder_with`: other wallets with the same funder
- `_billing`: what the call cost and what is left, in dollars

## Freshness [#freshness]

Answers are shared for up to 1 hour: the same question in that time gets the same read, and `cached_s` says how old it is, in seconds.

## When there is nothing to show [#when-there-is-nothing-to-show]

> This wallet has no transactions.

This is a real answer and costs the call's price. Failures are refunded: see [Pricing](/pricing).


# Anything else (https://docs.scannor.xyz/use-cases/anything-else)

**Typical cost:** depends on the question. Above $0.10, scannor says the plan and its cost first. **Skill:** `scannor`.

## Ask [#ask]

- Compare these two devs.
- Who funded the top holders of this token?
- What else did this dev launch?
- Did these wallets buy together?
- How much is this token talked about?

## How it picks the route [#how-it-picks-the-route]

- **Nothing, and you want what is moving now:** [`trending`](/tools/trending) or [`new_launches`](/tools/new-launches), then [`token`](/tools/token) and [`check_token`](/tools/check-token) on what stands out.
- **A story, and you want its tokens:** [`search_x`](/tools/search-x), [`search_video`](/tools/search-video), [`launched`](/tools/launched), then [`check_token`](/tools/check-token) on the leader.
- **A token, and you want its story:** [`token`](/tools/token), [`post`](/tools/post), [`attention`](/tools/attention), and [`launched`](/tools/launched) for rivals.
- **A token, and you want its holders:** [`check_token`](/tools/check-token), then [`wallet_profile`](/tools/wallet-profile) on the holders that stand out.
- **A wallet or a dev:** [`wallet_profile`](/tools/wallet-profile); for a dev, [`token`](/tools/token) gives its launches and graduations.
- **Accounts, and you want their moves:** [`big_names`](/tools/big-names), then [`post`](/tools/post) on replies.

"Compare these devs" is `token` on one token of each dev, then `wallet_profile` on each dev. "Who funded the top holders" is `check_token`, then `wallet_profile` on a funder shared by several holders.

## Rules every answer keeps [#rules-every-answer-keeps]

- **Facts come from tool answers only.** When no post explains a move, the answer says "no post found that explains it".
- **What could not be verified is said:** a deleted post, a count that is only a floor, a fake market, a missing field, a tool that failed.
- **Facts in a plain voice,** never a label on a wallet or a person unless a tool answer says so with a source. Never a promise of buyers, a price or a return.
- **Every paid answer ends with its cost** and what is left, in dollars.


# Betas (https://docs.scannor.xyz/use-cases/beta)

**Typical cost:** $0.05 to $0.08. **Skill:** `beta`.

A beta is a new token that rides a runner's story from another angle: the runner's cat with a sword, the beta's cat in armor. A copy is the same story again.

## Ask [#ask]

- Give me a beta for $SWORDCAT.
- What is the next one after this runner?
- Ideas riding this story?
- What can I launch off this?

## What it does [#what-it-does]

1. Finds the runner and its leader: cap, holders, age, origin post.
2. Reads the origin post. Every idea must come from its picture, words or character.
3. Finds the betas already out: tokens posted next to the runner's address on X, and launches on the story's other forms. Their caps are the real evidence of how big betas get.
4. Writes 3 ideas, each with a name, ticker, angle, the fact it rests on and a picture idea, and checks each name against live tokens.

## Tools it runs [#tools-it-runs]

[`launched`](/tools/launched), [`token`](/tools/token), [`post`](/tools/post), [`attention`](/tools/attention).

## The answer [#the-answer]

The runner in one line, the betas already out with their caps, the 3 ideas with their name checks, and for your pick the name, ticker, picture idea and origin post link.


# Big names (https://docs.scannor.xyz/use-cases/big-name-touch)

**Typical cost:** $0.03 to $0.06 for a list of 10 accounts. **Skill:** `big-name-touch`.

## Ask [#ask]

- Did Elon post anything today?
- Did a big account reply to a meme?
- Any big name touches today?
- What did @handle post?

## What it does [#what-it-does]

1. Asks which accounts to watch, up to 20. scannor keeps no list: you pick, and it reuses your list for the rest of the chat.
2. Reads what they posted and replied to in the last 12 or 24 hours.
3. Finds the touches: a post or reply about a meme, a character, an animal, a picture, a phrase or a ticker. A reply is often only an emoji, so it opens the parent post, which is the story.
4. Lists the tokens on each touch, and how many launched since it.
5. Checks the leader before you act.

## Tools it runs [#tools-it-runs]

[`big_names`](/tools/big-names), [`post`](/tools/post), [`launched`](/tools/launched), [`check_token`](/tools/check-token).

## The answer [#the-answer]

One block per touch: who, what, when (UTC), its views, the tokens on it and its tags. If nothing launchable was touched, the answer says so in one line: that is a real answer.


# Check a token (https://docs.scannor.xyz/use-cases/check-token)

**Typical cost:** $0.03. **Skill:** `check-token`.

## Ask [#ask]

- Check this token. (with a contract address)
- Is $SWORDCAT bundled?
- Who holds this?
- Is this safe to buy?

## What it does [#what-it-does]

1. Reads the token's launch on chain and its market numbers, in parallel.
2. Leads with the findings worth a second look, in plain sentences.
3. Gives the numbers: the Block-0 share (wallets that bought in the launch's own block and what they still hold), what the dev bought and holds, the top 10, holders linked by a shared funder or one transaction, and new wallets.
4. Adds what scannor's graph knows: holders it has seen early in other launches, and how many of those launches ran past $1M.

## Tools it runs [#tools-it-runs]

[`check_token`](/tools/check-token) and [`token`](/tools/token).

## How to read it [#how-to-read-it]

- Assume every new token is bundled. The question is how much is still held, and by whom.
- Linked holders are one owner in practice: add their shares together.
- New wallets holding many tokens can be one person spreading supply.
- A dev who sold everything is common and says little alone. A dev holding over 5% is worth a second look.

## The answer [#the-answer]

The token in one line, the second-look findings, the numbers that matter, what the graph knows, and one line on what a buyer should know first. When one holder stands out, the answer offers to profile it.


# What is running now (https://docs.scannor.xyz/use-cases/running-now)

**Typical cost:** about $0.06 for a full scan. **Skill:** `running-now`.

## Ask [#ask]

- What is starting to run right now?
- Any narratives today?
- What should I launch now?
- What did I miss yesterday?

## What it does [#what-it-does]

1. Reads what is spreading on X in the last 6 or 24 hours, with pictures and videos when you want memes.
2. Lists the launchpad tokens with the most real buyers in the last hour, when you buy rather than launch.
3. Reads the curators' recaps of what already ran, as context for which stories are paying this week.
4. Picks up to 5 stories that can be a token (a character, an animal, a phrase, news with a name) and lists the tokens on each, on both chains.
5. Checks the leaders for bundles when you ask, or before you buy.

## Tools it runs [#tools-it-runs]

[`viral`](/tools/viral), [`trending`](/tools/trending), [`recaps`](/tools/recaps), [`launched`](/tools/launched), and [`check_token`](/tools/check-token) on request.

## The answer [#the-answer]

A table with one row a story: the post with its views, the tokens on it, the leader with its cap, holders and age, and its tags. Then the best story for you, in numbers.

| Tag | Means |
| --- | --- |
| open | No live token on it yet. |
| early | The leader is under 6 hours old and under $50,000. |
| running | The leader is up 20% or more in the last hour. |
| accumulation | Holders grew 2% or more in the last hour while the price moved less than 10%. |
| taken | The leader is over $500,000 or graduated. |
| crowded | 5 or more tokens on it in the last 24 hours. |
| fading | The leader is down 20% or more in the last hour, or its holders fell 2% or more. |
| dead | Tokens were launched on it, and none is alive. |
| fake | The biggest token's cap or market is not real. |

When a story is open, the answer ends with a name, ticker, picture idea and the post link.


# Is this story launched (https://docs.scannor.xyz/use-cases/story-launched)

**Typical cost:** $0.04 to $0.06. **Skill:** `story-launched`.

## Ask [#ask]

- Is the John Chapman story launched?
- Is there a token for this? (with a post link)
- Who leads the sword cat story?
- Is this post already a token?

## What it does [#what-it-does]

1. Reads the post when you give a link: its text, views, author, the post it replies to and what the replies say.
2. Measures how big the story is on X, and on TikTok and Instagram for a video story.
3. Lists the tokens on it on both chains, trying the story's other forms (the key noun, the ticker form) when the first finds nothing.
4. Names the leader: the highest cap that is not flagged as a fake market, with its holders, age, stage and how many tokens its dev launched.
5. Checks the leader for bundles before you buy or copy it.

## Tools it runs [#tools-it-runs]

[`post`](/tools/post), [`search_x`](/tools/search-x), [`search_video`](/tools/search-video), [`launched`](/tools/launched), [`check_token`](/tools/check-token).

## The answer [#the-answer]

Three lines: how big the story is, what is launched on it, and its tags (see [What is running now](/use-cases/running-now)). Then the leader's check in its own words. A big story with no token is the find: the answer says its views and how old its top post is.


# Token lore (https://docs.scannor.xyz/use-cases/token-lore)

**Typical cost:** about $0.06. **Skill:** `token-lore`.

## Ask [#ask]

- What is the lore of $SWORDCAT?
- Why is this token running?
- Is this token undervalued?
- Is this worth it? (with a contract address)

## What it does [#what-it-does]

1. Finds the token and opens its links and origin post, with the post it replies to and the top replies.
2. For a video meme, finds where it spread on TikTok and Instagram and whom captions credit as the original.
3. Counts the posts on X that name its contract address: authors, reach, and the share under 100 views, which are often bots.
4. Lists rival tokens on the same story: is this the leader, a copy or a beta?
5. Checks it for bundles. Bundles change the answer more than any story.

## Tools it runs [#tools-it-runs]

[`launched`](/tools/launched), [`token`](/tools/token), [`post`](/tools/post), [`search_video`](/tools/search-video), [`attention`](/tools/attention), [`check_token`](/tools/check-token).

## Is it undervalued? [#is-it-undervalued]

There is no single number. The answer reports each signal and which way it points:

- **Story reach per dollar:** the origin post's views against the market cap, compared with the rivals.
- **Real buyers:** organic buyers against all traders, and posts under 100 views against all posts.
- **Backing:** whether the person the story is about posts the token, follows it or replies to it. The strongest signal.
- **The dev:** how many tokens it launched and how many graduated.
- **The check:** the Block-0 share, linked holders and the dev's holding.

## The answer [#the-answer]

The lore in 3 lines, each with a source link. Then the signals above, and one line on what looks strong, what looks weak and what could not be verified.


# Track a wallet (https://docs.scannor.xyz/use-cases/track-wallet)

**Typical cost:** $0.01 for the profile, then $0.01 an alert. **Skill:** `track-wallet`.

## Ask [#ask]

- Who is this wallet? (with an address)
- Track this wallet.
- What did my wallets buy?
- Stop tracking it.

## What it does [#what-it-does]

1. Profiles the wallet: the launches it bought within 60 seconds of the create and how many of those ran past $1M, its funder, its mentions on X, and other wallets with the same funder.
2. Writes what the numbers say, never a label. You decide what they mean.
3. Asks before tracking, with the price: $0.01 for each buy or sell. Tracking starts only on your yes.
4. Shows the activity: recent buys and sells, and tokens two or more of your wallets bought. In Telegram each trade arrives as a message.

Profiles cover Solana and Robinhood Chain. Tracking covers Solana wallets for now. scannor never shows who else tracks a wallet, or how many do.

## Tools it runs [#tools-it-runs]

[`wallet_profile`](/tools/wallet-profile), [`track_wallet`](/tools/track-wallet), [`tracked`](/tools/tracked).

## The answer [#the-answer]

The wallet (first 4 and last 4 characters) and its numbers in 3 to 5 lines, then "Track it?". After tracking, how many wallets you track at $0.01 an alert.