Skip to main content
GET
Theses for a token, newest first, ask on a timer for a live feed

Authorizations

Authorization
string
header
required

B2B API key (fsk_live_… / fsk_test_…), issued by FomoScan. Also accepted via X-Api-Key.

Path Parameters

tokenAddress
string
required

Mint / contract address. Case-sensitive for Solana base58; EVM 0x… is lower-cased for you.

Query Parameters

before
string

The id of the last thesis you saw — the previous page’s nextBefore. Returns theses older than it. Omit for the newest 20.

limit
integer
default:20

Rows per page, 1..100. Priced per started block of 20 rows on the REQUESTED limit.

Required range: 1 <= x <= 100

Response

200 - application/json

Default Response

tokenAddress
string
required

Normalised (EVM lower-cased).

tokenNetwork
null | string
required

Chain name (sol, eth, base, …). Null when the page is empty.

symbol
null | string
required

Ticker. Null when the page is empty.

updatedAt
null | integer
required

Post time of the NEWEST thesis in this page, epoch millis.

count
integer
required

Items in this page (0..20).

hasMore
boolean
required

Whether older theses exist behind this page.

nextBefore
null | string
required

The OLDEST item’s id. Send back as ?before= for the next page while hasMore is true. Null on the last page.

items
object[]
required