> ## Documentation Index
> Fetch the complete documentation index at: https://docs.limitguard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sanctions Wallet

> Free yes/no check of a wallet address against the OFAC SDN list.

The full wallet screen (balances, age and activity, contract and delegation,
risk score with rules and advice, linked entities, ERC-8004 identity and
reputation) is POST /v1/mcp/verify-wallet, priced in ``upgrade``.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/sanctions/wallet
openapi: 3.1.0
info:
  title: Limitguard.ai
  description: >-
    Lead validation API: the company behind each lead checked against the NL and
    BE business registers, EU VAT and sanctions lists, plus company, KYB and
    agent wallet checks for developers and AI agents
  version: 0.1.0
servers:
  - url: https://api.limitguard.ai
security: []
paths:
  /v1/sanctions/wallet:
    post:
      tags:
        - sanctions
      summary: Sanctions Wallet
      description: >-
        Free yes/no check of a wallet address against the OFAC SDN list.


        The full wallet screen (balances, age and activity, contract and
        delegation,

        risk score with rules and advice, linked entities, ERC-8004 identity and

        reputation) is POST /v1/mcp/verify-wallet, priced in ``upgrade``.
      operationId: sanctions_wallet_v1_sanctions_wallet_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WalletSanctionsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletSanctionsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    WalletSanctionsRequest:
      properties:
        wallet_address:
          type: string
          title: Wallet Address
          description: Blockchain wallet address
        chain_id:
          type: string
          title: Chain Id
          description: CAIP-2 chain ID
          default: eip155:8453
      type: object
      required:
        - wallet_address
      title: WalletSanctionsRequest
      description: >-
        POST /v1/sanctions/wallet: the fields, defaults and validation of the
        full

        wallet screen's body (routers/mcp.py VerifyWalletRequest, then

        mcp_server.validation.VerifyWalletInput in the route), so a body moves

        between the two unchanged.
    WalletSanctionsResponse:
      properties:
        wallet_address:
          type: string
          title: Wallet Address
          description: The address in canonical form
        chain_id:
          type: string
          title: Chain Id
          description: CAIP-2 chain ID
        sanctioned:
          type: boolean
          title: Sanctioned
        lists:
          items:
            type: string
          type: array
          title: Lists
          description: '["OFAC SDN"] on a match, else []'
        as_of:
          anyOf:
            - type: string
            - type: 'null'
          title: As Of
          description: Publication date of the list
        status:
          type: string
          enum:
            - ok
            - stale
          title: Status
          description: stale when the loaded list is older than the freshness limit
        source:
          type: string
          title: Source
        upgrade:
          $ref: '#/components/schemas/WalletSanctionsUpgrade'
      type: object
      required:
        - wallet_address
        - chain_id
        - sanctioned
        - lists
        - status
        - source
        - upgrade
      title: WalletSanctionsResponse
      description: >-
        The free wallet sanctions check: yes or no, never a programme or entry
        id.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    WalletSanctionsUpgrade:
      properties:
        path:
          type: string
          title: Path
        tool:
          type: string
          title: Tool
          description: The MCP tool of the full screen
        price_usd:
          type: number
          title: Price Usd
        adds:
          items:
            type: string
          type: array
          title: Adds
          description: What the full screen adds, in plain English
      type: object
      required:
        - path
        - tool
        - price_usd
        - adds
      title: WalletSanctionsUpgrade
      description: The paid full wallet screen the free answer points at.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.