Skip to main content
The Tip Stack API is a REST API that gives you programmatic access to every feature on the platform — from registering users and recording on-chain tips to triggering payouts and embedding tipping widgets in your own product. All endpoints live under the base URL below and speak JSON in both directions.

​
Base URL

https://tipstack.fun/api

​
Request & Response Format

Every request must set Content-Type: application/json when sending a body. Every response is also JSON. Successful responses always include "success": true; error responses always include an "error" field describing what went wrong. 
{ "error": "Email already in use" }

​
Authentication

Tip Stack supports two authentication patterns depending on the endpoint group you are calling:
PatternUsed for
Session cookieUser-facing endpoints: dashboard, analytics, payouts, profile
Bearer API keySDK / third-party embed endpoints: /sdk/init, /sdk/tip, /sdk/events
See the Authentication guide for full details on registering, logging in, and passing credentials.

​
Rate Limiting

All endpoints are rate-limited to protect the platform. When you exceed the limit, the API returns 429 Too Many Requests with a Retry-After header telling you how many seconds to wait before retrying.
OTP verification endpoints apply a stricter per-email limit of 5 failed attempts within a 15-minute window to prevent brute-force attacks.

​
HTTP Status Codes

CodeMeaning
200 OKThe request succeeded.
400 Bad RequestThe request body is missing required fields or contains invalid values.
401 UnauthorizedNo valid session or API key was provided.
403 ForbiddenYour credentials are valid, but you lack permission for this resource or origin.
404 Not FoundThe requested resource does not exist.
409 ConflictThe resource already exists (for example, duplicate email on registration).
429 Too Many RequestsYou have exceeded the rate limit. Check the Retry-After header.
500 Server ErrorAn unexpected error occurred on the server.

​
API Groups

Authentication

Register, log in, manage sessions, and authenticate via OTP or API key.

Payments

Create payment intents, manage recurring payments, and handle fiat on-ramps.

Tips

Read and record on-chain tips, stream live tip events, and send tip messages.

SDK

Initialize embedded tipping widgets and process tips from third-party origins.