CryptoSocials

CryptoSocials API

CryptoSocials API as documented publicly: 34 operations. Contract generated from the documentation by API Evangelist (2026-11-04); not the provider's own document.

GitHub OpenAPI

Operations 34

POST /account/profile Get account profile #
POST /agent/v1/usage POST /agent/v1/usage #
POST /agent/v2/lookups/get_list Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories. #
POST /agent/v2/lookups/list_lists Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories. #
POST /agent/v2/lookups/list_market_series Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories. #
POST /agent/v2/lookups/resolve_assets Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories. #
POST /agent/v2/lookups/search_authors Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories. #
POST /agent/v2/research/control POST /agent/v2/research/control accepts guide , balance , recent , status , recover and cancel . These controls are free. #
POST /agent/v2/research/discover discover_evidence Find candidate coins, voices and matching evidence. #
POST /agent/v2/research/evidence read_evidence Read exact stored posts, available context and attached price observations. #
POST /agent/v2/research/measure measure_evidence Calculate complete counts, engagement, rankings and comparisons. #
POST /agent/v2/research/prices read_price_context Read a chosen stored price source, dates and genuine gaps. #
POST /archive/coverage Use when checking what readable evidence exists for a requested UTC period and scope. #
POST /assets/detail Use when investigating what people said about a particular asset over a chosen period. #
POST /assets/resolve Use when a user names a coin, ticker or known contract and research needs its exact identity. #
POST /authors/detail Use when checking a Crypto Voice's claims, changes of view or discussion of an asset over time. #
POST /authors/search Use when the user wants to research an X author by handle or name. #
POST /guide Guidance and usage get_research_guide archive:read #
POST /lists Your Lists list_lists lists:read #
POST /lists/activity Query list activity #
POST /lists/detail Get list details #
POST /live/summary Get live summary #
POST /live/views Live list_live_views archive:read #
POST /market/history Get market history #
POST /market/series Use when choosing the stored price source for an exact asset and UTC period before comparing posts with prices. #
POST /posts/batch Read up to 50 canonical post IDs in one request. #
POST /posts/detail get_post Use when verifying one selected source’s original wording, quote/reply/repost attribution or price context. #
POST /posts/engagement Use when checking how a specific post's recorded engagement changed after publication. #
POST /prices/history Use when inspecting the stored prices captured with posts for an asset during a capture-time window. #
POST /query/aggregate Use when ranking discussion, comparing participation or examining a coin’s community by factual posts, views, likes or reposts. #
POST /query/compare Use when comparing how discussion volume changed between two periods for the same assets, authors or topic. #
POST /query/discover Use when finding projects or voices matching a topic and comparing their discussion. #
POST /query/posts search_posts Use when finding what Crypto Voices said about an asset or topic before, during or after a period of interest. #
POST /usage Get usage balance #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/cryptosocials-net/openapi/_ae-authored/cryptosocials-net-openapi-generated.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/cryptosocials-net/json-schema/cryptosocials-net-post-lists-activity-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cryptosocials-net/json-schema/cryptosocials-net-post-market-history-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cryptosocials-net/json-schema/cryptosocials-net-post-assets-detail-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cryptosocials-net/json-schema/cryptosocials-net-post-authors-detail-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cryptosocials-net/json-schema/cryptosocials-net-post-query-aggregate-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cryptosocials-net/json-schema/cryptosocials-net-post-query-posts-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cryptosocials-net:cryptosocials-net-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cryptosocials-net-openapi-generated.yml Raw ↑ 
openapi: 3.1.0
info:
  title: CryptoSocials API
  version: '2026-11-04'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-04: 34 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; CryptoSocials has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 33
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-04'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://cryptosocials.net/developers
servers:
- url: https://api.cryptosocials.net
paths:
  /account/profile:
    post:
      operationId: post_account_profile
      tags:
      - Account
      summary: Get account profile
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v1/usage:
    post:
      operationId: post_agent_v1_usage
      tags:
      - Agent
      summary: POST /agent/v1/usage
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Example Check access and balance · Free Search recent posts · Last 24h List your Lists Search a historical window CryptoSocials
          · Required permission: usage:read Run this in your own terminal after setting the key. All listed REST operations use POST with a JSON
          body, including reads; do not put a key in the URL. REST example Copy REST example curl --fail-with-body --max-time 185 --request PO'
  /agent/v2/lookups/get_list:
    post:
      operationId: post_agent_v2_lookups_get_list
      tags:
      - Agent
      summary: Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories.
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v2/lookups/list_lists:
    post:
      operationId: post_agent_v2_lookups_list_lists
      tags:
      - Agent
      summary: Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories.
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v2/lookups/list_market_series:
    post:
      operationId: post_agent_v2_lookups_list_market_series
      tags:
      - Agent
      summary: Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories.
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v2/lookups/resolve_assets:
    post:
      operationId: post_agent_v2_lookups_resolve_assets
      tags:
      - Agent
      summary: Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories.
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v2/lookups/search_authors:
    post:
      operationId: post_agent_v2_lookups_search_authors
      tags:
      - Agent
      summary: Resolve coin and author identities, inspect your saved Lists, or choose an available price source through these directories.
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v2/research/control:
    post:
      operationId: post_agent_v2_research_control
      tags:
      - Agent
      summary: POST /agent/v2/research/control accepts guide , balance , recent , status , recover and cancel . These controls are free.
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAgentV2ResearchControlRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v2/research/discover:
    post:
      operationId: post_agent_v2_research_discover
      tags:
      - Agent
      summary: discover_evidence Find candidate coins, voices and matching evidence.
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v2/research/evidence:
    post:
      operationId: post_agent_v2_research_evidence
      tags:
      - Agent
      summary: read_evidence Read exact stored posts, available context and attached price observations.
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v2/research/measure:
    post:
      operationId: post_agent_v2_research_measure
      tags:
      - Agent
      summary: measure_evidence Calculate complete counts, engagement, rankings and comparisons.
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /agent/v2/research/prices:
    post:
      operationId: post_agent_v2_research_prices
      tags:
      - Agent
      summary: read_price_context Read a chosen stored price source, dates and genuine gaps.
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /archive/coverage:
    post:
      operationId: post_archive_coverage
      tags:
      - Archive
      summary: Use when checking what readable evidence exists for a requested UTC period and scope.
      description: 'REST: POST /archive/coverage under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostArchiveCoverageRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /assets/detail:
    post:
      operationId: post_assets_detail
      tags:
      - Assets
      summary: Use when investigating what people said about a particular asset over a chosen period.
      description: 'REST: POST /assets/detail under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAssetsDetailRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /assets/resolve:
    post:
      operationId: post_assets_resolve
      tags:
      - Assets
      summary: Use when a user names a coin, ticker or known contract and research needs its exact identity.
      description: 'REST: POST /assets/resolve under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAssetsResolveRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /authors/detail:
    post:
      operationId: post_authors_detail
      tags:
      - Authors
      summary: Use when checking a Crypto Voice's claims, changes of view or discussion of an asset over time.
      description: 'REST: POST /authors/detail under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAuthorsDetailRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /authors/search:
    post:
      operationId: post_authors_search
      tags:
      - Authors
      summary: Use when the user wants to research an X author by handle or name.
      description: 'REST: POST /authors/search under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAuthorsSearchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /guide:
    post:
      operationId: post_guide
      tags:
      - Guide
      summary: Guidance and usage get_research_guide archive:read
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostGuideRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /lists:
    post:
      operationId: post_lists
      tags:
      - Lists
      summary: Your Lists list_lists lists:read
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostListsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /lists/activity:
    post:
      operationId: post_lists_activity
      tags:
      - Lists
      summary: Query list activity
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostListsActivityRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /lists/detail:
    post:
      operationId: post_lists_detail
      tags:
      - Lists
      summary: Get list details
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostListsDetailRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /live/summary:
    post:
      operationId: post_live_summary
      tags:
      - Live
      summary: Get live summary
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostLiveSummaryRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /live/views:
    post:
      operationId: post_live_views
      tags:
      - Live
      summary: Live list_live_views archive:read
      x-source: https://cryptosocials.net/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /market/history:
    post:
      operationId: post_market_history
      tags:
      - Market
      summary: Get market history
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMarketHistoryRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /market/series:
    post:
      operationId: post_market_series
      tags:
      - Market
      summary: Use when choosing the stored price source for an exact asset and UTC period before comparing posts with prices.
      description: 'REST: POST /market/series under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMarketSeriesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /posts/batch:
    post:
      operationId: post_posts_batch
      tags:
      - Posts
      summary: Read up to 50 canonical post IDs in one request.
      description: 'REST: POST /posts/batch under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostPostsBatchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /posts/detail:
    post:
      operationId: post_posts_detail
      tags:
      - Posts
      summary: get_post Use when verifying one selected source’s original wording, quote/reply/repost attribution or price context.
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostPostsDetailRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /posts/engagement:
    post:
      operationId: post_posts_engagement
      tags:
      - Posts
      summary: Use when checking how a specific post's recorded engagement changed after publication.
      description: 'REST: POST /posts/engagement under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostPostsEngagementRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /prices/history:
    post:
      operationId: post_prices_history
      tags:
      - Prices
      summary: Use when inspecting the stored prices captured with posts for an asset during a capture-time window.
      description: 'REST: POST /prices/history under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostPricesHistoryRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /query/aggregate:
    post:
      operationId: post_query_aggregate
      tags:
      - Query
      summary: Use when ranking discussion, comparing participation or examining a coin’s community by factual posts, views, likes or reposts.
      description: 'REST: POST /query/aggregate under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostQueryAggregateRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /query/compare:
    post:
      operationId: post_query_compare
      tags:
      - Query
      summary: Use when comparing how discussion volume changed between two periods for the same assets, authors or topic.
      description: 'REST: POST /query/compare under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostQueryCompareRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /query/discover:
    post:
      operationId: post_query_discover
      tags:
      - Query
      summary: Use when finding projects or voices matching a topic and comparing their discussion.
      description: 'REST: POST /query/discover under the selected base URL.'
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostQueryDiscoverRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /query/posts:
    post:
      operationId: post_query_posts
      tags:
      - Query
      summary: search_posts Use when finding what Crypto Voices said about an asset or topic before, during or after a period of interest.
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostQueryPostsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /usage:
    post:
      operationId: post_usage
      tags:
      - Usage
      summary: Get usage balance
      x-source: https://cryptosocials.net/developers
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostUsageRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostAgentV2ResearchControlRequest:
      type: object
      properties:
        guide:
          type: string
        balance:
          type: string
        recent:
          type: string
        status:
          type: string
        recover:
          type: string
        cancel:
          type: string
    PostArchiveCoverageRequest:
      type: object
      properties:
        date_from:
          type: string
          description: Inclusive UTC start.
        date_to:
          type: string
          description: Exclusive UTC end.
        author_ids:
          type: array
          description: Filter by author UUIDs.
        asset_ids:
          type: array
          description: Filter by asset UUIDs.
        chain_ids:
          type: array
          description: Filter by chain IDs.
        metrics:
          type: string
          description: counts or coverage, default coverage.
      required:
      - date_from
      - date_to
    PostAssetsDetailRequest:
      type: object
      properties:
        asset_id:
          type: string
          description: Asset UUID.
        date_from:
          type: string
          description: Inclusive UTC start.
        date_to:
          type: string
          description: Exclusive UTC end.
        author_ids:
          type: array
          description: Filter by author UUIDs.
        asset_ids:
          type: array
          description: Additional asset filters.
        chain_ids:
          type: array
          description: Filter by chain IDs.
        projection:
          type: string
          description: index, preview, reading, market.
        limit:
          type: integer
          description: Page size, default 20.
        cursor:
          type: string
          description: Pagination cursor.
      required:
      - asset_id
      - date_from
      - date_to
    PostAssetsResolveRequest:
      type: object
      properties:
        query:
          type: string
          description: Asset name, symbol, canonical key or contract key.
        limit:
          type: integer
          description: Page size, default 20.
        cursor:
          type: string
          description: Pagination cursor.
      required:
      - query
    PostAuthorsDetailRequest:
      type: object
      properties:
        author_id:
          type: string
          description: Author UUID.
        date_from:
          type: string
          description: Inclusive UTC start.
        date_to:
          type: string
          description: Exclusive UTC end.
        author_ids:
          type: array
          description: Additional author filters.
        asset_ids:
          type: array
          description: Asset filters.
        chain_ids:
          type: array
          description: Chain filters.
        projection:
          type: string
          description: index, preview, reading, market.
        limit:
          type: integer
          description: Page size, default 20.
        cursor:
          type: string
          description: Pagination cursor.
      required:
      - author_id
      - date_from
      - date_to
    PostAuthorsSearchRequest:
      type: object
      properties:
        query:
          type: string
          description: X handle, platform user ID or display-name prefix.
        limit:
          type: integer
          description: Page size, default 20.
        cursor:
          type: string
          description: Pagination cursor.
      required:
      - query
    PostGuideRequest:
      type: object
      properties:
        topic:
          type: string
          description: One of overview, live, coins, authors, prices, chains, lists, history, coverage, data, all
    PostListsRequest:
      type: object
      properties:
        limit:
          type: integer
          description: Page size (1‑50)
        after_id:
          type: string
          description: UUID of the last List from previous page
    PostListsActivityRequest:
      type: object
      properties:
        list_id:
          type: string
          description: UUID of the List
        date_from:
          type: string
          description: Inclusive UTC start
        date_to:
          type: string
          description: Exclusive UTC end
        author_ids:
          type: array
          description: Array of author UUIDs (max 20)
        asset_ids:
          type: array
          description: Array of asset UUIDs (max 20)
        chain_ids:
          type: array
          description: Array of chain IDs (max 20)
        asset_type:
          type: string
          description: native, token, or unknown
        multichain:
          type: boolean
          description: Filter for multichain assets
        post_types:
          type: array
          description: Array of post type enums
        exclude_post_types:
          type: array
          description: Array of post type enums to exclude
        evidence_class:
          type: string
          description: direct or embedded_quote
        has_media:
          type: boolean
          description: Filter posts with media
        text:
          type: object
          description: Text search object
        limit:
          type: integer
          description: Page size (1‑50)
        cursor:
          type: string
          description: Paging cursor
        mode:
          type: string
          description: explore or exhaustive
        projection:
          type: string
          description: index, preview, reading, market
        order:
          type: string
          description: newest or time_balanced
        detail:
          type: string
          description: compact or market
      required:
      - list_id
      - date_from
      - date_to
    PostListsDetailRequest:
      type: object
      properties:
        list_id:
          type: string
          description: UUID of the List
      required:
      - list_id
    PostLiveSummaryRequest:
      type: object
      properties:
        view_id:
          type: string
          description: UUID of the live view
        expected_input_stamp:
          type: string
          description: 64‑char hex stamp
      required:
      - view_id
    PostMarketHistoryRequest:
      type: object
      properties:
        asset_id:
          type: string
          description: UUID of the asset
        series_id:
          type: string
          description: UUID of the price series
        date_from:
          type: string
          description: Inclusive UTC start
        date_to:
          type: string
          description: Exclusive UTC end
        interval:
          type: integer
          description: Candle interval (60,300,900,3600,86400)
        limit:
          type: integer
          description: Page size (1‑50)
        cursor:
          type: string
          description: Paging cursor
        point_limit:
          type: integer
          description: Max raw points per page (1‑250)
        point_cursor:
          type: string
          description: Raw points paging cursor
        point_only:
          type: boolean
          description: Return only raw points
      required:
      - asset_id
      - series_id
      - date_from
      - date_to
    PostMarketSeriesRequest:
      type: object
      properties:
        asset_id:
          type: string
          description: Asset UUID.
        date_from:
          type: string
          description: Inclusive UTC start.
        date_to:
          type: string
          description: Exclusive UTC end.
        limit:
          type: integer
          description: Page size, default 20.
        cursor:
          type: string
          description: Pagination cursor.
      required:
      - asset_id
      - date_from
      - date_to
    PostPostsBatchRequest:
      type: object
      properties:
        post_ids:
          type: array
          description: Array of post UUID strings (1‑50 items).
        projection:
          type: string
          description: reading or market, default reading.
      required:
      - post_ids
    PostPostsDetailRequest:
      type: object
      properties:
        post_id:
          type: string
        projection:
          type: string
        detail:
          type: string
      required:
      - post_id
    PostPostsEngagementRequest:
      type: object
      properties:
        post_id:
          type: string
          description: Post UUID.
        limit:
          type: integer
          description: Page size, default 20.
        cursor:
          type: string
          description: Pagination cursor.
      required:
      - post_id
    PostPricesHistoryRequest:
      type: object
      properties:
        asset_id:
          type: string
          description: Asset UUID.
        date_from:
          type: string
          description: Inclusive UTC start.
        date_to:
          type: string
          description: Exclusive UTC end.
        limit:
          type: integer
          description: Page size, default 20.
        cursor:
          type: string
          description: Pagination cursor.
      required:
      - asset_id
      - date_from
      - date_to
    PostQueryAggregateRequest:
      type: object
      properties:
        date_from:
          type: string
          description: Inclusive UTC start.
        date_to:
          type: string
          description: Exclusive UTC end.
        author_ids:
          type: array
          description: Filter by author UUIDs.
        asset_ids:
          type: array
          description: Filter by asset UUIDs.
        metrics:
          type: string
          description: counts, coverage, or engagement, default coverage.
        order:
          type: string
          description: Sorting order options.
        limit:
          type: integer
          description: Page size, default 20.
        cursor:
          type: string
          description: Pagination cursor.
      required:
      - date_from
      - date_to
    PostQueryCompareRequest:
      type: object
      properties:
        baseline:
          type: object
          description: Baseline window definition.
        current:
          type: object
          description: Current window definition.
      required:
      - baseline
      - current
    PostQueryDiscoverRequest:
      type: object
      properties:
        discovery:
          type: object
          description: Discovery window definition.
        current:
          type: object
          description: Current measurement window.
        group_by:
          type: string
          description: asset or author, default asset.
        order:
          type: string
          description: Sorting order, default current_post_count_desc.
        limit:
          type: integer
          description: Page size, default 20.
        cursor:
          type: string
          description: Pagination cursor.
      required:
      - discovery
      - current
    PostQueryPostsRequest:
      type: object
      properties:
        date_from:
          type: string
        date_to:
          type: string
        author_ids:
          type: string
        asset_ids:
          type: string
        chain_ids:
          type: string
        asset_type:
          type: string
        multichain:
          type: string
        post_types:
          type: string
        exclude_post_types:
          type: string
        evidence_class:
          type: string
        has_media:
          type: string
        text:
          type: string
        limit:
          type: string
        cursor:
          type: string
        mode:
          type: string
        projection:
          type: string
        order:
          type: string
        detail:
          type: string
      required:
      - date_from
      - date_to
    PostUsageRequest:
      type: object
      properties:
        limit:
          type: integer
          description: Page size (1‑50)
        cursor:
          type: string
          description: Paging cursor
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Account
- name: Agent
- name: Archive
- name: Assets
- name: Authors
- name: Guide
- name: Lists
- name: Live
- name: Market
- name: Posts
- name: Prices
- name: Query
- name: Usage