Skip to main content
POST
/
redeem-tokens
Redeem Tokens
curl --request POST \
  --url https://tokens.shakesco.com/redeem-tokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_ref": "<string>",
  "amount": 123
}
'
{ "tx_hash": "0xdef456..." }

Documentation Index

Fetch the complete documentation index at: https://docs.shakesco.com/llms.txt

Use this file to discover all available pages before exploring further.

For the complete documentation index, see llms.txt. Call this when a customer spends tokens in your app. The amount is removed from their available balance and returned to your token’s reserve, ready to be re-awarded to other customers.
Treat this as a transaction. If the response doesn’t arrive, check the customer’s /balance before retrying. Re-running the call deducts twice.

​
Request Body

​
customer_ref
string
required
Your unique identifier for this customer
​
amount
number
required
Number of tokens to redeem. Decimals allowed (1.5).

​
Response

​
tx_hash
string
Reference identifier for this redemption
await fetch("https://tokens.shakesco.com/redeem-tokens", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ customer_ref: "customer-123", amount: 5 }),
});

{ "tx_hash": "0xdef456..." }