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

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

​
Authentication

Tip Stack supports two authentication patterns depending on the endpoint group you are calling: 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

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