# Theses

## Recent theses across all coins (1,250 credits)

`stalkchain_fomo_theses_recent` · **1,250 credits**

> Ask: *"What are traders writing about on Robinhood Chain right now?"*

The newest written calls and trade reasoning across every coin. Use when no specific coin or trader is named — for one coin use stalkchain_fomo_theses_for_token, for one person use stalkchain_fomo_theses_by_trader. The global feed of written reasoning: text, handle, userId, token {symbol,address}, chain, equity (position size), tradeUsd, isDev, ts, realized/unrealized PnL. This feed carries equity/PnL but NOT likes. sort=recent\|equity\|pnl; minEquity filters to theses backed by big positions (e.g. 100000). chain=robinhood is the largest share. Every thesis call costs 1,250 credits per page (5x a normal call). Results cache 10 min. Great for narrative detection: many theses converging on one coin.

| Input | Type | Required | Description |
|---|---|---|---|
| `chain` | string | no | robinhood\|solana\|base\|bsc\|eth or raw chainId |
| `sort` | `recent` \| `equity` \| `pnl` | no |  |
| `minEquity` | number | no | Only theses whose author holds at least this much USD in the coin |
| `limit` | integer | no |  |

REST: `POST /api/v1/tools/stalkchain_fomo_theses_recent` with the inputs as a JSON body, or `GET /api/v1/tools/stalkchain_fomo_theses_recent?…`.

## Theses written about one token (1,250 credits/page)

`stalkchain_fomo_theses_for_token` · **1,250 credits** · Per page.

> Ask: *"Why are people buying CATE? Most-liked theses."*

What have people written and said about THIS coin — the calls, takes and reasoning posted on one token. The whole thesis history on a coin: text, handle, userId, likes, replies, isDev, ts. Carries likes but NOT equity. sort=likes = what the crowd agreed with; sort=recent = newest; minLikes filters. pages=2..10 walks further back (~95 theses/page, 1,250 credits PER PAGE, always re-pulled live). Every thesis call costs 1,250 credits per page (5x a normal call). Results cache 10 min. available:false until the coin has data.

| Input | Type | Required | Description |
|---|---|---|---|
| `address` | string | yes | Token contract address / mint |
| `sort` | `likes` \| `recent` \| `pnl` | no |  |
| `network` | `sol` \| `bnb` \| `base` \| `eth` | no |  |
| `minLikes` | integer | no |  |
| `pages` | integer | no | Default 1. Each extra page = +1,250 credits. |
| `limit` | integer | no |  |

REST: `POST /api/v1/tools/stalkchain_fomo_theses_for_token` with the inputs as a JSON body, or `GET /api/v1/tools/stalkchain_fomo_theses_for_token?…`.

## Theses written by one trader (1,250 credits)

`stalkchain_fomo_theses_by_trader` · **1,250 credits**

> Ask: *"What has frankdegods written about PONS?"*

What has this trader been writing, posting, saying or calling lately — their written posts and calls, not their trades (for trades use stalkchain_fomo_trader_swaps) — their written calls, takes and reasoning, newest first. Use to read why they entered before copying them. Every thesis by one trader, newest first, each with likes, replies, equity and realized/unrealized PnL on that coin. sort=likes\|recent\|equity\|pnl. Every thesis call costs 1,250 credits per page (5x a normal call). Results cache 10 min. Use to read WHY a trader entered a position before copying them.

| Input | Type | Required | Description |
|---|---|---|---|
| `trader` | string | yes | Handle or userId |
| `tokenAddress` | string | no | Only this trader's theses about one token |
| `chain` | string | no |  |
| `sort` | `likes` \| `recent` \| `equity` \| `pnl` | no |  |
| `minEquity` | number | no |  |
| `minLikes` | integer | no |  |
| `limit` | integer | no |  |

REST: `POST /api/v1/tools/stalkchain_fomo_theses_by_trader` with the inputs as a JSON body, or `GET /api/v1/tools/stalkchain_fomo_theses_by_trader?…`.