ARarbital
Social Community

Read the combined stable feed in Top order

Latest reads current eligible native/Fomo/Pump/X records by original publication time. Top and Most discussed use current committed rankings with current filters and visibility. Filters precede each owner limit. Pagination is live: ranks, membership and relationship scope can change between pages, so clients should deduplicate record_id and refresh for the current head. Opaque cursors bind filters, page size and viewer; they retain seek positions only. Latest does not depend on rank publication. Missing or stale required rankings and source failures return 503; old frozen cursors return 410 and require first-page refresh. Pages and activity probes do not mark items read. The rollout flag is disabled by default. Private, no-store; Vary: Authorization. Omit sort or use sort=top; other sorts fail. Optional include_reactions and include_reply_preview enrich returned items without changing the default response; both options are independent.

get/v2/social/feed/top

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/feed/top
  • Auth
    HTTP bearer

Query parameters

sort'top'

top only: this route is the Top feed alias of /v2/social/feed. Other sorts answer 400 invalid_feed_query; use /v2/social/feed for latest or most_discussed.

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.

include_reactionsboolean

Include current viewer-specific reaction_summary on each item to avoid initial per-card reaction reads. Native posts/comments use contract 2; imported trades, theses and X posts use contract 1. Native CALLD trades return null. Omitted or false preserves the existing response. Supported on /v2/me/feed both without sort (legacy) and with sort (combined); not supported on /v2/social/posts. Enrichment failure returns 503.

include_reply_previewboolean

Include reply_preview on each item with up to two discussion rows, a nondeleted direct reply count and continuation cursor. Independent of include_reactions. Native CALLD trades, X posts and theses without an asset return null. Omitted or false preserves the existing response. Supported on both legacy and combined /v2/me/feed; not supported on /v2/social/posts. Preview failure returns 503, never a fabricated empty preview. Does not evaluate token-holder eligibility.

include_position_entryboolean

Include position_entry on each thesis item: the indexer's prepared position for a Solana thesis (entry timestamp of the cycle that includes the thesis, lifecycle state, observation time and freshness) plus its request_status, so the card paints without a second request. Theses without a Solana asset and every non-thesis item carry null or no field. Omitted or false preserves the existing response. Combined feed only: on /v2/me/feed it needs sort like every combined parameter. Entry failure returns 503, never a fabricated entry; a thesis with no prepared position returns request_status.state unavailable with reason not_found.

min_trade_usdinteger

Select only trade items whose USD size is at least this many whole dollars; trades with no known USD size are excluded. Posts, comments, theses and X posts are unaffected. 0 or omitted applies no size filter. The cursor binds the value like every other filter; a continuation with a different value is rejected.

Response

Frozen feed evidence with current authorized content

next_cursorstring nullable required

Opaque live seek cursor. Pass unchanged with the same filters and viewer. Rank changes can cause skipped or repeated items; refresh starts at the current head. Old cf1_ snapshot cursors return 410.

completeness'complete' | 'partial' required

Whether this page used every required source head. Does not promise a complete immutable collection across multiple requests.

activity_checkpointstring nullable required

First-page refresh baseline for an authenticated viewer; null on continuation pages or anonymous reads. Retain the last accepted first-page checkpoint until refresh.

Changes

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