---
title: "GET /v2/social/posts"
method: GET
path: "/v2/social/posts"
tags: ["Social Community"]
---

# GET /v2/social/posts

`GET /v2/social/posts`

## 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: one of:
  - HTTP bearer
  - none

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).

## Query parameters

- `sort` 'latest' | 'top' | 'most_discussed'
- `category` 'all' | 'memes' | 'equities'
- `period` '24h' | '7d' | '30d'
- `sources` string
- `asset` string
- `company` string
- `limit` integer
- `cursor` string

## Response `200`

Community posts

- union
  - SocialPostPage
    - `next_cursor` string, nullable, required: Opaque scope-bound cursor for the next page.
    - `posts` 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[]
          - union
            - SocialMediaImage
              - …
            - DeletedSocialMedia: Permanent bound slot after media removal. Only these three fields remain; the parent remains renderable even when its body is empty and every image is deleted.
              - …
        - SocialMediaGif[]
          - `id` string, uuid, required
          - `media_kind` 'gif', required
          - `mime_type` 'image/gif', required
          - `size_bytes` integer, required
          - `width` integer, required
          - `height` integer, required
          - `access_path` string, required: Authenticated relative byte-read path for this media ID; never a public or signed storage URL.
          - `source_tenor_url` string
          - `ordinal` integer, required
          - `deleted` false
          - `delivery` SocialMediaDelivery: Optional HTTP-only delivery capability, issued after current access checks. URLs expire together at expires_at. Clients load the thumbnail in feeds and the full normalized image or animated GIF when opened. Refresh by re-reading the parent endpoint; access_path remains an authenticated fallback. Never persist, broadcast or share these viewer-specific URLs.
            - `url` string, uri, required: Short-lived Cloudflare Worker URL for the full normalized image or GIF. Treat it as opaque; refetch authorized parent metadata before expires_at to renew.
            - `expires_at` string, date-time, required
            - `thumbnail` object: Bounded WebP preview. Animated GIFs use an approved still poster.
              - …
      - `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
          - object: Canonical token reference; does not prove that the token exists.
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'token', required
            - `asset` union, required
              - …
            - `verification` 'author_claimed', required
          - object: The backend resolved the original post and author when shared. Verification applies to the reference, not its financial statements. Deleted, blocked or inactive sources retain the ID but return a null author and unavailable state. No recursive content expansion.
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'post', required
            - `post_id` string, uuid, required
            - `original_author` SocialAttachmentAuthor, required
              - …
            - `availability` 'available' | 'unavailable', required
            - `verification` 'verified', required
          - object
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'position', required
            - `asset` union, required
              - …
            - `position_id` unknown, required
            - `source` 'author', required
            - `calculation_version` unknown, required
            - `snapshot` SocialPositionSnapshot, required: Immutable historical snapshot. Never refreshed from current holdings or prices, and never used as portfolio, quote, settlement or accounting authority.
              - …
            - `verification` 'author_claimed', required
            - `lifecycle` SocialPositionLifecycleSummary: Optional social-display lifecycle for a permanently retained position attachment. Initially supported for tracked non-native Solana tokens only. Open/closed requires complete bounded Codex token history that matches the immutable attachment quantity and current provider holding; unknown means that evidence is unavailable, incomplete, unsupported, or inconsistent, never proof of a zero holding. A later purchase reopens the same attachment without removing prior cycles. Stale summaries return state unknown and null realized_pnl_usd/current_cycle_id; observed_at_ms and closed_cycle_count retain historical context. Freshness does not imply known P&L. Realized P&L is a provider estimate, not tax/accounting evidence; unavailable valuation returns null, and fees are unavailable. Never balance, quote, settlement, or execution authority. The original snapshot is unchanged.
              - …
          - object: Available only through the authoritative position reader. Ownership, complete source evidence and observation time are validated before storage.
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'position', required
            - `asset` union, required
              - …
            - `position_id` string, required
            - `source` 'position_ledger', required
            - `calculation_version` string, required
            - `snapshot` SocialPositionSnapshot, required: Immutable historical snapshot. Never refreshed from current holdings or prices, and never used as portfolio, quote, settlement or accounting authority.
              - …
            - `verification` 'verified', required
            - `lifecycle` SocialPositionLifecycleSummary: Optional social-display lifecycle for a permanently retained position attachment. Initially supported for tracked non-native Solana tokens only. Open/closed requires complete bounded Codex token history that matches the immutable attachment quantity and current provider holding; unknown means that evidence is unavailable, incomplete, unsupported, or inconsistent, never proof of a zero holding. A later purchase reopens the same attachment without removing prior cycles. Stale summaries return state unknown and null realized_pnl_usd/current_cycle_id; observed_at_ms and closed_cycle_count retain historical context. Freshness does not imply known P&L. Realized P&L is a provider estimate, not tax/accounting evidence; unavailable valuation returns null, and fees are unavailable. Never balance, quote, settlement, or execution authority. The original snapshot is unchanged.
              - …
          - object: Historical snapshot fetched server-side from the authenticated owner’s Codex portfolio. Quantity is an exact decimal; value uses the provider price; profit is estimated unrealized P&L from Codex basis only. Unknown values are null. These are provider-reported display figures, not verified financial/accounting facts. Relay/Mobula supplemented basis and experimental closed cycles are excluded. Post reads never refresh the snapshot.
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'position', required
            - `asset` union, required
              - …
            - `position_id` unknown, required
            - `source` 'codex', required
            - `calculation_version` 'codex_position_recap_v1', required
            - `snapshot` SocialPositionSnapshot, required: Immutable historical snapshot. Never refreshed from current holdings or prices, and never used as portfolio, quote, settlement or accounting authority.
              - …
            - `verification` 'provider_reported', required
            - `lifecycle` SocialPositionLifecycleSummary: Optional social-display lifecycle for a permanently retained position attachment. Initially supported for tracked non-native Solana tokens only. Open/closed requires complete bounded Codex token history that matches the immutable attachment quantity and current provider holding; unknown means that evidence is unavailable, incomplete, unsupported, or inconsistent, never proof of a zero holding. A later purchase reopens the same attachment without removing prior cycles. Stale summaries return state unknown and null realized_pnl_usd/current_cycle_id; observed_at_ms and closed_cycle_count retain historical context. Freshness does not imply known P&L. Realized P&L is a provider estimate, not tax/accounting evidence; unavailable valuation returns null, and fees are unavailable. Never balance, quote, settlement, or execution authority. The original snapshot is unchanged.
              - …
      - `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
          - `user_id` string, uuid, required
          - `username` string, required
          - `display_name` string, nullable, required
          - `profile_image_url` string, nullable, required
        - `profile_target` NativeMentionTarget, required
          - `kind` 'early_user', required
          - `user_id` string, uuid, required
        - `notification_supported` true, required
  - SocialRankedPostPage
    - `items` SocialRankedPost[], 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[]
          - union
            - SocialMediaImage
              - …
            - DeletedSocialMedia: Permanent bound slot after media removal. Only these three fields remain; the parent remains renderable even when its body is empty and every image is deleted.
              - …
        - SocialMediaGif[]
          - `id` string, uuid, required
          - `media_kind` 'gif', required
          - `mime_type` 'image/gif', required
          - `size_bytes` integer, required
          - `width` integer, required
          - `height` integer, required
          - `access_path` string, required: Authenticated relative byte-read path for this media ID; never a public or signed storage URL.
          - `source_tenor_url` string
          - `ordinal` integer, required
          - `deleted` false
          - `delivery` SocialMediaDelivery: Optional HTTP-only delivery capability, issued after current access checks. URLs expire together at expires_at. Clients load the thumbnail in feeds and the full normalized image or animated GIF when opened. Refresh by re-reading the parent endpoint; access_path remains an authenticated fallback. Never persist, broadcast or share these viewer-specific URLs.
            - `url` string, uri, required: Short-lived Cloudflare Worker URL for the full normalized image or GIF. Treat it as opaque; refetch authorized parent metadata before expires_at to renew.
            - `expires_at` string, date-time, required
            - `thumbnail` object: Bounded WebP preview. Animated GIFs use an approved still poster.
              - …
      - `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
          - object: Canonical token reference; does not prove that the token exists.
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'token', required
            - `asset` union, required
              - …
            - `verification` 'author_claimed', required
          - object: The backend resolved the original post and author when shared. Verification applies to the reference, not its financial statements. Deleted, blocked or inactive sources retain the ID but return a null author and unavailable state. No recursive content expansion.
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'post', required
            - `post_id` string, uuid, required
            - `original_author` SocialAttachmentAuthor, required
              - …
            - `availability` 'available' | 'unavailable', required
            - `verification` 'verified', required
          - object
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'position', required
            - `asset` union, required
              - …
            - `position_id` unknown, required
            - `source` 'author', required
            - `calculation_version` unknown, required
            - `snapshot` SocialPositionSnapshot, required: Immutable historical snapshot. Never refreshed from current holdings or prices, and never used as portfolio, quote, settlement or accounting authority.
              - …
            - `verification` 'author_claimed', required
            - `lifecycle` SocialPositionLifecycleSummary: Optional social-display lifecycle for a permanently retained position attachment. Initially supported for tracked non-native Solana tokens only. Open/closed requires complete bounded Codex token history that matches the immutable attachment quantity and current provider holding; unknown means that evidence is unavailable, incomplete, unsupported, or inconsistent, never proof of a zero holding. A later purchase reopens the same attachment without removing prior cycles. Stale summaries return state unknown and null realized_pnl_usd/current_cycle_id; observed_at_ms and closed_cycle_count retain historical context. Freshness does not imply known P&L. Realized P&L is a provider estimate, not tax/accounting evidence; unavailable valuation returns null, and fees are unavailable. Never balance, quote, settlement, or execution authority. The original snapshot is unchanged.
              - …
          - object: Available only through the authoritative position reader. Ownership, complete source evidence and observation time are validated before storage.
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'position', required
            - `asset` union, required
              - …
            - `position_id` string, required
            - `source` 'position_ledger', required
            - `calculation_version` string, required
            - `snapshot` SocialPositionSnapshot, required: Immutable historical snapshot. Never refreshed from current holdings or prices, and never used as portfolio, quote, settlement or accounting authority.
              - …
            - `verification` 'verified', required
            - `lifecycle` SocialPositionLifecycleSummary: Optional social-display lifecycle for a permanently retained position attachment. Initially supported for tracked non-native Solana tokens only. Open/closed requires complete bounded Codex token history that matches the immutable attachment quantity and current provider holding; unknown means that evidence is unavailable, incomplete, unsupported, or inconsistent, never proof of a zero holding. A later purchase reopens the same attachment without removing prior cycles. Stale summaries return state unknown and null realized_pnl_usd/current_cycle_id; observed_at_ms and closed_cycle_count retain historical context. Freshness does not imply known P&L. Realized P&L is a provider estimate, not tax/accounting evidence; unavailable valuation returns null, and fees are unavailable. Never balance, quote, settlement, or execution authority. The original snapshot is unchanged.
              - …
          - object: Historical snapshot fetched server-side from the authenticated owner’s Codex portfolio. Quantity is an exact decimal; value uses the provider price; profit is estimated unrealized P&L from Codex basis only. Unknown values are null. These are provider-reported display figures, not verified financial/accounting facts. Relay/Mobula supplemented basis and experimental closed cycles are excluded. Post reads never refresh the snapshot.
            - `id` string, uuid, required
            - `ordinal` integer, required
            - `kind` 'position', required
            - `asset` union, required
              - …
            - `position_id` unknown, required
            - `source` 'codex', required
            - `calculation_version` 'codex_position_recap_v1', required
            - `snapshot` SocialPositionSnapshot, required: Immutable historical snapshot. Never refreshed from current holdings or prices, and never used as portfolio, quote, settlement or accounting authority.
              - …
            - `verification` 'provider_reported', required
            - `lifecycle` SocialPositionLifecycleSummary: Optional social-display lifecycle for a permanently retained position attachment. Initially supported for tracked non-native Solana tokens only. Open/closed requires complete bounded Codex token history that matches the immutable attachment quantity and current provider holding; unknown means that evidence is unavailable, incomplete, unsupported, or inconsistent, never proof of a zero holding. A later purchase reopens the same attachment without removing prior cycles. Stale summaries return state unknown and null realized_pnl_usd/current_cycle_id; observed_at_ms and closed_cycle_count retain historical context. Freshness does not imply known P&L. Realized P&L is a provider estimate, not tax/accounting evidence; unavailable valuation returns null, and fees are unavailable. Never balance, quote, settlement, or execution authority. The original snapshot is unchanged.
              - …
      - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
        - `contexts` object[], required
          - `identity` union, required
            - object
              - …
            - object
              - …
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
          - `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.
            - `value` string, nullable, required
            - `unit` 'usd' | 'count' | 'percentile' | 'score_0_1' | 'hours', required
            - `source` object, nullable, required
              - …
            - `scope` string, required
            - `window_start_ms` string, nullable, required
            - `window_end_ms` string, nullable, required
            - `observed_at_ms` string, nullable, required
            - `availability` 'available' | 'unavailable' | 'unsupported', required
            - `reason` string, nullable, required
        - `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
    - `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 post 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.
- `404`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `408`: 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.
- `413`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `422`: 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)