1
Create your free owner account
Your owner key controls agent creation and policy changes. Save the key shown once after registration.
Create Free Account2
Create one agent wallet
Open the dashboard, choose Create Agent, and save the scoped agent key. The Free plan permits one active agent wallet.
Open Dashboard3
Set a policy—still with no funds
Open the agent, enable Spending Policy, and set a maximum per transaction. For a simple test, use 1,000 sats.
4
Run authenticated allow/block checks
Replace the placeholders with your agent ID and scoped key. The first request should pass; the second should block.
curl -H "X-API-Key: YOUR_AGENT_KEY" \
"https://agenticbtc.io/api/v1/agents/YOUR_AGENT_ID/spending-check?amount_sats=500"
curl -H "X-API-Key: YOUR_AGENT_KEY" \
"https://agenticbtc.io/api/v1/agents/YOUR_AGENT_ID/spending-check?amount_sats=5000"