Error Handling

Common Errors

Error	Cause	Solution
amount must be a number	Passing amount as string	Use 1000000 not "1000000"
key is required for build	Missing key in request	Include "key" field with signer address
Invalid chainId	Wrong chain ID format	Use numeric chain ID, not network name
Cannot POST /path (404)	Wrong path	Check /api/v1/build prefix in path

Fee Information

Fee configuration is deployment-specific. Contact your Spree integration manager for current fee rates.

Fee Type	Description
Mint Fee	Fee charged when minting SP tokens (in basis points)
Redeem Fee	Fee charged when redeeming SP tokens (in basis points)

Basis Points Fee Reference

Operation	Basis Points	Percentage
Mint SP from Stablecoins	0	0%
Mint Brand SP from SP	0	0%
Redeem Brand SP to SP	25	0.25%
Redeem SP to Stablecoin	50	0.50%