Skip to main content
GET
Want to backtest a strategy? Need to find every whale buy on Crypto markets from last week? This is your endpoint. You can filter the entire Polychads database using the parameters below.
integer
default:"1"
The page number to fetch.
integer
default:"20"
How many results to pack into one page. Limits: Free: 20, Pro: 50, Enterprise: 100.
string
Isolate a specific market sector: crypto, politics, world, tech, finance, pop_culture, other.
string
Filter by action: BUY or SELL.
float
Only show trades larger than this USDC amount. Great for filtering out noise.
integer
Only show alerts with a Signal Score equal to or higher than this (0-100).
string
Power search. Matches against the market question, market slug, or exact wallet address.

Try it out

Authorizations

Authorization
string
header
required

Your API key — get one from @chadsapibot on Telegram

Query Parameters

page
integer
default:1

Page number

page_size
integer
default:20

Results per page

category
enum<string>

Filter by category

Available options:
crypto,
politics,
world,
tech,
finance,
pop_culture,
other
side
enum<string>

Filter by trade direction

Available options:
BUY,
SELL
min_usdc
number

Minimum trade size in USDC

min_signal
integer

Minimum signal score

Required range: 0 <= x <= 100
q
string

Text search — matches market title, slug, or wallet address

Response

200 - application/json

Paginated alerts

alerts
object[]
total
integer
page
integer
page_size
integer
has_more
boolean