API Introduction

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

Base URL

Use your configured Droplit API URL:

https://api.droplit.dev

Authentication

Every protected endpoint uses BRC-103/104 mutual authentication. See Authentication for SDK client 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 - upgrade to an authenticated WebSocket

Next steps

• Permission Model
• WebSocket Activity Stream
• Agent Playbooks