API Introduction

The Droplit API provides programmatic control of droplit wallets for app and agent workflows.

Base URL

Use your configured Droplit API URL, for example:

https://dev-go-faucet-api-mazi.encr.app

Authentication

All endpoints require signed X-Auth-Token headers. See Authentication for request-signing details.

Core endpoint groups

Management

• GET /admin/faucets - list droplits for the authenticated owner
• POST /faucets - create a new droplit
• GET /faucet/:name/status - fetch droplit balance and state
• POST /faucet/:name/activity - fetch activity history

Wallet operations

• POST /faucet/:name/tap - send sats to a recipient
• POST /faucet/:name/fund - fund a transaction template
• POST /faucet/:name/push - push OP_RETURN data
• POST /faucet/:name/mint - mint inscriptions

Paymail deposits

Each droplit can receive BSV at <name>@droplit.dev. Paymail deposits are reported as deposit activity and appear in the dashboard as soon as the backend streams the event.

Access control

• GET /faucet/:name/api-keys - list allowlisted public keys
• POST /faucet/:name/api-keys - add an allowlisted key
• DELETE /faucet/:name/api-keys/:pubkey - remove an allowlisted key

Realtime activity

• GET /faucet/:name/activity-stream - subscribe to SSE activity events

Next steps

• Permission Model
• SSE Activity Stream
• Agent Playbooks