> ## 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.

# Set Happy Hour

> Start a time-limited multiplier on all token claims

<span style={{display:"none"}}>For the complete documentation index, see [llms.txt](/llms.txt).</span>

Starts a happy hour that lasts for the given duration. While active, every `/claim-tokens` call multiplies the event's allocation by the multiplier you set. Calling this again overrides any active happy hour.

<Info>
  Treat this as a transaction. After a timeout, check [`/happy-hour`](/api-reference/tokens/promotions/happy-hour) before retrying.
</Info>

### Request Body

<ParamField body="duration" type="string" required>
  How long the happy hour lasts, in seconds (e.g. `"3600"` = 1 hour)
</ParamField>

<ParamField body="multiplier" type="number" required>
  How much to multiply earnings by. `2` = 2x, `1.5` = 1.5x. Minimum `1` (no boost).
</ParamField>

### Response

<ResponseField name="tx_hash" type="string">
  Reference identifier for the happy hour configuration
</ResponseField>

```javascript theme={null}
await fetch("https://tokens.shakesco.com/set-happy-hour", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ duration: "3600", multiplier: 2 }),
});
```

<ResponseExample>
  ```json 200 OK theme={null}
  { "tx_hash": "0xabc..." }
  ```
</ResponseExample>