⚡ botlord / Public API

⚡ Public API

The data behind the botlord tools is free and open — no API key, no signup, CORS enabled so you can call it straight from a browser. Build your own leaderboards, badges or dashboards on top of the Hive tipping fleet. If you ship something with it, tell @borniet — always curious.

Base URL: https://tipping.botlord.eu · all responses are JSON (except the PNG) · please cache: most data changes every few minutes at most. Be gentle — this runs on one small server.

🏆 Tips & leaderboards

GET/api/tips/leaderboard?days=7&limit=20

Top tip recipients across the whole fleet — which accounts received the most distinct tip tokens.

GET/api/tips/received/<username>?limit=15

Who recently tipped this account, with the token and the post it happened on, plus their top tippers.

GET/api/tips/recap/<username>

Lifetime recap for one account: tips sent/received, favourite recipient, top tipper, current streak and earned badges.

GET/api/tips/between?a=<account>&b=<account>

Every fleet tip that passed between two accounts, in both directions.

🖼️ Embeddable image

GET/board/leaderboard.png?token=ALIVE&days=7&kind=tippers

A ready-made "top tippers" leaderboard image for your own weekly post — one line of markdown, no code. kind=tippers|recipients. Builder with copy-paste markdown: /embed/leaderboard.

[![Top ALIVE tippers](https://tipping.botlord.eu/board/leaderboard.png?token=ALIVE&days=7)](https://tipping.botlord.eu)
GET/board/health.png?u=<account>

A shareable "Hive health report" image for one account — reputation, HP, 100% vote value, witness votes, tips, savings and blacklist standing in one 1200×630 PNG.

![@borniet health](https://tipping.botlord.eu/board/health.png?u=borniet)

🎟️ Tokens & tiers

GET/api/tips/config

Every tip token the fleet supports: bot account, token symbol and the community tokens tracked alongside them.

GET/sync/stock?user=<username>

Which tip commands an account can use right now and how many tips it has left today, per token — including external (community) tiers.

try it ↗ (served from reply.botlord.eu)

🛡️ Safety

GET/api/tips/officialbl?account=<username>

Is this account on the official Hivewatchers/Spaminator blacklist? Returns a plain boolean plus the list size — the full list is fetched and cached server-side so you don't have to.

GET/api/tips/faults?account=<username>

Tip attempts the fleet skipped for this account today, grouped by reason (cooldown, daily limit, eligibility).

📡 Fleet status

GET/api/tips/pulse

How many tipping bots are up and when the fleet last sent a tip. Handy for a status badge.

Example

// who tipped @borniet lately?
const r = await fetch('https://tipping.botlord.eu/api/tips/received/borniet?limit=5');
const d = await r.json();
d.recent.forEach(t => console.log(`@${t.who} sent !${t.token}`));
⚠️ These endpoints describe the botlord fleet's own bookkeeping — they are a convenience layer, not consensus data. For anything authoritative, read the Hive blockchain (or Hive-Engine) directly. Endpoints may change; nothing here requires a key, so nothing breaks silently for you if it does.
Part of the ⚡ botlord tools · free & open · vote @botlord for witness 🗳️