---
title: "Resolve ordered trader summaries with explicit 30-day capability"
method: POST
path: "/v2/social/traders/summaries"
tags: ["Social Activity"]
---

# Resolve ordered trader summaries with explicit 30-day capability

`POST /v2/social/traders/summaries`

## 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/traders/summaries`
- Auth: HTTP bearer

One to six native/imported subjects. Preserves input order and duplicates, deduplicates identity work and isolates per-item failures. Resolved identities have status ok but explicit unavailable performance with null metrics/chart. Service unavailable returns 503. Private/no-store including handler errors.

## Request body

- TraderSummariesRequest: Ordered typed subjects; duplicate inputs remain in output while identity work is deduplicated. No wallet overrides.
  - `period` '30d', required
  - `subjects` TraderSubject[], required
    - `kind` 'native' | 'imported', required
    - `id` string, uuid, required

## Response `200`

Ordered identity resolution and performance capability results

- TraderSummariesResponse: One result per input in input order. status=ok means resolved identity, not available performance; other statuses have null performance.
  - `requested_period` '30d', required
  - `items` TraderSummaryItem[], required
    - union
      - object
        - `subject` TraderSubject, required
          - `kind` 'native' | 'imported', required
          - `id` string, uuid, required
        - `status` 'ok', required
        - `performance` TraderPerformance30dUnavailable, required: Unsupported comparable 30-day performance capability only. Metrics, methodology, chart and source timestamps remain null. Disclosed available shorter periods are never substitutes for 30d. No available-performance variant is promised.
          - `subject` TraderSubject, required
            - `kind` 'native' | 'imported', required
            - `id` string, uuid, required
          - `availability` 'unavailable', required
          - `return_pct` unknown, required
          - `pnl_usd` unknown, required
          - `pnl_kind` unknown, required
          - `requested_period` '30d', required
          - `requested_start_ms` string, required
          - `requested_end_ms` string, required
          - `actual_period` unknown, required
          - `actual_start_ms` unknown, required
          - `actual_end_ms` unknown, required
          - `available_periods` string[], required
          - `currency` 'USD', required
          - `coverage` object, required
            - `wallets` string[], required
            - `networks` string[], required
            - `completeness` 'unknown', required
          - `methodology` object, required
            - `id` unknown, required
            - `return_denominator` unknown, required
            - `cash_flow_treatment` unknown, required
            - `fees_included` unknown, required
            - `provider_estimate` unknown, required
          - `source` 'indexer_social_query' | 'codex', required
          - `as_of_ms` unknown, required
          - `updated_at_ms` unknown, required
          - `completeness` 'unavailable', required
          - `unavailable_reason` 'upstream_30d_not_supported' | 'comparable_performance_not_supported', required
          - `chart` unknown, required
      - object
        - `subject` TraderSubject, required
          - `kind` 'native' | 'imported', required
          - `id` string, uuid, required
        - `status` 'not_found' | 'not_permitted' | 'unavailable', required
        - `performance` unknown, 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.
- `409`: 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.
- `429`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `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)