---
title: "Batch chain intelligence summary"
method: POST
path: "/v1/batch/summary"
tags: ["wallets"]
---

# Batch chain intelligence summary

`POST /v1/batch/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/batch/summary`
- Auth: none declared

Paid batch endpoint returning satoshidata.ai wallet/entity summaries for up to 100 Bitcoin wallets in one call.

## Request body

- BatchAddressRequest
  - `addresses` string[], required

## Response `200`

Batch chain intelligence summary

- WalletBatchSummaryItem[]
  - `kind` 'wallet_summary'
  - `address` string, required
  - `label` object
  - `label_count` integer, nullable
  - `likely_category` string, nullable
  - `likely_entity` string, nullable
  - `confidence` string, nullable
  - `claim_type` string, nullable
  - `source` string, nullable
  - `source_ref` string, nullable
  - `evidence_tier` string, nullable
  - `evidence_types` string[]
  - `unique_contributors` integer, nullable
  - `historical_flags` string[]
  - `has_conflict` boolean, nullable
  - `caveats` string[]
  - `narrative` string, nullable
  - `short_explanation` string, nullable
  - `updated_at` string, nullable
  - `metadata` object
  - `access` PublicAccessProjection
    - `tier` string, nullable
    - `auth_mode` string, nullable
    - `auth_header` string, nullable
    - `authorization_scheme` string, nullable
    - `label` string, nullable
  - `beta` boolean, required

## Other responses

- `400`: Bad request.
- `402`: Payment required for premium chain intelligence endpoints when no valid API key is supplied.
- `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)