---
title: "Chain intelligence summary"
method: GET
path: "/v1/wallets/{address}/summary"
tags: ["wallets"]
---

# Chain intelligence summary

`GET /v1/wallets/{address}/summary`

## Request

- Base URL: `https://satoshidata.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://satoshidata.ai/v1/wallets/{address}/summary`
- Auth: none declared

Premium satoshidata.ai chain-intelligence summary for a single Bitcoin address.

## Path parameters

- `address` string, required

## Query parameters

- `view` string, nullable: Optional response view. Set `view=compact` for a smaller agent-oriented payload.

## Headers

- `Authorization` string, nullable

## Response `200`

Wallet summary

- WalletSummaryResponse: Premium wallet summary. The label block is asserted-only. When label.category or label.value is null, consumers should read likely_entity and short_explanation for the hedged lead.
  - `address` string, required
  - `label` WalletLabelProjection, required
    - `category` string, nullable: Asserted only when the public evidence meets the verified-source threshold and the label is high confidence. Otherwise this is null; read likely_entity on summary responses or likely_label.value on trust-safety responses for the hedged lead.
    - `value` string, nullable: Asserted only when the public evidence meets the verified-source threshold and the label is high confidence. Otherwise this is null; read likely_entity on summary responses or likely_label.value on trust-safety responses for the hedged lead.
    - `hint` string, nullable: Present when category/value are not asserted but a contextual lead exists. This points to likely_entity, likely_label.value, and explanation fields without promoting them into label.value.
    - `confidence` string, nullable
    - `confidence_tier` 'verified' | 'attributed' | 'clustered' | 'reported', nullable: Public provenance tier for this label source family.
    - `source` string, nullable
    - `source_ref` string, nullable
    - `label` string, nullable: Legacy label alias emitted by wallet projections; null when the asserted value is disputed.
    - `value_disputed` boolean, nullable
    - `category_disputed` boolean, nullable
  - `kind` 'wallet_summary'
  - `claim_type` string, nullable
  - `evidence_tier` string, nullable
  - `confidence_tier` 'verified' | 'attributed' | 'clustered' | 'reported', nullable: Public provenance authority for verified, attributed, clustered, or reported treatment.
  - `tier` 'verified' | 'attributed' | 'clustered' | 'reported', nullable: Compatibility alias of confidence_tier.
  - `is_verified_identity` boolean, nullable: True only when confidence_tier is verified; false for attributed, clustered, imported, or reported leads.
  - `attribution` WalletAttributionProjection
    - `source` string, nullable
    - `source_ref` string, nullable
    - `claim_type` string, nullable
    - `independently_verified` false
    - `basis` 'single_source_third_party'
    - `attribution_grain` 'entity' | 'category', required
    - `note` string, required
  - `evidence_types` string[]
  - `source` string, nullable
  - `source_ref` string, nullable
  - `narrative` string, nullable
  - `updated_at` string, nullable
  - `consensus` WalletConsensusProjection
    - `state` string, nullable: Agreement state for the public wallet label signal.
    - `label` string, nullable: Human-readable agreement label for the state.
    - `contributor_count` integer, nullable: Distinct public sources behind the label signal.
    - `label_count` integer, nullable: Total public reports behind the label signal.
    - `has_conflict` boolean, nullable: True when public labels conflict.
  - `historical_flags` string[]
  - `risk_indicator` 'unknown' | 'neutral' | 'elevated', nullable
  - `confidence` string, nullable
  - `explanation` string, nullable
  - `likely_category` string, nullable
  - `likely_entity` string, nullable
  - `likely_label` WalletTrustSafetyLikelyLabel
    - `category` string, nullable: Asserted only when the public evidence meets the verified-source threshold and the label is high confidence. Otherwise this is null; read likely_entity on summary responses or likely_label.value on trust-safety responses for the hedged lead.
    - `value` string, nullable: Asserted only when the public evidence meets the verified-source threshold and the label is high confidence. Otherwise this is null; read likely_entity on summary responses or likely_label.value on trust-safety responses for the hedged lead.
    - `hint` string, nullable: Present when category/value are not asserted but a contextual lead exists. This points to likely_entity, likely_label.value, and explanation fields without promoting them into label.value.
    - `confidence` string, nullable
    - `confidence_tier` 'verified' | 'attributed' | 'clustered' | 'reported', nullable: Public provenance tier for this label source family.
    - `source` string, nullable
    - `source_ref` string, nullable
    - `label` string, nullable
    - `value_disputed` boolean, nullable
    - `category_disputed` boolean, nullable
    - `is_disputed` boolean, required
    - `has_consensus` boolean, nullable
    - `consensus_state` 'disputed' | 'none', nullable
    - `reason` string, nullable
    - `projection` 'top_public_lead', required
    - `evidence_tier` string, nullable
    - `claim_type` string, nullable
    - `label_count` integer, nullable
    - `unique_contributors` integer, nullable
    - `warning` string, nullable
  - `label_count` integer, nullable
  - `unique_contributors` integer, nullable
  - `has_conflict` boolean, nullable
  - `short_explanation` string, nullable
  - `caveats` string[]
  - `metadata` object
  - `external_mirrors` object[]
  - `cluster_recency` object, nullable
  - `examined` boolean, nullable
  - `examined_at` string, nullable
  - `examined_source` string, nullable
  - `note` string, nullable
  - `inferred_label` WalletLabelProjection
    - `category` string, nullable: Asserted only when the public evidence meets the verified-source threshold and the label is high confidence. Otherwise this is null; read likely_entity on summary responses or likely_label.value on trust-safety responses for the hedged lead.
    - `value` string, nullable: Asserted only when the public evidence meets the verified-source threshold and the label is high confidence. Otherwise this is null; read likely_entity on summary responses or likely_label.value on trust-safety responses for the hedged lead.
    - `hint` string, nullable: Present when category/value are not asserted but a contextual lead exists. This points to likely_entity, likely_label.value, and explanation fields without promoting them into label.value.
    - `confidence` string, nullable
    - `confidence_tier` 'verified' | 'attributed' | 'clustered' | 'reported', nullable: Public provenance tier for this label source family.
    - `source` string, nullable
    - `source_ref` string, nullable
    - `label` string, nullable: Legacy label alias emitted by wallet projections; null when the asserted value is disputed.
    - `value_disputed` boolean, nullable
    - `category_disputed` boolean, nullable
  - `next_steps` WalletNoLabelNextSteps
    - `premium_adds_data` boolean, required: True when premium wallet endpoints are expected to provide additional label-source data for this address.
    - `premium_note` string, required: Short guidance explaining whether premium adds additional label-source data for this address.
    - `contribute` WalletNoLabelContribute, required
      - `endpoint` string, required
      - `method` 'POST'
      - `cost` 'free'
      - `purpose` string, required
  - `access` PublicAccessProjection
    - `tier` string, nullable
    - `auth_mode` string, nullable
    - `auth_header` string, nullable
    - `authorization_scheme` string, nullable
    - `label` string, nullable
  - `_meta` ResponseMeta, required
    - `endpoint` string, required
    - `freshness` string, nullable
    - `freshness_semantics` 'internal_refresh' | 'source_poll' | 'claim_made', nullable
    - `source` string, required
    - `price_sats` integer, nullable
    - `price_usd` string, nullable
    - `docs` string, nullable
    - `warnings` ResponseWarning[]
      - `code` string, required
      - `message` string, required
    - `pagination` ResponsePagination
      - `offset` integer, required
      - `limit` integer, required
      - `total_alerts` integer, required
      - `next_offset` integer, nullable, required
      - `has_more` boolean, required
    - `view` 'compact', nullable
    - `bitcoin_backend` string, nullable
    - `beta` boolean, nullable
    - `cache_seconds` integer, nullable
    - `cache_ttl_seconds` integer, nullable
    - `cache_status` string, nullable
    - `cache_age_seconds` number, nullable
    - `cache_cached_at` string, nullable
    - `cached` boolean, nullable
    - `cache_policy` string, nullable
    - `compute_ms` integer, nullable
    - `warning` string, nullable
    - `refresh_warning` string, nullable
    - `last_refresh_started_at` string, nullable
    - `last_refresh_completed_at` string, nullable
    - `last_refresh_status` string, nullable
    - `last_refresh_error` string, nullable
    - `last_refresh_duration_ms` integer, nullable
    - `feature_flag` string, nullable
    - `rollout_state` string, nullable
    - `schema_version` string, nullable
    - `methodology_version` string, nullable
    - `materialized_source` string, nullable
    - `max_hops` integer, nullable
    - `retention` string, nullable
    - `not_compliance_advice` boolean, nullable
    - `future_native_price_mode` string, nullable
    - `future_native_price_note` string, nullable
    - `future_native_quote_endpoint` string, nullable
    - `overview_activity_cache` object, nullable
    - `attribution_confidence` string, nullable
    - `generated_at` string, nullable
    - `last_computed` string, nullable
    - `snapshot_generated_at` string, nullable
    - `snapshot_age_seconds` number, nullable
    - `snapshot_stale_after_seconds` integer, nullable
    - `snapshot_status` string, nullable
    - `history_window_basis` string, nullable
    - `total_blocks_last_24h` integer, nullable
    - `field_semantics` object, nullable
    - `semantic_completeness` object, nullable
  - `beta` boolean, required

## Other responses

- `400`: Bad request.
- `402`: Payment required response exposing the live native options for this capability.
- `404`: Resource not found.
- `405`: Method not allowed.
- `422`: Request validation failed.

---

[API](https://skmtc.dev/satoshidata/apis/satoshidata-agent-api.md) · [All operations](https://skmtc.dev/satoshidata/apis/satoshidata-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/satoshidata/apis/satoshidata-agent-api/revisions/9fc9edc41ac4?raw)