satoshidata-ai · Schema
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.
BitcoinAPIAIFinanceChain-IntelligenceCompany
Properties
| Name | Type | Description |
|---|---|---|
| address | string | |
| label | object | Asserted-only label block. Null category/value can still have a contextual lead in likely_entity. |
| kind | string | |
| claim_type | object | |
| evidence_tier | object | |
| confidence_tier | object | Public provenance authority for verified, attributed, clustered, or reported treatment. |
| tier | object | Compatibility alias of confidence_tier. |
| is_verified_identity | object | True only when confidence_tier is verified; false for attributed, clustered, imported, or reported leads. |
| attribution | object | |
| evidence_types | array | |
| source | object | |
| source_ref | object | |
| narrative | object | |
| updated_at | object | |
| consensus | object | |
| historical_flags | array | |
| risk_indicator | object | |
| confidence | object | |
| explanation | object | |
| likely_category | object | |
| likely_entity | object | |
| likely_label | object | |
| label_count | object | |
| unique_contributors | object | |
| has_conflict | object | |
| short_explanation | object | |
| caveats | array | |
| metadata | object | |
| external_mirrors | array | |
| cluster_recency | object | |
| examined | object | |
| examined_at | object | |
| examined_source | object | |
| note | object | |
| inferred_label | object | |
| next_steps | object | |
| access | object | |
| _meta | object | |
| beta | boolean |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/satoshidata-ai/json-schema/satoshidata-ai-wallet-summary-response-schema.json",
"title": "WalletSummaryResponse",
"description": "Premium wallet summary.\n\nThe label block is asserted-only. When label.category or label.value is null,\nconsumers should read likely_entity and short_explanation for the hedged lead.",
"x-generated": "2026-10-30",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/satoshidata-ai-openapi.json#/components/schemas/WalletSummaryResponse",
"additionalProperties": false,
"properties": {
"address": {
"title": "Address",
"type": "string"
},
"label": {
"$ref": "#/$defs/WalletLabelProjection",
"description": "Asserted-only label block. Null category/value can still have a contextual lead in likely_entity."
},
"kind": {
"const": "wallet_summary",
"default": "wallet_summary",
"title": "Kind",
"type": "string"
},
"claim_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Claim Type"
},
"evidence_tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Evidence Tier"
},
"confidence_tier": {
"anyOf": [
{
"enum": [
"verified",
"attributed",
"clustered",
"reported"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public provenance authority for verified, attributed, clustered, or reported treatment.",
"title": "Confidence Tier"
},
"tier": {
"anyOf": [
{
"enum": [
"verified",
"attributed",
"clustered",
"reported"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Compatibility alias of confidence_tier.",
"title": "Tier"
},
"is_verified_identity": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True only when confidence_tier is verified; false for attributed, clustered, imported, or reported leads.",
"title": "Is Verified Identity"
},
"attribution": {
"anyOf": [
{
"$ref": "#/$defs/WalletAttributionProjection"
},
{
"type": "null"
}
],
"default": null
},
"evidence_types": {
"items": {
"type": "string"
},
"title": "Evidence Types",
"type": "array"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source"
},
"source_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Ref"
},
"narrative": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Narrative"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated At"
},
"consensus": {
"anyOf": [
{
"$ref": "#/$defs/WalletConsensusProjection"
},
{
"type": "null"
}
],
"default": null
},
"historical_flags": {
"items": {
"type": "string"
},
"title": "Historical Flags",
"type": "array"
},
"risk_indicator": {
"anyOf": [
{
"enum": [
"unknown",
"neutral",
"elevated"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Risk Indicator"
},
"confidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Confidence"
},
"explanation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Explanation"
},
"likely_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Likely Category"
},
"likely_entity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Likely Entity"
},
"likely_label": {
"anyOf": [
{
"$ref": "#/$defs/WalletTrustSafetyLikelyLabel"
},
{
"type": "null"
}
],
"default": null
},
"label_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Label Count"
},
"unique_contributors": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Unique Contributors"
},
"has_conflict": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Has Conflict"
},
"short_explanation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Short Explanation"
},
"caveats": {
"items": {
"type": "string"
},
"title": "Caveats",
"type": "array"
},
"metadata": {
"additionalProperties": true,
"title": "Metadata",
"type": "object"
},
"external_mirrors": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "External Mirrors",
"type": "array"
},
"cluster_recency": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Cluster Recency"
},
"examined": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Examined"
},
"examined_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Examined At"
},
"examined_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Examined Source"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
},
"inferred_label": {
"anyOf": [
{
"$ref": "#/$defs/WalletLabelProjection"
},
{
"type": "null"
}
],
"default": null
},
"next_steps": {
"anyOf": [
{
"$ref": "#/$defs/WalletNoLabelNextSteps"
},
{
"type": "null"
}
],
"default": null
},
"access": {
"$ref": "#/$defs/PublicAccessProjection"
},
"_meta": {
"$ref": "#/$defs/ResponseMeta"
},
"beta": {
"title": "Beta",
"type": "boolean"
}
},
"required": [
"address",
"label",
"_meta",
"beta"
],
"type": "object",
"$defs": {
"PublicAccessProjection": {
"additionalProperties": false,
"properties": {
"tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Tier"
},
"auth_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Auth Mode"
},
"auth_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Auth Header"
},
"authorization_scheme": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Authorization Scheme"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Label"
}
},
"title": "PublicAccessProjection",
"type": "object"
},
"ResponseMeta": {
"additionalProperties": false,
"properties": {
"endpoint": {
"title": "Endpoint",
"type": "string"
},
"freshness": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Freshness"
},
"freshness_semantics": {
"anyOf": [
{
"enum": [
"internal_refresh",
"source_poll",
"claim_made"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Freshness Semantics"
},
"source": {
"title": "Source",
"type": "string"
},
"price_sats": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Sats"
},
"price_usd": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"docs": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Docs"
},
"warnings": {
"items": {
"$ref": "#/$defs/ResponseWarning"
},
"title": "Warnings",
"type": "array"
},
"pagination": {
"anyOf": [
{
"$ref": "#/$defs/ResponsePagination"
},
{
"type": "null"
}
],
"default": null
},
"view": {
"anyOf": [
{
"const": "compact",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "View"
},
"bitcoin_backend": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Bitcoin Backend"
},
"beta": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Beta"
},
"cache_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Cache Seconds"
},
"cache_ttl_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Cache Ttl Seconds"
},
"cache_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cache Status"
},
"cache_age_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Cache Age Seconds"
},
"cache_cached_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cache Cached At"
},
"cached": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Cached"
},
"cache_policy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cache Policy"
},
"compute_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Compute Ms"
},
"warning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Warning"
},
"refresh_warning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Refresh Warning"
},
"last_refresh_started_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Refresh Started At"
},
"last_refresh_completed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Refresh Completed At"
},
"last_refresh_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Refresh Status"
},
"last_refresh_error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Refresh Error"
},
"last_refresh_duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Refresh Duration Ms"
},
"feature_flag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Feature Flag"
},
"rollout_state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rollout State"
},
"schema_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Schema Version"
},
"methodology_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Methodology Version"
},
"materialized_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Materialized Source"
},
"max_hops": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Max Hops"
},
"retention": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Retention"
},
"not_compliance_advice": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Not Compliance Advice"
},
"future_native_price_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Future Native Price Mode"
},
"future_native_price_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Future Native Price Note"
},
"future_native_quote_endpoint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Future Native Quote Endpoint"
},
"overview_activity_cache": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Overview Activity Cache"
},
"attribution_confidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Attribution Confidence"
},
"generated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Generated At"
},
"last_computed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Computed"
},
"snapshot_generated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot Generated At"
},
"snapshot_age_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot Age Seconds"
},
"snapshot_stale_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot Stale After Seconds"
},
"snapshot_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Snapshot Status"
},
"history_window_basis": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "History Window Basis"
},
"total_blocks_last_24h": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Total Blocks Last 24H"
},
"field_semantics": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Field Semantics"
},
"semantic_completeness": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Semantic Completeness"
}
},
"required": [
"endpoint",
"source"
],
"title": "ResponseMeta",
"type": "object"
},
"ResponsePagination": {
"additionalProperties": false,
"properties": {
"offset": {
"title": "Offset",
"type": "integer"
},
"limit": {
"title": "Limit",
"type": "integer"
},
"total_alerts": {
"title": "Total Alerts",
"type": "integer"
},
"next_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Next Offset"
},
"has_more": {
"title": "Has More",
"type": "boolean"
}
},
"required": [
"offset",
"limit",
"total_alerts",
"next_offset",
"has_more"
],
"title": "ResponsePagination",
"type": "object"
},
"ResponseWarning": {
"additionalProperties": false,
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"message": {
"title": "Message",
"type": "string"
}
},
"required": [
"code",
"message"
],
"title": "ResponseWarning",
"type": "object"
},
"WalletAttributionProjection": {
"additionalProperties": false,
"properties": {
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source"
},
"source_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Ref"
},
"claim_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Claim Type"
},
"independently_verified": {
"const": false,
"default": false,
"title": "Independently Verified",
"type": "boolean"
},
"basis": {
"const": "single_source_third_party",
"default": "single_source_third_party",
"title": "Basis",
"type": "string"
},
"attribution_grain": {
"enum": [
"entity",
"category"
],
"title": "Attribution Grain",
"type": "string"
},
"note": {
"title": "Note",
"type": "string"
}
},
"required": [
"attribution_grain",
"note"
],
"title": "WalletAttributionProjection",
"type": "object"
},
"WalletConsensusProjection": {
"additionalProperties": false,
"properties": {
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Agreement state for the public wallet label signal.",
"title": "State"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable agreement label for the state.",
"title": "Label"
},
"contributor_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Distinct public sources behind the label signal.",
"title": "Contributor Count"
},
"label_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total public reports behind the label signal.",
"title": "Label Count"
},
"has_conflict": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when public labels conflict.",
"title": "Has Conflict"
}
},
"title": "WalletConsensusProjection",
"type": "object"
},
"WalletLabelProjection": {
"additionalProperties": false,
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "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.",
"title": "Category"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "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.",
"title": "Value"
},
"hint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "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.",
"title": "Hint"
},
"confidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Confidence"
},
"confidence_tier": {
"anyOf": [
{
"enum": [
"verified",
"attributed",
"clustered",
"reported"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public provenance tier for this label source family.",
"title": "Confidence Tier"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source"
},
"source_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Ref"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Legacy label alias emitted by wallet projections; null when the asserted value is disputed.",
"title": "Label"
},
"value_disputed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Value Disputed"
},
"category_disputed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Category Disputed"
}
},
"title": "WalletLabelProjection",
"type": "object"
},
"WalletNoLabelContribute": {
"additionalProperties": false,
"properties": {
"endpoint": {
"title": "Endpoint",
"type": "string"
},
"method": {
"const": "POST",
"default": "POST",
"title": "Method",
"type": "string"
},
"cost": {
"const": "free",
"default": "free",
"title": "Cost",
"type": "string"
},
"purpose": {
"title": "Purpose",
"type": "string"
}
},
"required": [
"endpoint",
"purpose"
],
"title": "WalletNoLabelContribute",
"type": "object"
},
"WalletNoLabelNextSteps": {
"additionalProperties": false,
"properties": {
"premium_adds_data": {
"description": "True when premium wallet endpoints are expected to provide additional label-source data for this address.",
"title": "Premium Adds Data",
"type": "boolean"
},
"premium_note": {
"description": "Short guidance explaining whether premium adds additional label-source data for this address.",
"title": "Premium Note",
"type": "string"
},
"contribute": {
"$ref": "#/$defs/WalletNoLabelContribute"
}
},
"required": [
"premium_adds_data",
"premium_note",
"contribute"
],
"title": "WalletNoLabelNextSteps",
"type": "object"
},
"WalletTrustSafetyLikelyLabel": {
"additionalProperties": false,
"properties": {
"category": {
"anyOf": [
{
"type": "string"
# --- truncated at 32 KB (37 KB total) ---
# Full source: https://artifacts.apis.io/satoshidata-ai/json-schema/satoshidata-ai-wallet-summary-response-schema.json
Work with this as data
Every JSON Schema 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 schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/satoshidata-ai-wallet-summary-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.