--- title: "Read the combined stable feed in Top order" method: GET path: "/v2/social/feed/top" tags: ["Social Community"] --- # Read the combined stable feed in Top order `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 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. ## Query parameters - `sort` 'top' - `category` 'all' | 'memes' | 'equities' - `period` '24h' | '7d' | '30d' - `sources` string - `asset` string - `company` string - `limit` integer - `cursor` string - `include_reactions` boolean - `include_reply_preview` boolean - `include_position_entry` boolean - `min_trade_usd` integer ## Response `200` Frozen feed evidence with current authorized content - SocialCombinedFeedPage - `items` SocialCombinedFeedItem[], required - union - SocialCombinedPostItem - `record_id` string, required - `source` 'native' | 'fomo' | 'pump' | 'x', required - `posted_at_ms` string, required - `observed_at_ms` string, required - `content_revision` string, required - `read` boolean, nullable, required - `permissions` SocialFeedPermissions, required: Item-aware actions for the current viewer. Unrestricted Fomo/Pump imported trades allow community replies and CALLD reactions; CALLD trades remain unsupported. Token comment holder rules are unchanged. Mutation-time authorization is still required. - `react` boolean, required - `reply` 'allowed' | 'token_holders' | 'unavailable', required - `ranking_context` SocialRankingContext, required: Immutable ranking evidence for the captured period. Top policy combined-top-v1 uses 20% standing, 10% volume, 5% market cap, 20% discussion, 10% reactions, 15% freshness, 10% relevance and 10% substance. Unavailable inputs contribute zero without redistributing weight and remain explicitly null in the response. Signal scope distinguishes native replies, collected other-author asset theses and provider post reply counts. These are social display facts, never financial authority. - `policy_version` string, required - `score_micros` integer, nullable, required - `diversity_round` integer, required - `inputs` object, required - `trader_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_distinct_participants` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `freshness` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `relevance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `substance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `contexts` object[], required - `identity` union, required - … - `holder_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `volume_24h_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `market_cap_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `context_total` integer, required - `contexts_truncated` boolean, required - `used` object, required - `standing` 'trader' | 'holder' | 'null', nullable, required - `asset_context_index` integer, nullable, required - `discussion` 'native' | 'external' | 'null', nullable, required - `reactions` 'native' | 'external' | 'null', nullable, required - `kind` 'post', required - `actor` union, required: Who produced the item. identity distinguishes CALLD members from external Fomo/pump.fun traders. - SocialFeedCalldActor - `display_name` string, nullable, required - `identity` 'calld', required - `profile_image_url` string, nullable, required - `user_id` string, uuid, required - `username` string, required - SocialFeedTraderActor - `avatar_url` string, nullable, required - `display_name` string, nullable, required - `handle` string, nullable, required - `identity` 'fomo' | 'pump', required - `platform_subject_id` string, required - `trader_profile_id` string, uuid, required: Resolvable through /v2/social/traders/{trader_profile_id} for followed traders. - `content` SocialPost, required - `author` SocialPostAuthor, required - `display_name` string, nullable, required - `profile_image_url` string, nullable, required: Approved profile image or stable CALLD default avatar URL. - `user_id` string, uuid, required - `username` string, required - `x_avatar_url` string, nullable, required - `body` string, required - `created_at_ms` string, required - `id` string, uuid, required - `like_count` integer, required - `media` union, required: Ordered immutable slots, with unique IDs and zero-based ordinals matching array positions. Up to four still images, or exactly one GIF. Deletion preserves the slot and original ID. Replies, messages and recap comments omit this field when there are no slots; posts return an empty array. - union[] - … - SocialMediaGif[] - … - `pinned` boolean, required - `viewer_liked` boolean, required - `x_post_url` string, nullable, required - `x_publish_state` string, required - `attachments` SocialPostAttachment[], required: Immutable ordered references and snapshots with viewer-scoped source availability. Historical values are distinct from live portfolio values. - union - … - `mentions` NativeReadMention[], required: Ordered historical entities with current viewer-scoped identity. Empty for legacy, imported or tombstoned content. A read failure is explicit, never a fabricated empty array. - `kind` 'early_user', required - `user_id` string, uuid, required - `offset` integer, required: Zero-based Unicode code-point offset, not UTF-16 units or graphemes. - `length` integer, required - `text` string, required: Immutable exact authored span, including @. - `availability` 'available' | 'unavailable', required - `current_profile` NativeMentionProfile, required - … - `profile_target` NativeMentionTarget, required - … - `notification_supported` true, required - `reaction_summary` SocialReactionSummaryV2: CALLD reactions on one target, most used first. External-platform likes or counts are never merged in; source says so explicitly. - `reactions` SocialReactionCount[], required - `count` integer, required: Reactions with this emoji by active CALLD accounts. - `emoji` string, required - `viewer_reacted` boolean, required: Whether the signed-in viewer has this reaction; always false for anonymous readers. - `source` 'calld', required - `target` object, required - `id` string, uuid, required - `kind` 'post' | 'asset_comment' | 'thesis' | 'trade' | 'x_post', required - `contract` 2, required - `aggregate_revision` string, required - `edge_versions` object[], required - `emoji` string, required - `revision` string, required - `present` boolean, required - `transition_id` string, uuid, nullable - `reply_preview` SocialPostReplyPreview: Partial first discussion page for a feed card, not a full discussion response. Uses the existing reply ordering and visibility rules, including deleted tombstones with null bodies. Preserves supported media, GIF and mention fields. Does not evaluate token-holder eligibility; use feed permissions for the write policy and the discussion endpoint for current eligibility. - `replies` SocialPostReply[], required - `author` SocialPostAuthor, required - … - `body` string, nullable, required: Null after parent deletion; empty for a media-only or external-GIF-only reply. Removing the last image preserves the empty body and deleted media slot. - `created_at_ms` string, required - `deleted` boolean, required - `id` string, uuid, required - `parent_reply_id` string, uuid, nullable, required: Exact direct parent reply on the same post; null for a direct reply to the post. - `post_id` string, uuid, required - `reply_count` integer, required: Nondeleted visible direct replies, excluding deeper descendants. - `viewer_can_delete` boolean, required: Whether the viewer owns this undeleted reply and may delete it. - `media` union: Ordered immutable slots, with unique IDs and zero-based ordinals matching array positions. Up to four still images, or exactly one GIF. Deletion preserves the slot and original ID. Replies, messages and recap comments omit this field when there are no slots; posts return an empty array. - … - `gif` SocialExternalGifReference: A selected public KLIPY GIF reference, not an approved social-media upload. The backend validates syntax and stores only these identifiers; it does not call KLIPY or approve, cache or store its bytes. Resolve from the end-user client, verify both returned id and slug, apply receiver-side content restrictions and display provider attribution. Missing, filtered or mismatched items are unavailable. Never send an Arbital bearer token to the provider. - … - `mentions` NativeReadMention[], required: Ordered historical entities with current viewer-scoped identity. Empty for legacy, imported or tombstoned content. A read failure is explicit, never a fabricated empty array. - … - `reply_count` integer, required: Total visible nondeleted direct replies in this scope, independent of preview length. Tombstones may appear in replies but are excluded from this count. - `next_cursor` string, nullable, required: Opaque post_replies cursor for older replies in the same post and parent scope. Continue with this cursor on the corresponding existing replies endpoint; a different page limit is allowed. - SocialCombinedCommentItem - `record_id` string, required - `source` 'native' | 'fomo' | 'pump' | 'x', required - `posted_at_ms` string, required - `observed_at_ms` string, required - `content_revision` string, required - `read` boolean, nullable, required - `permissions` SocialFeedPermissions, required: Item-aware actions for the current viewer. Unrestricted Fomo/Pump imported trades allow community replies and CALLD reactions; CALLD trades remain unsupported. Token comment holder rules are unchanged. Mutation-time authorization is still required. - `react` boolean, required - `reply` 'allowed' | 'token_holders' | 'unavailable', required - `ranking_context` SocialRankingContext, required: Immutable ranking evidence for the captured period. Top policy combined-top-v1 uses 20% standing, 10% volume, 5% market cap, 20% discussion, 10% reactions, 15% freshness, 10% relevance and 10% substance. Unavailable inputs contribute zero without redistributing weight and remain explicitly null in the response. Signal scope distinguishes native replies, collected other-author asset theses and provider post reply counts. These are social display facts, never financial authority. - `policy_version` string, required - `score_micros` integer, nullable, required - `diversity_round` integer, required - `inputs` object, required - `trader_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_distinct_participants` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `freshness` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `relevance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `substance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `contexts` object[], required - `identity` union, required - … - `holder_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `volume_24h_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `market_cap_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `context_total` integer, required - `contexts_truncated` boolean, required - `used` object, required - `standing` 'trader' | 'holder' | 'null', nullable, required - `asset_context_index` integer, nullable, required - `discussion` 'native' | 'external' | 'null', nullable, required - `reactions` 'native' | 'external' | 'null', nullable, required - `kind` 'comment', required - `actor` union, required: Who produced the item. identity distinguishes CALLD members from external Fomo/pump.fun traders. - SocialFeedCalldActor - `display_name` string, nullable, required - `identity` 'calld', required - `profile_image_url` string, nullable, required - `user_id` string, uuid, required - `username` string, required - SocialFeedTraderActor - `avatar_url` string, nullable, required - `display_name` string, nullable, required - `handle` string, nullable, required - `identity` 'fomo' | 'pump', required - `platform_subject_id` string, required - `trader_profile_id` string, uuid, required: Resolvable through /v2/social/traders/{trader_profile_id} for followed traders. - `content` object, required - `asset` object, required - `chain_id` string, required - `address` string, required - `comment` SocialAssetComment, required: Optional gif contains the saved external reference only for a visible, nondeleted native reply. It remains readable when GIF-reference writes are disabled and is omitted for deleted placeholders. It is distinct from approved uploaded media and is never returned with nonempty media. - `body` string, nullable, required: Null after parent deletion; empty for a media-only or external-GIF-only ordinary reply. Removing the last image preserves the empty body and deleted media slot. - `comment_id` string, uuid, required - `created_at` string, date-time, required - `deleted` boolean, required - `holding_display` string, nullable, required - `is_holder` true, required - `parent_comment_id` string, uuid, nullable, required: Exact direct parent comment in this token thread; null for a root comment. - `reply_count` integer, required: Nondeleted visible direct replies, excluding deeper descendants. - `thesis_event_id` string, uuid, nullable, required: Feed eventId of the imported thesis this comment directly replies to; null for ordinary comments and replies. - `user` SocialAssetCommentAuthor, required - … - `viewer_can_delete` boolean, required: Whether the viewer owns this undeleted comment and may delete it. - `media` union: Ordered immutable slots, with unique IDs and zero-based ordinals matching array positions. Up to four still images, or exactly one GIF. Deletion preserves the slot and original ID. Replies, messages and recap comments omit this field when there are no slots; posts return an empty array. - … - `gif` SocialExternalGifReference: A selected public KLIPY GIF reference, not an approved social-media upload. The backend validates syntax and stores only these identifiers; it does not call KLIPY or approve, cache or store its bytes. Resolve from the end-user client, verify both returned id and slug, apply receiver-side content restrictions and display provider attribution. Missing, filtered or mismatched items are unavailable. Never send an Arbital bearer token to the provider. - … - `mentions` NativeReadMention[], required: Ordered historical entities with current viewer-scoped identity. Empty for legacy, imported or tombstoned content. A read failure is explicit, never a fabricated empty array. - … - `reaction_summary` SocialReactionSummaryV2: CALLD reactions on one target, most used first. External-platform likes or counts are never merged in; source says so explicitly. - `reactions` SocialReactionCount[], required - `count` integer, required: Reactions with this emoji by active CALLD accounts. - `emoji` string, required - `viewer_reacted` boolean, required: Whether the signed-in viewer has this reaction; always false for anonymous readers. - `source` 'calld', required - `target` object, required - `id` string, uuid, required - `kind` 'post' | 'asset_comment' | 'thesis' | 'trade' | 'x_post', required - `contract` 2, required - `aggregate_revision` string, required - `edge_versions` object[], required - `emoji` string, required - `revision` string, required - `present` boolean, required - `transition_id` string, uuid, nullable - `reply_preview` SocialAssetCommentReplyPreview: Partial first discussion page for a feed card, not a full discussion response. Uses the existing reply ordering and visibility rules, including deleted tombstones with null bodies. Preserves supported media, GIF and mention fields. Does not evaluate token-holder eligibility; use feed permissions for the write policy and the discussion endpoint for current eligibility. - `replies` SocialAssetComment[], required - `body` string, nullable, required: Null after parent deletion; empty for a media-only or external-GIF-only ordinary reply. Removing the last image preserves the empty body and deleted media slot. - `comment_id` string, uuid, required - `created_at` string, date-time, required - `deleted` boolean, required - `holding_display` string, nullable, required - `is_holder` true, required - `parent_comment_id` string, uuid, nullable, required: Exact direct parent comment in this token thread; null for a root comment. - `reply_count` integer, required: Nondeleted visible direct replies, excluding deeper descendants. - `thesis_event_id` string, uuid, nullable, required: Feed eventId of the imported thesis this comment directly replies to; null for ordinary comments and replies. - `user` SocialAssetCommentAuthor, required - … - `viewer_can_delete` boolean, required: Whether the viewer owns this undeleted comment and may delete it. - `media` union: Ordered immutable slots, with unique IDs and zero-based ordinals matching array positions. Up to four still images, or exactly one GIF. Deletion preserves the slot and original ID. Replies, messages and recap comments omit this field when there are no slots; posts return an empty array. - … - `gif` SocialExternalGifReference: A selected public KLIPY GIF reference, not an approved social-media upload. The backend validates syntax and stores only these identifiers; it does not call KLIPY or approve, cache or store its bytes. Resolve from the end-user client, verify both returned id and slug, apply receiver-side content restrictions and display provider attribution. Missing, filtered or mismatched items are unavailable. Never send an Arbital bearer token to the provider. - … - `mentions` NativeReadMention[], required: Ordered historical entities with current viewer-scoped identity. Empty for legacy, imported or tombstoned content. A read failure is explicit, never a fabricated empty array. - … - `reply_count` integer, required: Total visible nondeleted direct replies in this scope, independent of preview length. Tombstones may appear in replies but are excluded from this count. - `next_cursor` string, uuid, nullable, required: Last returned reply UUID when older replies remain; scoped to the exact token and parent. Continue with this cursor on the corresponding existing replies endpoint; a different page limit is allowed. - SocialCombinedTradeItem - `record_id` string, required - `source` 'native' | 'fomo' | 'pump' | 'x', required - `posted_at_ms` string, required - `observed_at_ms` string, required - `content_revision` string, required - `read` boolean, nullable, required - `permissions` SocialFeedPermissions, required: Item-aware actions for the current viewer. Unrestricted Fomo/Pump imported trades allow community replies and CALLD reactions; CALLD trades remain unsupported. Token comment holder rules are unchanged. Mutation-time authorization is still required. - `react` boolean, required - `reply` 'allowed' | 'token_holders' | 'unavailable', required - `ranking_context` SocialRankingContext, required: Immutable ranking evidence for the captured period. Top policy combined-top-v1 uses 20% standing, 10% volume, 5% market cap, 20% discussion, 10% reactions, 15% freshness, 10% relevance and 10% substance. Unavailable inputs contribute zero without redistributing weight and remain explicitly null in the response. Signal scope distinguishes native replies, collected other-author asset theses and provider post reply counts. These are social display facts, never financial authority. - `policy_version` string, required - `score_micros` integer, nullable, required - `diversity_round` integer, required - `inputs` object, required - `trader_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_distinct_participants` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `freshness` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `relevance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `substance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `contexts` object[], required - `identity` union, required - … - `holder_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `volume_24h_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `market_cap_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `context_total` integer, required - `contexts_truncated` boolean, required - `used` object, required - `standing` 'trader' | 'holder' | 'null', nullable, required - `asset_context_index` integer, nullable, required - `discussion` 'native' | 'external' | 'null', nullable, required - `reactions` 'native' | 'external' | 'null', nullable, required - `kind` 'trade', required - `actor` union, required: Who produced the item. identity distinguishes CALLD members from external Fomo/pump.fun traders. - SocialFeedCalldActor - `display_name` string, nullable, required - `identity` 'calld', required - `profile_image_url` string, nullable, required - `user_id` string, uuid, required - `username` string, required - SocialFeedTraderActor - `avatar_url` string, nullable, required - `display_name` string, nullable, required - `handle` string, nullable, required - `identity` 'fomo' | 'pump', required - `platform_subject_id` string, required - `trader_profile_id` string, uuid, required: Resolvable through /v2/social/traders/{trader_profile_id} for followed traders. - `content` union, required: A published buy or sell as recorded by Arbital's trade sources. Exact strings; usd_notional is null when not observed. - object - `amount` string, required - `asset` object, required - … - `finality` string, required - `native_amount` string, required - `native_symbol` string, required - `route` string, required - `side` 'buy' | 'sell', required - `source_event_id` string, required - `transaction_signature` string, required - `usd_notional` string, nullable, required - `venue` string, required - `execution_price_usd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `execution_price_unavailable_reason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `receipt` union: Immutable historical display receipt. Pending values are finalized once; never current price, balance, settlement or lifecycle authority. Optional during rollout. Entry is null for buys; USDC sells finalize immediately with available Entry or missing_purchase_history. - … - object - `amount` string, required - `asset` object, required - … - `finality` string, required - `native_amount` string, required - `native_symbol` string, required - `route` string, required - `side` 'buy' | 'sell', required - `source_event_id` string, required - `transaction_signature` string, required - `usd_notional` string, nullable, required - `venue` string, required - `execution_price_usd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `execution_price_unavailable_reason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `receipt` union: Immutable historical display receipt. Pending values are finalized once; never current price, balance, settlement or lifecycle authority. Optional during rollout. Entry is null for buys; USDC sells finalize immediately with available Entry or missing_purchase_history. - … - `reaction_summary` SocialReactionSummary: CALLD reactions on one target, most used first. External-platform likes or counts are never merged in; source says so explicitly. - `reactions` SocialReactionCount[], required - `count` integer, required: Reactions with this emoji by active CALLD accounts. - `emoji` string, required - `viewer_reacted` boolean, required: Whether the signed-in viewer has this reaction; always false for anonymous readers. - `source` 'calld', required - `target` object, required - `id` string, uuid, required - `kind` 'post' | 'asset_comment' | 'thesis' | 'trade' | 'x_post', required - `reply_preview` SocialTradeReplyPreview: Partial first discussion page for a feed card, not a full discussion response. Uses the existing reply ordering and visibility rules, including deleted tombstones with null bodies. Preserves supported media, GIF and mention fields. Does not evaluate token-holder eligibility; use feed permissions for the write policy and the discussion endpoint for current eligibility. - `replies` SocialTradeReply[], required - `author` SocialPostAuthor, required - … - `body` string, nullable, required: Null after parent deletion; empty for a media-only reply. Removing the last image preserves the empty body and deleted media slot. - `created_at_ms` string, required - `deleted` boolean, required - `id` string, uuid, required - `parent_reply_id` string, uuid, nullable, required: Exact direct parent reply on the same post; null for a direct reply to the post. - `reply_count` integer, required: Nondeleted visible direct replies, excluding deeper descendants. - `viewer_can_delete` boolean, required: Whether the viewer owns this undeleted reply and may delete it. - `trade_event_id` string, uuid, required - `reply_count` integer, required: Total visible nondeleted direct replies in this scope, independent of preview length. Tombstones may appear in replies but are excluded from this count. - `next_cursor` string, nullable, required: Opaque trade_replies cursor for older replies in the same post and parent scope. Continue with this cursor on the corresponding existing replies endpoint; a different page limit is allowed. - SocialCombinedThesisItem - `record_id` string, required - `source` 'native' | 'fomo' | 'pump' | 'x', required - `posted_at_ms` string, required - `observed_at_ms` string, required - `content_revision` string, required - `read` boolean, nullable, required - `permissions` SocialFeedPermissions, required: Item-aware actions for the current viewer. Unrestricted Fomo/Pump imported trades allow community replies and CALLD reactions; CALLD trades remain unsupported. Token comment holder rules are unchanged. Mutation-time authorization is still required. - `react` boolean, required - `reply` 'allowed' | 'token_holders' | 'unavailable', required - `ranking_context` SocialRankingContext, required: Immutable ranking evidence for the captured period. Top policy combined-top-v1 uses 20% standing, 10% volume, 5% market cap, 20% discussion, 10% reactions, 15% freshness, 10% relevance and 10% substance. Unavailable inputs contribute zero without redistributing weight and remain explicitly null in the response. Signal scope distinguishes native replies, collected other-author asset theses and provider post reply counts. These are social display facts, never financial authority. - `policy_version` string, required - `score_micros` integer, nullable, required - `diversity_round` integer, required - `inputs` object, required - `trader_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_distinct_participants` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `freshness` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `relevance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `substance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `contexts` object[], required - `identity` union, required - … - `holder_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `volume_24h_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `market_cap_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `context_total` integer, required - `contexts_truncated` boolean, required - `used` object, required - `standing` 'trader' | 'holder' | 'null', nullable, required - `asset_context_index` integer, nullable, required - `discussion` 'native' | 'external' | 'null', nullable, required - `reactions` 'native' | 'external' | 'null', nullable, required - `kind` 'thesis', required - `actor` union, required: Who produced the item. identity distinguishes CALLD members from external Fomo/pump.fun traders. - SocialFeedCalldActor - `display_name` string, nullable, required - `identity` 'calld', required - `profile_image_url` string, nullable, required - `user_id` string, uuid, required - `username` string, required - SocialFeedTraderActor - `avatar_url` string, nullable, required - `display_name` string, nullable, required - `handle` string, nullable, required - `identity` 'fomo' | 'pump', required - `platform_subject_id` string, required - `trader_profile_id` string, uuid, required: Resolvable through /v2/social/traders/{trader_profile_id} for followed traders. - `content` SocialActivityEventRevision, required - `event` union, required: The same normalized event delivered by Social Activity WebSocket v1. Trade prices describe the fill, independently of assetRef.priceUsd. - SocialActivityTradeEvent: Normalized observed trade, with request-time execution pricing on trade. Stored ingestion payloads remain unchanged. - … - object - … - `eventId` string, required - `providerObservation` SocialProviderObservation: Optional indexer-owned provider observations for external social thesis display. Null fields are missing, invalid, or unavailable; omission of the entire observation means unavailable or unsupported. Financial values are historical provider reports, never live holdings, verified P&L, portfolio/quote authority, or lifecycle results. No new provider acquisition or backend content storage is implied. - `kind` 'provider_reported', required - `provider` string, required - `observedAtMs` string, required: Indexer record last-seen time in Unix milliseconds. This does not establish freshness of economic values or of any individual field. - `fieldObservedAtMs` object, required: Original per-field observation clocks in Unix milliseconds, keyed by upstream snake_case field names (segments for structured content). Only populated fields with valid clocks no later than the record last-seen time are included. An absent clock means unknown field freshness; never substitute observedAtMs. - … - `authorName` string, nullable, required - `authorIsDev` boolean, nullable, required - `authorAvatarUrl` string, nullable, required - `tokenImageUrl` string, nullable, required - `segments` object[], nullable, required: Normalized provider segment objects, limited to 64 KiB of serialized JSON. Treat all values as untrusted text/data; never execute or render them as HTML. - … - `holdingsUsd` string, nullable, required - `authorTradeUsd` string, nullable, required - `tokenAmount` string, nullable, required - `pnlUsd` string, nullable, required - `realizedPnlUsd` string, nullable, required - `unrealizedPnlUsd` string, nullable, required - `percentageRealizedPnl` string, nullable, required - `percentageUnrealizedPnl` string, nullable, required - `closedAtMs` string, nullable, required - `authorWalletAddress` string, nullable, required: Provider-reported display text only. Does not establish author ownership, current wallet association, identity, or trading authority. - `authorXUsername` string, nullable, required - `authorIsVerified` boolean, nullable, required - `tokenName` string, nullable, required - `operation` 'upsert', required - `revision` integer, required - `sequence` string, required - `reaction_summary` SocialReactionSummary: CALLD reactions on one target, most used first. External-platform likes or counts are never merged in; source says so explicitly. - `reactions` SocialReactionCount[], required - `count` integer, required: Reactions with this emoji by active CALLD accounts. - `emoji` string, required - `viewer_reacted` boolean, required: Whether the signed-in viewer has this reaction; always false for anonymous readers. - `source` 'calld', required - `target` object, required - `id` string, uuid, required - `kind` 'post' | 'asset_comment' | 'thesis' | 'trade' | 'x_post', required - `reply_preview` SocialAssetCommentReplyPreview: Partial first discussion page for a feed card, not a full discussion response. Uses the existing reply ordering and visibility rules, including deleted tombstones with null bodies. Preserves supported media, GIF and mention fields. Does not evaluate token-holder eligibility; use feed permissions for the write policy and the discussion endpoint for current eligibility. - `replies` SocialAssetComment[], required - `body` string, nullable, required: Null after parent deletion; empty for a media-only or external-GIF-only ordinary reply. Removing the last image preserves the empty body and deleted media slot. - `comment_id` string, uuid, required - `created_at` string, date-time, required - `deleted` boolean, required - `holding_display` string, nullable, required - `is_holder` true, required - `parent_comment_id` string, uuid, nullable, required: Exact direct parent comment in this token thread; null for a root comment. - `reply_count` integer, required: Nondeleted visible direct replies, excluding deeper descendants. - `thesis_event_id` string, uuid, nullable, required: Feed eventId of the imported thesis this comment directly replies to; null for ordinary comments and replies. - `user` SocialAssetCommentAuthor, required - … - `viewer_can_delete` boolean, required: Whether the viewer owns this undeleted comment and may delete it. - `media` union: Ordered immutable slots, with unique IDs and zero-based ordinals matching array positions. Up to four still images, or exactly one GIF. Deletion preserves the slot and original ID. Replies, messages and recap comments omit this field when there are no slots; posts return an empty array. - … - `gif` SocialExternalGifReference: A selected public KLIPY GIF reference, not an approved social-media upload. The backend validates syntax and stores only these identifiers; it does not call KLIPY or approve, cache or store its bytes. Resolve from the end-user client, verify both returned id and slug, apply receiver-side content restrictions and display provider attribution. Missing, filtered or mismatched items are unavailable. Never send an Arbital bearer token to the provider. - … - `mentions` NativeReadMention[], required: Ordered historical entities with current viewer-scoped identity. Empty for legacy, imported or tombstoned content. A read failure is explicit, never a fabricated empty array. - … - `reply_count` integer, required: Total visible nondeleted direct replies in this scope, independent of preview length. Tombstones may appear in replies but are excluded from this count. - `next_cursor` string, uuid, nullable, required: Last returned reply UUID when older replies remain; scoped to the exact token and parent. Continue with this cursor on the corresponding existing replies endpoint; a different page limit is allowed. - `position_entry` SocialFeedPositionEntry: Prepared position behind a Solana thesis, read from the indexer; never computed on the request. opened_at_ms is the opening time of the cycle that includes the thesis (the chart's entry), null while the position is still preparing, stale with an open cycle, or absent. - `request_status` ExternalSocialPositionRequestStatus, required: Explicit computation status. unavailable identifies an unsupported or terminally unresolved observation; an empty items array alone is not a work signal. queued/running/retry_scheduled are pending. Observe Retry-After; GET never queues work. - `state` 'available' | 'queued' | 'running' | 'retry_scheduled' | 'unavailable', required - `reason` string, nullable, required - `retry_after_seconds` integer, required - `opened_at_ms` integer, nullable, required - `lifecycle_state` 'open' | 'closed' | 'unknown', required - `observed_at_ms` integer, nullable, required - `freshness` 'fresh' | 'stale', required - SocialCombinedXPostItem - `record_id` string, required - `source` 'native' | 'fomo' | 'pump' | 'x', required - `posted_at_ms` string, required - `observed_at_ms` string, required - `content_revision` string, required - `read` boolean, nullable, required - `permissions` SocialFeedPermissions, required: Item-aware actions for the current viewer. Unrestricted Fomo/Pump imported trades allow community replies and CALLD reactions; CALLD trades remain unsupported. Token comment holder rules are unchanged. Mutation-time authorization is still required. - `react` boolean, required - `reply` 'allowed' | 'token_holders' | 'unavailable', required - `ranking_context` SocialRankingContext, required: Immutable ranking evidence for the captured period. Top policy combined-top-v1 uses 20% standing, 10% volume, 5% market cap, 20% discussion, 10% reactions, 15% freshness, 10% relevance and 10% substance. Unavailable inputs contribute zero without redistributing weight and remain explicitly null in the response. Signal scope distinguishes native replies, collected other-author asset theses and provider post reply counts. These are social display facts, never financial authority. - `policy_version` string, required - `score_micros` integer, nullable, required - `diversity_round` integer, required - `inputs` object, required - `trader_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_distinct_participants` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_discussion_replies` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `native_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `external_reactions` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `freshness` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `relevance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `substance` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `contexts` object[], required - `identity` union, required - … - `holder_standing` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `volume_24h_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `market_cap_usd` SocialRankingSignal, required: Value and provenance at capture time. Unavailable evidence is null, never a fabricated zero. Scope identifies the measured population; provider_callout market cap is a historical observation, and observed_public_asset_holders covers only collected public holders. - … - `context_total` integer, required - `contexts_truncated` boolean, required - `used` object, required - `standing` 'trader' | 'holder' | 'null', nullable, required - `asset_context_index` integer, nullable, required - `discussion` 'native' | 'external' | 'null', nullable, required - `reactions` 'native' | 'external' | 'null', nullable, required - `kind` 'x_post', required - `actor` object, required - `id` string, required: Stable X account id. - `username` string, required - `display_name` string, nullable, required - `avatar_url` string, nullable, required - `verified` boolean, required - `followers` string, nullable, required: Follower count as observed; null when unknown. - `identity` 'x', required - `content` SocialXFeedPost, required - `id` string, uuid, required: Stable Early record id derived from the X post identity. - `x_post_id` string, required - `source` 'x', required - `author` SocialXFeedAuthor, required - `id` string, required: Stable X account id. - `username` string, required - `display_name` string, nullable, required - `avatar_url` string, nullable, required - `verified` boolean, required - `followers` string, nullable, required: Follower count as observed; null when unknown. - `text` string, required - `url` string, required - `media` SocialXFeedMedia[], required - `kind` 'photo' | 'video' | 'gif', required - `url` string, required - `preview_url` string, nullable, required - `posted_at_ms` string, required: Original publication time (from the post id). - `observed_at_ms` string, required: First collection time. - `updated_at_ms` string, required: Last collection or update. - `removed_at_ms` string, nullable, required - `classification` object, required - `market` string[], required - `content_type` 'news' | 'discussion', required - `topics` string[], required - `evidence` string[], required - `matches` SocialXFeedMatch[], required - `subject_kind` 'token' | 'company' | 'topic', required - `subject_id` string, required - `token` object, nullable, required - … - `company` object, nullable, required - … - `match_kind` 'contract_address' | 'cashtag_with_name' | 'curated_alias' | 'topic_query', required - `evidence` object, required: Matched text evidence, e.g. {"address":...}, {"cashtag":"$SOL","name":"Solana"}, {"alias":...} or {"term":...}. - `engagement` object, required: X counts only, separate from Early reactions; null means unknown. - `likes` string, nullable, required - `reposts` string, nullable, required - `replies` string, nullable, required - `quotes` string, nullable, required - `views` string, nullable, required - `bookmarks` string, nullable, required - `observed_at_ms` string, required - `relationships` object, required - `in_reply_to_id` string, nullable, required - `quoted_post_id` string, nullable, required - `conversation_id` string, nullable, required - `actions` object, required - `discussion_target_id` string, required: Canonical Early discussion target (x_post:). - `reactions_available` boolean, required: True: react through `/v2/social/x/posts/{x_post_id}/reactions`. Early reactions never post to X. - `replies_available` boolean, required: False in this version; Early replies on X posts are not offered yet. - `display_text` string, required - `display` SocialXDisplay, required - `version` 'x-display-v1', required - `status` 'cleaned' | 'unchanged' | 'fallback', required - `empty` boolean, required - `removed_mentions` integer, required - `reaction_summary` SocialReactionSummary: CALLD reactions on one target, most used first. External-platform likes or counts are never merged in; source says so explicitly. - `reactions` SocialReactionCount[], required - `count` integer, required: Reactions with this emoji by active CALLD accounts. - `emoji` string, required - `viewer_reacted` boolean, required: Whether the signed-in viewer has this reaction; always false for anonymous readers. - `source` 'calld', required - `target` object, required - `id` string, uuid, required - `kind` 'post' | 'asset_comment' | 'thesis' | 'trade' | 'x_post', required - `reply_preview` unknown - `next_cursor` string, 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. - `ranking` object, required - `sort` 'latest' | 'top' | 'most_discussed', required - `version` string, required - `window_start_ms` string, required - `window_end_ms` string, required - `diversity` 'none' | 'per_stream_rounds_v1', required - `completeness` 'complete' | 'partial', required: Whether this page used every required source head. Does not promise a complete immutable collection across multiple requests. - `omitted_streams` object[], required - `stream_id` string, required - `reason` string, required - `sources` SocialCombinedSourceStatus[], required - `stream_id` 'application' | 'fomo_posts' | 'pump_posts' | 'x_posts', required - `state` 'healthy' | 'pending' | 'delayed' | 'paused' | 'partial' | 'unavailable' | 'unsupported' | 'unknown', required - `reason` string, nullable, required - `coverage` object, required - `state` 'complete_for_scope' | 'limited' | 'not_monitored' | 'unknown', required - `scope` string, required - `description_code` string, nullable, required - `last_collection_success_at_ms` string, nullable, required: Last confirmed provider collection success, independently of content or generation updates. Null when collection evidence is unavailable or not applicable. - `last_successful_update_at_ms` string, nullable, required: Last successful imported content write, or application capture whose content, membership or interaction fingerprints changed. Quiet snapshot rebuilds and reads do not advance this clock. Null means no successful update is known. - `last_attempt_at_ms` string, nullable, required - `observed_at_ms` string, required - `data_as_of_ms` string, nullable, required - `cache` object, required - `usable` boolean, required - `age_ms` string, nullable, required - `retry_after_ms` integer, nullable, required - `activity_checkpoint` string, 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. - `pagination` object, required: Live seek pagination. Membership, ranking and current visibility can change between requests; clients should deduplicate by record_id. This read time is not a frozen source or ranking anchor. - `mode` 'live', required - `read_at_ms` string, required - `filter_hash` string, required - `scope` 'discovery' | 'friends' | 'watching' | 'native_posts', required ## Other responses - `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. - `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. - `410`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. - `429`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. - `501`: A required capability is unavailable; no sample fallback - `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. --- [API](https://skmtc.dev/arbital/apis/arbital-api.md) - [All operations](https://skmtc.dev/arbital/apis/arbital-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arbital/apis/arbital-api/revisions/bb0185edf43a?raw)