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

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. Award tokens to a customer when they complete an event you’ve configured (e.g. signup, purchase, birthday). The event must already exist for your token; configure events via /set-event-details or from the dashboard.
Treat this as a transaction. Wait for the 200 OK before telling the customer. If you don’t get a response, query /has-claimed-event before retrying to avoid double-crediting.

​
Request Body

​
event_name
string
required
The event identifier (must match an event configured on your token)
​
customer_ref
string
required
Your unique identifier for this customer

​
Response

​
tx_hash
string
A reference identifier for this credit. Store it for your audit trail.
await fetch("https://tokens.shakesco.com/claim-tokens", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ event_name: "signup", customer_ref: "customer-123" }),
});

{ "tx_hash": "0xabc123..." }