Connect an AI agent to your account
The satoshis.watch Agent API lets an AI agent work with the saved addresses and Spaces you choose. Give it a read-only key for observation, or a read and write key for changes you request. Each address and Space has its own access setting. API access starts off.
This is account data access for satoshis.watch. For public Bitcoin data without a Watch account, use satoshidata.ai. Neither service holds your bitcoin or signs transactions.
Start with a limited key
- Open your account, then choose the gear and API access. Turn access on and create an API key with the ceiling you need.
- Grant access only to the saved addresses and Spaces the agent should use. Save the key in your agent's secret store; do not put it in a prompt, URL, or Sheet cell.
- Give the agent the API guide or install the skill below. The agent should read the current API contract before acting.
For agent builders
The satoshis.watch Agent API skill is a portable SKILL.md with setup, permission, and safe write guidance. Save it as satoshis-watch-agent-api/SKILL.md in the skill directory supported by your agent runtime. It does not contain an API key or executable code. Installing it does not grant account access; the account owner still controls keys and resource grants.
Use the live Agent API guide and OpenAPI description for exact request and response shapes. For Sheet Spaces, read the Sheet guide. The API base is https://satoshis.watch/api/wallet-plus/agent/v1. The guides and OpenAPI description are public; account operations require an Agent API key.
What an agent can do
Subject to the account owner's key and resource grants, an agent can read saved address cards, Spaces, Sheets, and History; a write-capable agent can make requested changes. The API cannot spend bitcoin or sign transactions. Start with read-only access and grant write access only where you want the agent to edit.