# SolMachina Wallet Scan

> SolMachina Wallet Scan is a paid API for AI agents from api.solmachina.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Profiles a Solana wallet address, returning SOL balance, SPL token holdings, recent activity, and a risk band summary for DeFi intelligence.

## Facts

- Endpoint: GET https://api.solmachina.com/v1/wallet-scan
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solmachina-wallet-scan-2f8069c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_haESzjswAZEI-Q-7WFLaL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability solmachina-wallet-scan-2f8069c9
```

Example prompt: Can you scan the Solana wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM and tell me its SOL balance, how many SPL token accounts it has, and what risk band it falls into?

## When to prefer this

Choose this endpoint when you need a fast, per-call, no-account Solana wallet profile with a trust/risk band and sourced intelligence — especially in agentic workflows where you pay per call via x402 USDC and cannot set up API keys. Prefer this over generic blockchain explorers when you need structured, agent-consumable JSON with a risk assessment rather than raw transaction data.

## Known failure modes

- Invalid Base58 address format returns a validation error
- Wallet address not found on Solana mainnet returns empty or null profile
- Rate limiting or payment failure (x402) blocks the call
- Network latency on Solana RPC may cause slow or timeout responses
- Newly created wallets with no history may return minimal or empty activity fields

## How this service works

Before an AI agent executes on Solana, it asks SolMachina: risk + a decision (EXECUTE/REVIEW/REJECT) + an SMRI score + a signed receipt, paid per call over x402 in USDC. Trust-first — cites every source, says 'unknown' over guessing. No account, no API key.

## Output

Returns a JSON object with the wallet's SOL balance (number), SPL token account count (integer), a risk band label (string), a human-readable profile summary (string), and the count of recent transaction signatures — all with cited sources, no fabricated confidence.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "address": {
   "type": "string",
   "description": "Base58 Solana wallet address to profile."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokens": {
   "type": "object",
   "properties": {
    "splTokenAccounts": {
     "type": "integer"
    }
   }
  },
  "profile": {
   "type": "object",
   "properties": {
    "band": {
     "type": "string"
    },
    "summary": {
     "type": "string"
    }
   }
  },
  "activity": {
   "type": "object",
   "properties": {
    "recentSignatures": {
     "type": "integer"
    }
   }
  },
  "solBalance": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solmachina-wallet-scan-2f8069c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.solmachina.com](https://www.zero.xyz/host/api.solmachina.com/llms.txt)