# Tempo Wallet Snapshot

> Paid HTTP API returning Tempo blockchain wallet stats: TIP-20 stablecoin balances, account type, nonce, and optional 7-day activity. Charges USDC.e via MPP (Machine Payments Protocol).

Base URL: https://tempocheck.xyz
OpenAPI spec: https://tempocheck.xyz/openapi.json

## Endpoints

### GET /api/snapshot — paid ($0.01–$0.02 USDC.e)

Returns a snapshot of any Tempo mainnet wallet.

**Parameters:**
- `address` (required) — checksummed 0x address on Tempo Mainnet (chain ID 4217)
- `deep` (optional) — set to `true` for deep tier ($0.02), includes 7-day activity

**Basic tier ($0.01):** balances of all TIP-20 stablecoins, nonce, account type (EOA/contract), portfolio total USD

**Deep tier ($0.02):** everything in basic + 7-day activity window (tx_sent, unique_recipients, total_spent_usd, stargate bridge stats)

**Payment:** handled automatically by mppx via MPP 402 challenge/response. Currency: USDC.e on Tempo (0x20c000000000000000000000b9537d11c60e8b50).

**Usage:**
```
npx mppx 'https://tempocheck.xyz/api/snapshot?address=0xYOUR_ADDRESS'
npx mppx 'https://tempocheck.xyz/api/snapshot?address=0xYOUR_ADDRESS&deep=true'
```

**Response (basic):**
```json
{
  "address": "0x...",
  "chain": "tempo-mainnet",
  "chain_id": 4217,
  "fetched_at": "2026-05-15T14:32:11Z",
  "cached": false,
  "tier": "basic",
  "account": { "type": "EOA", "nonce": 47, "age_days": null },
  "balances": [
    { "symbol": "USDC.e", "address": "0x20c...", "decimals": 6, "raw": "81200000", "formatted": "81.200", "usd_value": 81.2 }
  ],
  "portfolio": { "total_usd": 81.2, "tokens_held": 1, "tokens_total": 21 }
}
```

### GET /api/tokens — free

Returns the full TIP-20 token registry for Tempo Mainnet. Cached 1 hour.

```
curl 'https://tempocheck.xyz/api/tokens'
```

Returns an array of `{ symbol, name, address, decimals }` objects (21 tokens as of launch).

## Errors

- `400` — invalid address format, no charge
- `402` — MPP payment challenge (mppx handles automatically)
- `503` — RPC unavailable after payment (non-refundable)

## Chain info

- Network: Tempo Mainnet
- Chain ID: 4217
- RPC: https://rpc.tempo.xyz
- Explorer: https://explore.tempo.xyz