---
title: "OFAC sanctions coverage"
method: GET
path: "/v1/sanctions/ofac/coverage"
tags: ["sanctions"]
---

# OFAC sanctions coverage

`GET /v1/sanctions/ofac/coverage`

## Request

- Base URL: `https://satoshidata.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://satoshidata.ai/v1/sanctions/ofac/coverage`
- Auth: none declared

Free lead-gen endpoint summarizing satoshidata.ai's current verified OFAC address coverage. Sanctions-exposure scoring and path search remain separate premium surfaces.

## Response `200`

OFAC coverage counts, top entities by covered address count, and premium endpoint roadmap.

- SanctionsOfacCoverageV1SanctionsOfacCoverageGet200Response: OFAC coverage counts, top entities by covered address count, and premium endpoint roadmap. This component documents the stable satoshidata.ai JSON response envelope for this operation; endpoint-specific dynamic sections may include additional properties.
  - `_meta` ResponseMetaDetail: Machine-readable metadata added by satoshidata.ai JSON responses.
    - `endpoint` string: Canonical request path.
    - `freshness` string: Best-known freshness timestamp for the payload.
    - `freshness_semantics` 'internal_refresh' | 'source_poll' | 'claim_made': Meaning of _meta.freshness for this response: internal_refresh, source_poll, or claim_made.
    - `source` string: Primary data source for the response.
    - `price_sats` integer: Native BTC-denominated price for this response, when applicable.
    - `docs` string: OpenAPI documentation URL.
    - `warnings` ResponseWarning[]: Non-fatal response warnings. Empty when no caveat applies.
      - `code` string, required
      - `message` string, required
    - `pagination` object: Pagination metadata when an endpoint supports paged archive traversal.
      - `offset` integer, required
      - `limit` integer, required
      - `total_alerts` integer, required
      - `next_offset` integer, nullable, required
      - `has_more` boolean, required
    - `field_semantics` object: Machine-readable notes explaining field-level semantics for the payload.
    - `semantic_completeness` object: Machine-readable completeness caveats for fields that can be partial or derived.
    - `price_usd` string: USD-denominated x402 price when a per-call grant was used.
    - `view` 'compact': Response projection view, currently compact.
    - `bitcoin_backend` string: Public label for the Bitcoin backend used by the response.
    - `beta` boolean: Endpoint-specific beta flag when carried inside _meta.
    - `cache_seconds` integer: Advertised response cache lifetime in seconds.
    - `cache_ttl_seconds` integer: Advertised response cache TTL in seconds.
    - `cache_status` string: Cache hit/miss/fresh/stale status for cached projections.
    - `cache_age_seconds` number: Age in seconds for the cached projection served.
    - `cache_cached_at` string: Timestamp when the served projection was cached.
    - `cached` boolean: True when this response body came from a cache.
    - `cache_policy` string: Stable cache policy label for the response.
    - `compute_ms` integer: Server-side compute time in milliseconds.
    - `warning` string: Single human-readable response warning when a legacy slot is used.
    - `refresh_warning` string: Warning about background refresh state for cached dashboard data.
    - `last_refresh_started_at` string: Timestamp for the last background refresh start.
    - `last_refresh_completed_at` string: Timestamp for the last background refresh completion.
    - `last_refresh_status` string: Status of the last background refresh.
    - `last_refresh_error` string: Last background refresh error, when present.
    - `last_refresh_duration_ms` integer: Last background refresh duration in milliseconds.
    - `feature_flag` string: Runtime feature flag associated with an experimental endpoint.
    - `rollout_state` string: Rollout state for hidden or beta backend features.
    - `schema_version` string, nullable: Endpoint-specific payload schema version, when declared.
    - `retention` string: Retention policy label for ephemeral response artifacts.
    - `not_compliance_advice` boolean: True when the response is explicitly not compliance advice.
    - `future_native_price_mode` string: Future native-pricing mode for endpoints with dynamic fees.
    - `future_native_price_note` string: Human-readable note for future native-pricing mode.
    - `future_native_quote_endpoint` string: Endpoint that quotes a future dynamic native price.
    - `overview_activity_cache` object: Metadata for wallet overview directional-activity cache reuse.
    - `attribution_confidence` string: Attribution confidence label for pool-intel metadata.
    - `generated_at` string: Timestamp when the source projection was generated.
    - `last_computed` string: Timestamp when the source projection was last computed.
    - `snapshot_generated_at` string: Timestamp embedded in the served persistent snapshot.
    - `snapshot_age_seconds` number: Age in seconds for the served persistent snapshot.
    - `snapshot_stale_after_seconds` integer: Staleness threshold in seconds for the served persistent snapshot.
    - `snapshot_status` string: Freshness status for the served persistent snapshot.
    - `history_window_basis` string: History-window basis used by pool-intel projections.
    - `history_window_start_height` integer: Earliest block height covered by the pool-intel history window.
    - `first_block_mined_coverage` string: Whether first_block_mined is full-history or partial-window constrained.
    - `first_block_mined_note` string: Coverage caveat for first_block_mined when history is partial.
    - `total_blocks_last_24h` integer: Pool-intel total block count in the current 24h window.
  - `beta` boolean: True when the public beta envelope is active.

## Other responses

- `400`: Bad request.
- `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)