ARarbital
Social Activity

GET /v2/me/feed

The viewer's relationship feed: friends (accounts that follow the viewer back) or watching (accounts the viewer follows plus the Fomo/pump.fun traders they chose to watch). Merges community posts, token comments and published trades newest first with per-item read state. Every item has a stable record_id, the actor with its identity (calld, fomo or pump), observed_at_ms (when Arbital recorded it), posted_at_ms (original time when known) and the actions the viewer may take. Blocks, moderation, deleted content and inactive accounts are applied. Cursors are opaque, exclusive and bound to the relationship. If a source fails, successful rows remain visible with unavailable_sources; its cursor does not advance. If no successful rows remain while a source is unavailable, returns 503. Explicit sort opts into the combined live pagination contract; new filters without sort are invalid. Legacy requests keep their previous response. Opt-in items retain the combined FeedItem wrapper. Checkpoints are null for anonymous reads and continuation pages; retain the accepted first-page checkpoint. Live rank changes may skip or repeat items; deduplicate record_id. Old combined snapshot cursors require a first-page refresh (410). Optional include_reactions and include_reply_preview enrich returned items without changing the default response; both options are independent.

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

Query parameters

relationship'friends' | 'watching' required
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.

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

A merged, newest-first page of the relationship feed

OR

Changes

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