API Reference

Base URLs

Environment	URL
Staging	https://api.stg.spree.finance/api/v1
Health Check	https://api.stg.spree.finance/health
Production	Contact Spree team for access

Route Patterns

The API supports two route patterns:

Pattern	Authentication	Description	Response
/build/*	None	Generate unsigned transactions	Base64 transaction for client signing
/evm/* (GET)	None	Query blockchain state	Chain data

Request Format

All POST/PUT/DELETE requests use this structure:

{
  "input": {
    // Route-specific parameters
  },
  "key": "0xSignerAddress"  // Required - your wallet address for signing
}

Response Formats

Build Routes (Success)

{
  "success": true,
  "transaction": "base64-encoded-unsigned-transaction",
  "message": "Transaction built successfully. Sign and broadcast."
}

Read-Only Routes (Success)

{
  "success": true,
  "data": "query-result",
  "message": "Query executed successfully."
}

Error Response

{
  "success": false,
  "error": "Error description"
}