API Pro
Whale signals and top traders as an API
The calculations behind Swiftedge Plus as data: every move the top 50 traders make, how it went after 1, 4 and 24 hours, where positions get liquidated, key levels and the plan before each open. JSON over HTTPS and webhooks, for your bot, dashboard, Telegram channel or AI agent.
Plans
Swiftedge Pro
$29 a month
- All endpoints below, as JSON or CSV
- 10,000 calls a day, 60 a minute
- 1 webhook for new whale signals
- Everything in Swiftedge Plus, and 25 scripts on the server
- For your own use
Business
$99 a month
- All endpoints below, as JSON or CSV
- 100,000 calls a day, 600 a minute
- 5 webhooks
- Show the data in your app, channel or newsletter, with a link to swiftedge.uk
Monthly, cancel any time. Secure payment on Stripe. Already on Swiftedge Plus? Upgrade to Pro on your Account page, on the same membership; your Pro key is created there. Need more calls or a custom feed? Write to [email protected].
Endpoints
Send your key as Authorization: Bearer se_live_.... Every endpoint is a GET on
https://swiftedge.uk and returns JSON. Add ?format=csv to whale-signals and top-traders for a CSV file.
| Endpoint | What you get |
|---|---|
/api/pro/v1/whale-signals?market=btc | Every new position or add of $100k+ by the top 50 traders, with the move after 1, 4 and 24 hours and when the trader got out. Plus the hit rate per market and for all markets. limit (max 200) and since (unix time). |
/api/pro/v1/top-traders?period=30d | The top 50 traders over 30 days, 7 days or today: profit, ROI, account value, open profit, long and short dollars and their three largest positions, and what the top 50 hold net per market. |
/api/pro/v1/liquidation-radar | Where positions get liquidated on every market: clusters by distance from price, the nearest whales and the dollars within 1, 2 and 3 %. Beta: field names can still change. |
/api/pro/v1/levels | Key levels on every market: upper wall, flip, lower wall and the risk within 2 %. Beta. |
/api/pro/v1/session-plan?market=gold&session=london | The plan before the Tokyo (asia), London or New York (ny) open: levels now and at the open, clusters, funding and whales. Beta. |
/api/pro/v1/usage | Your plan, calls today, limits and webhooks. |
/api/pro/v1/markets | The markets you can ask for (no key needed). |
Example
curl -H "Authorization: Bearer $SWIFTEDGE_KEY" "https://swiftedge.uk/api/pro/v1/whale-signals?market=btc&limit=1"
{
"market": "btc", "updated": 1794912000, "min_size_usd": 100000,
"signals": [{
"time": 1794911400, "market": "btc",
"trader": {"id": "w7f3a91c2", "name": "Quiet Falcon", "rank": 4, "pnl_usd": 2310000},
"action": "open", "side": "long", "size_usd": 1840000, "price": 64610.0,
"position_after_usd": 1840000, "leverage": 10,
"follow_up": {"1h": {"move_pct": 0.42, "in_favour": true}, "4h": {"due": 1794925800}, "24h": {"due": 1794997800}},
"exit": null
}],
"hit_rate": {"1h": {"in_favour": 41, "checked": 68}, "4h": {...}, "24h": {...}}
}
Webhooks
Register an https address with POST /api/pro/v1/webhooks and the body {"url": "https://..."}. Every new
whale signal is then sent there within about a minute as {"type": "whale_signal", "data": {...}}, in the same format as
above. Each delivery carries X-Swiftedge-Signature, a hex HMAC-SHA256 of the body with the secret you got when you
registered the address. Remove it with DELETE /api/pro/v1/webhooks?id=....
# Python: check that a webhook really comes from Swiftedge
import hmac, hashlib
def from_swiftedge(body: bytes, signature: str, secret: str) -> bool:
mine = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
return hmac.compare_digest(mine, signature) # signature = request.headers["X-Swiftedge-Signature"]
Free API
Order book, candles, large trades, liquidations, funding and key levels stay free without a key in the free API and MCP server.
Common questions
Where does the data come from?
From public on-chain positions and trades on Hyperliquid, computed by Swiftedge: who the top 50 are, what they open and add, how each move went after 1, 4 and 24 hours, and where positions get liquidated. The API sells these calculations, not raw exchange data.
What is the difference between Pro and Business?
Swiftedge Pro is for your own use: your bot, your dashboard, your research. It also includes everything in Swiftedge Plus and 25 scripts on the server. Business is the API only, with ten times the calls, and also lets you show the data to others, for example in your app, a Telegram or Discord channel or a newsletter, with a link to swiftedge.uk.
Can I cancel?
Yes, any time. The key works until the end of the month you paid for.
I lost my key. What now?
Swiftedge Pro: create a new one on your Account page; the old one stops at once. Business: the key was sent to the email you paid with. If you still have it, POST /api/pro/v1/keys/rotate gives you a new one. Otherwise write to [email protected] from that email.
Is there a free version?
Yes. The free API and MCP server at /developers give order book, candles, liquidations, funding and key levels without a key. Whale signals and the top 50 are only in API Pro and Swiftedge Plus.
Is this financial advice?
No. The data describes what traders did and how it went. It is provided as is and does not place orders.