Skip to main content
POST
/
set-happy-hour
Promotions
curl --request POST \
  --url https://tokens.shakesco.com/set-happy-hour \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "duration": "<string>",
  "multiplier": 123,
  "cap_amount": 123
}
'
{ "tx_hash": "0xabc..." }

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. Promotions let you boost token earnings for a limited time (happy hours) or prevent excessive accumulation (daily caps). You can also manage these from the dashboard.

​
Happy Hour

​
POST /set-happy-hour

Start a happy-hour multiplier. All token claims during the period are multiplied.
​
duration
string
required
How long the happy hour lasts, in seconds (e.g. "3600" = 1 hour)
​
multiplier
integer
required
Multiplier in basis points. 200 = 2x, 150 = 1.5x. Minimum 100 (1x = no boost).
{ "tx_hash": "0xabc..." }

​
POST /end-happy-hour

End a happy hour early, before its scheduled expiry. No request body required. 
await fetch("https://tokens.shakesco.com/end-happy-hour", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});

{ "tx_hash": "0xabc..." }

​
GET /happy-hour

Check whether a happy hour is currently active. 
const res = await fetch("https://tokens.shakesco.com/happy-hour", {
  headers: { Authorization: `Bearer ${API_KEY}` },
});

{
  "end_time": "1715010000",
  "multiplier": "200",
  "is_active": true
}

​
Daily Cap

​
POST /set-daily-cap

Set the maximum tokens a customer can earn per day. The cap resets on a rolling 24-hour window from each customer’s first claim in that cycle, not at a fixed midnight.
​
cap_amount
number
required
Maximum daily tokens (e.g. 50)
await fetch("https://tokens.shakesco.com/set-daily-cap", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ cap_amount: 50 }),
});

{ "tx_hash": "0xabc..." }

​
POST /remove-daily-cap

Disable the daily cap entirely. No request body required. 
await fetch("https://tokens.shakesco.com/remove-daily-cap", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});

{ "tx_hash": "0xabc..." }

​
GET /daily-cap-settings

Returns the current daily cap configuration. 
{
  "cap": "50000000000000000000",
  "is_active": true
}

​
GET /daily-earnings?email=…

How many tokens a specific customer has earned today, and when the cap resets. 
{
  "earned_today": "12000000000000000000",
  "last_reset_time": "1715000000",
  "cap": "50000000000000000000"
}
Token amounts are in wei (18 decimals). Divide by 10^18 for the human-readable value.