Welcome
The Blacksheep public API — move money between fiat and crypto programmatically.
The Blacksheep API lets you quote, swap, and withdraw between fiat and crypto, manage external bank and wallet destinations, and receive webhook events for state changes.
Where to start
- New to the API? Read Concepts → Overview for the mental model.
- Ready to integrate? Follow Get Started → Authentication to sign your first request.
- Looking for a specific flow? Jump to Guides.
Conventions used in these docs
- Endpoints are described as tRPC paths (e.g.
transaction.initiateSwap). The HTTP request path mirrors that:POST /transaction.initiateSwap. - Request and response bodies are JSON. Success responses wrap the result in
{ "data": ... }; errors return{ "error": { "code", "message" } }. - All requests must be signed — see Authentication.
- Money values are serialized as
{ value, code, decimals }objects; crypto currencies also carry achain.valueis a string-encoded integer in the smallest unit (cents, wei).