Read the post feed
curl --request GET \
--url https://api.fomoscan.sh/v3/posts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v3/posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v3/posts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"kind": "post",
"id": "pst_01jbsta8h2ecsr8h2nank6cxvq",
"canonical": {
"platform": "fomo",
"author": {
"trader": "tdr_01jbst8pvcfp79y0938nkrkayd",
"handle": "nightowl"
},
"token": {
"id": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"symbol": "BONK"
},
"body": "Adding here. Chart at https://example.com/c/bonk",
"segments": [
{
"text": "Adding here. Chart at ",
"url": null
},
{
"text": "example.com/c/bonk",
"url": "https://example.com/c/bonk"
}
],
"likeCount": 41,
"postedAt": "2026-11-01T08:58:31.000Z",
"firstSeenAt": "2026-11-01T08:58:33.184Z",
"revision": 0
},
"sources": {
"fomo": {
"position": {
"quantity": {
"value": "412500000000",
"decimals": 5,
"currency": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
},
"value": {
"value": "77276000",
"decimals": 6,
"currency": "USD"
},
"invested": {
"value": "60000000",
"decimals": 6,
"currency": "USD"
},
"realizedPnl": {
"value": "0",
"decimals": 6,
"currency": "USD"
},
"unrealizedPnl": {
"value": "17276000",
"decimals": 6,
"currency": "USD"
},
"totalPnl": {
"value": "17276000",
"decimals": 6,
"currency": "USD"
},
"closed": false,
"closedAt": null,
"observedAt": "2026-11-01T08:58:33.184Z"
},
"callPerformance": {
"marketCapAtCall": {
"value": "1290000000000000",
"decimals": 6,
"currency": "USD"
},
"priceAtCall": {
"value": "15650000000000",
"decimals": 18,
"currency": "USD"
},
"multiple": null,
"maxMultiple": null,
"maxMultipleAt": null,
"mediaUrl": null,
"quotedPost": null,
"observedAt": "2026-11-01T08:58:33.184Z"
}
}
}
},
{
"kind": "post",
"id": "pst_01jbstacskeh28anb6csvqf248",
"canonical": {
"platform": "pump",
"author": {
"trader": "tdr_01jbst8pvcfp79y0938nkrkayd",
"handle": "nightowl"
},
"token": {
"id": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"symbol": "BONK"
},
"body": "Adding here. Chart at https://example.com/c/bonk",
"segments": [
{
"text": "Adding here. Chart at ",
"url": null
},
{
"text": "example.com/c/bonk",
"url": "https://example.com/c/bonk"
}
],
"likeCount": 41,
"postedAt": "2026-11-01T08:51:12.000Z",
"firstSeenAt": "2026-11-01T08:58:33.184Z",
"revision": 0
},
"sources": {
"pump": {
"position": {
"quantity": {
"value": "412500000000",
"decimals": 5,
"currency": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
},
"value": {
"value": "77276000",
"decimals": 6,
"currency": "USD"
},
"invested": {
"value": "60000000",
"decimals": 6,
"currency": "USD"
},
"realizedPnl": {
"value": "0",
"decimals": 6,
"currency": "USD"
},
"unrealizedPnl": null,
"totalPnl": {
"value": "17276000",
"decimals": 6,
"currency": "USD"
},
"closed": false,
"closedAt": null,
"observedAt": "2026-11-01T08:58:33.184Z"
},
"engagement": {
"commentCount": 14,
"replyCount": 6,
"repostCount": 3,
"quoteCount": 1,
"viewCount": 2290,
"observedAt": "2026-11-01T08:58:33.184Z"
},
"callPerformance": {
"marketCapAtCall": {
"value": "1290000000000000",
"decimals": 6,
"currency": "USD"
},
"priceAtCall": {
"value": "15650000000000",
"decimals": 18,
"currency": "USD"
},
"multiple": 1.1971,
"maxMultiple": 1.42,
"maxMultipleAt": "2026-11-01T08:59:50.000Z",
"mediaUrl": "https://img.example.com/a/7d3b9f2a6c1e8d4b0a5f3c7e2b9d6a1f.webp",
"quotedPost": null,
"observedAt": "2026-11-01T08:58:33.184Z"
}
}
}
}
],
"hasMore": true,
"nextCursor": "c_eyJxIjoiazNKOXhRMm1aN2FCIiwidiI6eyJzIjoiMjAyNi0xMS0wMVQwODo0MTowMi45MTdaIiwiaSI6IjAxOTJmM2E1LTIyMjItNzMzMy04NDQ0LTU1NTU2NjY2Nzc3NyJ9fQ"
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}Posts
Read the post feed
The newest posts of every platform, newest first: the REST side of the stream, with the same post envelopes, for backfill and for gaps.
- Order: post time newest first, then post id. A page boundary inside a tie neither drops nor repeats a post.
- Each post carries its blocks under its own platform’s key in
sources. - Paged with
cursorandlimit(default 20, maximum 100). FollownextCursorto read older rows.
Price
200 credits per started 20 rows of limit, on every call. A short or empty page costs the same as a full one.
| Answer | Credits | Reveals |
|---|---|---|
limit 1. | 200 | 0 |
limit 20 (the default). | 200 | 0 |
limit 50. | 600 | 0 |
limit 100 (the maximum). | 1,000 | 0 |
platform=pump, any limit. | 10 | 0 |
Limits
- 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.
- A key with less than 10 credits left gets 402
QUOTA_EXCEEDEDbefore any work.
GET
/
v3
/
posts
Read the post feed
curl --request GET \
--url https://api.fomoscan.sh/v3/posts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v3/posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v3/posts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"kind": "post",
"id": "pst_01jbsta8h2ecsr8h2nank6cxvq",
"canonical": {
"platform": "fomo",
"author": {
"trader": "tdr_01jbst8pvcfp79y0938nkrkayd",
"handle": "nightowl"
},
"token": {
"id": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"symbol": "BONK"
},
"body": "Adding here. Chart at https://example.com/c/bonk",
"segments": [
{
"text": "Adding here. Chart at ",
"url": null
},
{
"text": "example.com/c/bonk",
"url": "https://example.com/c/bonk"
}
],
"likeCount": 41,
"postedAt": "2026-11-01T08:58:31.000Z",
"firstSeenAt": "2026-11-01T08:58:33.184Z",
"revision": 0
},
"sources": {
"fomo": {
"position": {
"quantity": {
"value": "412500000000",
"decimals": 5,
"currency": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
},
"value": {
"value": "77276000",
"decimals": 6,
"currency": "USD"
},
"invested": {
"value": "60000000",
"decimals": 6,
"currency": "USD"
},
"realizedPnl": {
"value": "0",
"decimals": 6,
"currency": "USD"
},
"unrealizedPnl": {
"value": "17276000",
"decimals": 6,
"currency": "USD"
},
"totalPnl": {
"value": "17276000",
"decimals": 6,
"currency": "USD"
},
"closed": false,
"closedAt": null,
"observedAt": "2026-11-01T08:58:33.184Z"
},
"callPerformance": {
"marketCapAtCall": {
"value": "1290000000000000",
"decimals": 6,
"currency": "USD"
},
"priceAtCall": {
"value": "15650000000000",
"decimals": 18,
"currency": "USD"
},
"multiple": null,
"maxMultiple": null,
"maxMultipleAt": null,
"mediaUrl": null,
"quotedPost": null,
"observedAt": "2026-11-01T08:58:33.184Z"
}
}
}
},
{
"kind": "post",
"id": "pst_01jbstacskeh28anb6csvqf248",
"canonical": {
"platform": "pump",
"author": {
"trader": "tdr_01jbst8pvcfp79y0938nkrkayd",
"handle": "nightowl"
},
"token": {
"id": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"symbol": "BONK"
},
"body": "Adding here. Chart at https://example.com/c/bonk",
"segments": [
{
"text": "Adding here. Chart at ",
"url": null
},
{
"text": "example.com/c/bonk",
"url": "https://example.com/c/bonk"
}
],
"likeCount": 41,
"postedAt": "2026-11-01T08:51:12.000Z",
"firstSeenAt": "2026-11-01T08:58:33.184Z",
"revision": 0
},
"sources": {
"pump": {
"position": {
"quantity": {
"value": "412500000000",
"decimals": 5,
"currency": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
},
"value": {
"value": "77276000",
"decimals": 6,
"currency": "USD"
},
"invested": {
"value": "60000000",
"decimals": 6,
"currency": "USD"
},
"realizedPnl": {
"value": "0",
"decimals": 6,
"currency": "USD"
},
"unrealizedPnl": null,
"totalPnl": {
"value": "17276000",
"decimals": 6,
"currency": "USD"
},
"closed": false,
"closedAt": null,
"observedAt": "2026-11-01T08:58:33.184Z"
},
"engagement": {
"commentCount": 14,
"replyCount": 6,
"repostCount": 3,
"quoteCount": 1,
"viewCount": 2290,
"observedAt": "2026-11-01T08:58:33.184Z"
},
"callPerformance": {
"marketCapAtCall": {
"value": "1290000000000000",
"decimals": 6,
"currency": "USD"
},
"priceAtCall": {
"value": "15650000000000",
"decimals": 18,
"currency": "USD"
},
"multiple": 1.1971,
"maxMultiple": 1.42,
"maxMultipleAt": "2026-11-01T08:59:50.000Z",
"mediaUrl": "https://img.example.com/a/7d3b9f2a6c1e8d4b0a5f3c7e2b9d6a1f.webp",
"quotedPost": null,
"observedAt": "2026-11-01T08:58:33.184Z"
}
}
}
}
],
"hasMore": true,
"nextCursor": "c_eyJxIjoiazNKOXhRMm1aN2FCIiwidiI6eyJzIjoiMjAyNi0xMS0wMVQwODo0MTowMi45MTdaIiwiaSI6IjAxOTJmM2E1LTIyMjItNzMzMy04NDQ0LTU1NTU2NjY2Nzc3NyJ9fQ"
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}Authorizations
bearerAuthapiKeyHeader
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Only posts from this platform. Leave it out for every platform.
Available options:
fomo, pump, hyperliquid, markets, polymarket, legend, risex The nextCursor of the previous page, sent back as it came. Leave it out for the first page. A cursor belongs to the query that produced it: sent with other parameters it answers 400 INVALID_ARGUMENT.
Required string length:
3 - 1024Rows per page, 1 to 100. 20 when left out.
Required range:
1 <= x <= 100Response
OK
One page of a list. Pass nextCursor back as cursor for the next page.
The rows of this page, in the order the operation states.
Show child attributes
Show child attributes
true when another page follows this one.
The cursor of the next page (c_…), or null on the last page. Treat it as opaque: send it back as cursor, never parse or build it.