Read the posts about a token

curl --request GET \
  --url https://api.fomoscan.sh/v3/tokens/{network}/{address}/posts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fomoscan.sh/v3/tokens/{network}/{address}/posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fomoscan.sh/v3/tokens/{network}/{address}/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 posts about a token

The posts about one token, newest first.

GET /v3/tokens/{network}/{address} reads the token itself.
A token we never saw answers 200 with an empty page, never 404.
Order as in GET /v3/posts. Paged with cursor and limit (default 20, maximum 100). Follow nextCursor to 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_EXCEEDED before any work.

GET

tokens

{network}

{address}

posts

Read the posts about a token

curl --request GET \
  --url https://api.fomoscan.sh/v3/tokens/{network}/{address}/posts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fomoscan.sh/v3/tokens/{network}/{address}/posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fomoscan.sh/v3/tokens/{network}/{address}/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

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

network

enum<string>

required

The network the token lives on.

Available options:

solana,

ethereum,

base,

bsc,

arbitrum,

optimism,

polygon,

robinhood,

hyperevm,

monad,

arc,

xlayer,

ink,

hyperliquid

address

string

required

The token address on that network: the mint on Solana.

Required string length: 1 - 128

Query Parameters

platform

enum<string>

Only posts from this platform. Leave it out for every platform.

Available options:

fomo,

pump,

hyperliquid,

markets,

polymarket,

legend,

risex

cursor

string

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 - 1024

limit

integer

default:20

Rows per page, 1 to 100. 20 when left out.

Required range: 1 <= x <= 100

Response

One page of a list. Pass nextCursor back as cursor for the next page.

items

object[]

required

The rows of this page, in the order the operation states.

Show child attributes

hasMore

boolean

required

true when another page follows this one.

nextCursor

string | null

required

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.

Overview

Endpoints

Read the posts about a token

Price

Limits

Authorizations

Path Parameters

Query Parameters

Response