Developer API_
Query public Safe owner policies, transaction nonces and ETH balances on Ethereum and Sepolia. No wallet connection required for read-only lookups.
GET /api/v1/status
Returns supported networks, available features, and the official Safe factory address.
curl https://bunkersafe.lat/api/v1/status
GET /api/v1/safe
Retrieve an on-chain Safe's owner addresses, signing threshold, nonce, and ETH balance. Supply both query parameters shown below.
| Parameter | Required | Example |
|---|---|---|
| chainId | Yes | 11155111 (Sepolia) or 1 (Ethereum) |
| address | Yes | 0x-prefixed deployed Safe address |
curl "https://bunkersafe.lat/api/v1/safe?chainId=11155111&address=0xd934BfE6A33Ec862bed9830C8cF09DB404a6D9DD"
Read the response.
| Field | Meaning |
|---|---|
| owners | Array of on-chain Safe owner addresses |
| threshold | Signatures required for execution |
| nonce | Current Safe transaction sequence |
| balanceWei | Exact ETH balance in wei as a string |
| balanceEth | Human-readable ETH balance, excluding tokens |
| transactionMode | Sepolia testnet or mainnet watch-only |
These are blockchain reads. They do not include ERC-20/NFT balances or externally indexed Safe transaction history.
Handle failures gracefully.
Invalid chain ID or address
No deployed contract at the address
Contract does not expose valid Safe owner policy
Up to 60 public lookups per minute per IP
Ethereum RPC upstream unavailable
Responses are JSON. Public Safe lookups include a short 5-second cache hint. Recheck on-chain state before decisions about signatures and asset transfers.
Read-only does not mean custodial.
BunkerSAFE has an internal transaction coordination endpoint at /api/coordination; it is not a stable public API and shows only proposals recorded by this installation. The public v1 API intentionally exposes no write methods. Do not send signing secrets to APIs.
To connect a wallet and propose testnet multisig transfers, use the web app. For a conceptual overview, start with the interactive brain map.