API reference · Cash Payback

Get the rules

GEThttps://payday.direct/api/v1/payback

Whether Cash Payback is on, its split, when rounds run, how holding is weighted, and what a terminal needs to read and launch baskets without hardcoding them.

Needs an API key in Authorization: Bearer or X-API-Key. Authentication

Responses

200OK

401Missing or invalid key

429Over the limit. Retry-After says when to try again.

curl "https://payday.direct/api/v1/payback" \
  -H "Authorization: Bearer pd_YOUR_KEY"

const res = await fetch("https://payday.direct/api/v1/payback", {
  headers: { Authorization: "Bearer " + process.env.PAYDAY_KEY },
});
const json = await res.json();
if (!res.ok) throw new Error(json.error?.code);
console.log(json);

import os, requests

r = requests.get(
    "https://payday.direct/api/v1/payback",
    headers={"Authorization": "Bearer " + os.environ["PAYDAY_KEY"]},
)
r.raise_for_status()
print(r.json())

Response 200

{
  "data": {
    "enabled": true,
    "rules": {
      "mode": "cash_payback",
      "name": "Cash Payback",
      "split": {
        "burn_pct": 10,
        "treasury_pct": 5,
        "dex_pct": 70,
        "holders_pct": 15,
        "holders_after_dex_pct": 85
      },
      "dex_cost_usdc": 299,
      "return_days": 7,
      "rounds": {
        "round_usd": 50,
        "daily_usd": 5,
        "min_gap_min": 15
      }
    },
    "baskets": {
      "open": true,
      "types": [
        "payout",
        "fund"
      ],
      "min_assets": 1,
      "max_assets": 15,
      "suggested_assets": [
        3,
        5
      ],
      "locked_at_launch": true
    }
  },
  "meta": {
    "updated_at": "2026-11-15T20:03:20.991Z",
    "api_version": "v1"
  }
}

Try itSends a real request from your browser with your key.

API key

Your key stays in this tab only.