Social Community

GET /v2/social/posts

Lists the community post feed. A valid bearer token adds viewer-specific like and block filtering; anonymous reads are allowed. Pinned posts sort first, then creation time and ID. Pass next_cursor unchanged: it captures the complete ordering position. Legacy cursors remain accepted. Pin changes are live rather than a snapshot; refresh to restart the current ordering. Explicit sort opts into the combined live pagination contract; new filters without sort are invalid. Legacy requests keep their previous response. Opt-in native post items remain raw SocialRankedPost objects. Checkpoints are null for anonymous reads and continuation pages; retain the accepted first-page checkpoint. Live rank changes may skip or repeat items; deduplicate by post id. Old combined snapshot cursors require a first-page refresh (410).

Request

  • Base URL
    https://api.arbital.xyz (the document declares no server; this is the origin it was published from)
  • URL
    https://api.arbital.xyz/v2/social/posts
  • Auth
    • HTTP bearer
    • or none

Query parameters

sort'latest' | 'top' | 'most_discussed'

latest: original publication time; top: versioned fixed-point score with stable diversity rounds; most_discussed: known discussion counts, participants, publication time and stable identity. Unknown discussion counts sort after known counts without removing the content.

category'all' | 'memes' | 'equities'

Applied to current canonical subject evidence before each owner limit. Unknown classifications are eligible only for all.

period'24h' | '7d' | '30d'
sourcesstring
assetstring
companystring

Canonical company ID (company:aapl), explicit ticker (AAPL), or an unambiguous alias in the complete canonical registry. Unknown canonical IDs return an empty result. Does not infer a company from a token ticker.

limitinteger
cursorstring

Pass the opaque next_cursor unchanged. Combined live cursors require the same filters, page size and viewer; legacy combined snapshot cursors return 410.

Response

Community posts

OR

Changes

No recorded changes to this operation across all 1 revision of this API.