API Reference

Smart Money API

ඔබේ වෙළඳ බොට් සඳහා ව්‍යුත්පන්න දත්ත, ඔන්චේන් මෙට්‍රික්ස් සහ වේල් බඩුපොළ ක්‍රියාකාරකම් එක් විශ්වාස ලකුණුවකට ඒකාබද්ධ කරන වෘත්තීය ශ්‍රේණියේ බුද්ධිමත් API එකකි.

වත්මන් API අනුවාදය: v1. Base URL: https://api.smartmoneyapi.com/v1

සැලසුම් මූලධර්ම

සෑම අන්ත ලක්ෂ්‍යයක් සහ සෑම ලකුණුවක්ම පාලනය කරන සිතුවිලි හතරකි. ඒවා ද එය කරන දේ සහ නොකරන දේ පිළිබඳ සාධාරණ සීමාවන් වේ.

මූලික වශයෙන් උපාය, සංඥා නොවේ. මෙය මිලදී ගැනීම/විකිණීමේ සංඥා පෝෂකයක් නොවේ. ඔබ උපාය සහ ඇතුල්වීම ගෙන එනවා; API ඔබට කියන්නේ අවට වෙළඳපොළ ව්‍යුහය — ව්‍යුත්පන්න ස්ථානගත කිරීම්, අරමුදල්, විවෘත උනන්දුව, ද්‍රවීකරණ, ඔන්චේන් ප්‍රවාහය සහ වේල් සම්මතය — ඔබ දැනටමත් ගැනීමට අවශ්‍ය වෙළඳපොළ සමඟ එකඟ වේද යන්නයි.

විශ්වාසය-ලකුණු කළ, ද්විමය පුරෝකථනය නොවේ. සෑම පිළිතුරක්ම අංශක කර ඇත confidence (HIGH / MEDIUM / LOW) සහ composite -1.0 සිට +1.0 දක්වා. එහි වගකීම් නැත සහ ඔරකල් ඇමතුම් නැත — ඔබට එකඟතාවය පිළිබඳ කැලිබ්‍රේට් කළ කියවීමක් ලැබේ, එයට හේතු සමඟ, එබැවින් ඔබට විශ්වාසයට අනුව ප්‍රමාණය තීරණය කළ හැකිය.

තීරණ සහාය, ක්‍රියාත්මක කිරීමේ උපදෙස් නොවේ. API එක CONFIRM / REDUCE / SKIP නිර්දේශයක් සහ ප්‍රමාණ ගුණකයක් ආපසු ලබා දෙයි ඔබේ තර්කය ක්‍රියාත්මක කිරීමට. එය කිසිවිටෙක ඇණවුම් තබන්නේ නැත, සහ මෙහි කිසිවක් මූල්‍ය උපදෙස් නොවේ. ඔබ අවදානම්, ප්‍රමාණය සහ ක්‍රියාත්මක කිරීම සඳහා වගකිව යුතුය.

සජීවී මෙට්‍රික්ස්, ස්ථාවර වගකීම් නොවේ. ජය අනුපාත, රජයේ සංඛ්‍යාලේඛන සහ නිරවද්‍යතා අංක රෝලින් සාම්පලයකින් ගණනය කරනු ලබන අතර වෙළඳපොළ චලනය වන විට ඒවා චලනය වේ. අපි ඒවා සාධාරණව ප්‍රකාශයට පත් කරමු, ඒවා මධ්‍යස්ථ වූ විට පවා. සෑම මෙට්‍රික් එකක්ම වර්තමාන නිරීක්ෂණයක් ලෙස සලකන්න, අනාගතය පිළිබඳ පොරොන්දුවක් නොවේ.

මෙම API එක කාටද?

මෙම API එක ඉදිකර ඇත්තේ ක්‍රිප්ටෝ බොට්, ඇල්ගො, සහ AI-ඒජන්ට් සංවර්ධකයින් දැනටමත් දිගු/කෙටි සංඥාවක් ඇති — TA උපාය, ML මාදිලිය, Freqtrade පයිප්ලයින්, TradingView ඇලර්ට්, හෝ LLM ඒජන්ට් — සහ ප්‍රාග්ධනය යොදවීමට පෙර ඉක්මන්, පූර්ව-වෙළඳ CONFIRM / REDUCE / SKIP තීරණයක් අවශ්‍යයි.

සාමාන්‍ය ලූපයක්: ඔබේ උපාය ගිනි ගන්වයි "BTC දිගුවට යන්න" → ඔබ කතා කරන්න GET /v1/confirm?symbol=BTC&direction=long → ඔබ ඇතුල්වීම තහවුරු කරන්න, අඩු කරන්න, හෝ මඟ හරින්න සහ ප්‍රමාණය අනුව පරිමාණය කරන්න size_mult. එක් ඇමතුමක්, තනි අඩු-ප්‍රමාද JSON ප්‍රතිචාරයක්, අමතර යටිතල පහසුකම් නැත.

එය නොවේ ස්වාධීන සංඥා උත්පාදකයක්, චාටින්ග් නිෂ්පාදනයක්, හෝ ක්‍රියාත්මක කිරීමේ ස්ථානයක්. ඔබට ගේට් කිරීමට සංඥාවක් නැතිනම්, ආරම්භ කරන්න performance page ලයිව් බොට් එකකට එය වයර් කිරීමට පෙර ලකුණුව කෙසේ හැසිරුණාදැයි බැලීමට.

ප්‍රවේශය ලබා ගැනීම

1 — ලියාපදිංචි වන්න. නොමිලේ ගිණුමක් සාදන්න signup (ඊමේල්/මුරපදය හෝ Google). නොමිලේ තට්ටුව සඳහා ක්‍රෙඩිට් කාඩ්පතක් අවශ්‍ය නැත.

2 — ඔබේ ඩෑෂ්බෝර්ඩ් අරින්න. ඔබේ ඩෑෂ්බෝර්ඩ් ඔබේ API යතුර, වත්මන් සැලැස්ම සහ දිනකර ලකුණුවට එරෙහිව ලයිව් භාවිතය පෙන්වයි.

3 — ඔබේ API යතුර පිටපත් කරන්න. යතුරු පෙරපද කර ඇත sm_. එය ලෙස යවන්න X-API-Key header on every request (see සත්‍යාපනය). Upgrade any time on the මිල නියමය පිටුව සීමා ඉහළ නංවා තවත් සංකේත සහ අන්ත ලක්ෂ්‍ය අගුළු ඇරීමට.

Spec, SDK & Cookbook

ඔබ කේතය ඔබම ලියනවා නම් හෝ කේතන ඒජන්ට් එකකට භාර දෙනවා නම්, ඉක්මනින් ඒකාබද්ධ කර ගැනීමට ඔබට අවශ්‍ය සියල්ල.

සම්පත්	එය කුමක්ද
Cookbook	බහුලව භාවිතා වන ඒකාබද්ධ කිරීම් සඳහා පිටපත් කර ඇලවිය හැකි වට්ටෝරු — ඇතුළු වීමට පෙර තහවුරු කරන්න, Freqtrade සංඥාවක් අගුළු දමන්න, ගුණකය අනුව ප්‍රමාණය කරන්න, 402/429 හසුරුවන්න, සහ එය කේතන ඒජන්ට් එකකට සම්බන්ධ කරන්න.
OpenAPI spec	සෑම අන්ත ලක්ෂ්‍යයකම යන්ත්‍ර-කියවිය හැකි OpenAPI අර්ථ දැක්වීම. Postman/Insomnia වෙත ආයාත කරන්න, ක්ලයන්ට් ජනනය කරන්න, හෝ LLM එකකට ඇතුළු කරන්න. At `github.com/tashiardit/smartmoneyapi-docs`.
Python client	නිල Python ක්ලයන්ට් පුස්තකාලය at `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	API හි LLM-හිතෛෂී සරල-පෙළ සාරාංශයක්. Claude, Codex, හෝ Cursor එය වෙත යොමු කරන්න (බලන්න Coding Agents).

මිනිත්තු 2න් ඉක්මන් ආරම්භය

පියවර 1 — පාදක URL. සෑම අන්ත ලක්ෂ්‍යයක්ම පවතින්නේ:

පාදක URL
https://api.smartmoneyapi.com

පියවර 2 — ඔබගේ API යතුර ලබා ගන්න. නොමිලේ ලියාපදිංචි වන්න (ක්‍රෙඩිට් කාඩ්පතක් අවශ්‍ය නැත) සහ ඔබගේ යතුර පිටපත් කරන්න උපකරණ පුවරුවසිට. එය සෑම ඉල්ලීමකදීම X-API-Key ශීර්ෂය ලෙස යොමු කරන්න.

පියවර 3 — ඔබගේ පළමු ඇමතුම. මෙය ඔබගේ ටර්මිනලයට ඇලවීමෙන් පසුව sm_your_key ඔබගේ උපකරණ පුවරුවෙන් ලබාගත් යතුර සමඟ ප්‍රතිස්ථාපනය කරන්න:

cURL

curl -H "X-API-Key: sm_your_key" "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

අපේක්ෂිත ප්‍රතිචාරය:

JSON
{
 "ts": 1710940821,
 "symbol": "BTC",
 "direction": "long",
 "composite": 0.74,
 "confidence": "HIGH",
 "action": "CONFIRM",
 "size_mult": 1.5,
 "deriv_score": 0.81,
 "onchain_score": 0.68,
 "whale_score": 0.73,
 "reasons": ["සියලුම වෙන්දේසි කේන්ද්‍රවල ණය අනුපාතය ධනාත්මකයි", "තල්මසුන්: 67% දිගු එකඟතාවය"]
}

කවදා confidence යනු HIGH හෝ MEDIUM සහ action යනු CONFIRM, ඔබේ ස්ථානයේ ප්‍රමාණය පරිමාණය කරන්න size_mult. එය සම්පූර්ණ ඒකාබද්ධ කිරීමේ ලූපයයි. බලන්න ප්‍රතිචාර ක්ෂේත්‍ර සම්පූර්ණ ක්ෂේත්‍ර යොමුව සඳහා.

සත්‍යාපනය

සියලුම ඉල්ලීම්වලට API යතුරක් අවශ්‍ය වන අතර එය X-API-Key HTTP හෙඩර් ලෙස යවනු ලැබේ.

HTTP හෙඩර්
X-API-Key: sm_your_api_key_here

ඔබගේ API යතුර ලබා ගත හැක්කේ ඩෑෂ්බෝඩ් ලියාපදිංචි වීමෙන් පසුව. ඔබගේ යතුර රහස් තබා ගන්න — එය ක්ලයන්ට්-පැත්තේ කේතයේ හෝ පොදු ගබඩාවලට නිරාවරණය නොකරන්න.

WebSocket සත්‍යාපනය වෙනස් ය. කිසිවිටෙක ඔබගේ යතුර WebSocket URL එකක් තුළ තබන්න එපා. තාත්තික-කාල ප්‍රවාහ කෙටි කාලීන, එක්-භාවිතයේ ටිකට්භාවිතා කරයි: ඔබගේ යතුර POST කරන්න /v1/ws/ticket හි X-API-Key හෙඩර් සමඟ, පසුව ආපසු ලබා දෙන ටිකට් සමඟ සම්බන්ධ වන්න. බලන්න WebSocket සත්‍යාපනය (ටිකට්).

Google පිවිසුම (Firebase Auth)

පරිශීලකයන්ට ඔවුන්ගේ Google ගිණුම හරහා Firebase සත්‍යාපනය භාවිතා කර සත්‍යාපනය කළ හැක. ක්ලයන්ට් එකේ Google පිවිසුම සාර්ථක වූ පසු, Firebase ID ටෝකන් එක API සැසියක් සමඟ සම්බන්ධ කරන්න. පද්ධතිය ස්වයංක්‍රීයව ඔබගේ Google අනන්‍යතාව API යතුර පද්ධතිය සමඟ සමමුහුර්ත කරයි.

ලබා ගත හැක්කේ: නොමිලේ වෙළෙන්දා Pro

POST /auth/google

ඉල්ලීමේ ශරීරය

ක්ෂේත්‍රය	වර්ගය	විස්තරය
id_tokenඅවශ්‍යයි	පේළිය	Firebase ID ටෝකන් එක ලබා ගන්නේ ක්ලයන්ට් එකේ Google පිවිසුමෙන් පසුව

උදාහරණ ප්‍රතිචාරය

JSON

{
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}

පරිශීලක පැතිකඩ දත්ත — ඊමේල්, සැලැස්ම, භාවිත ඉතිහාසය, ප්‍රියතම — Firestore තුළ ගබඩා කර ඇති අතර ඔබගේ Google ගිණුම සමඟ සම්බන්ධ වේ. සම්පූර්ණ දත්ත නිර්යාතයක් හෝ ගිණුම මකාදැමීමක් ඕනෑම අවස්ථාවක ඩෑෂ්බෝඩ් පෞද්ගලිකත්ව සැකසුම් හරහා ඉල්ලා සිටිය හැක.

අනුපාත සීමාවන්

සැලැස්ම	කතා/දිනය	ප්‍රචණ්ඩ සීමාව	දත්ත ප්‍රමාදය
නොමිලේ	50	2/මිනි	60 තත්පර
වෙළෙන්දා	1,000	20/මිනි	තාත්තික-කාල
Pro	5,000	60/min	තත්වය ප්‍රතික්ෂේප කරන්න
Enterprise	100,000	400/min	තත්වය ප්‍රතික්ෂේප කරන්න

සෑම ප්‍රතිචාරයකම අනුපාත සීමා ශීර්ෂ ඇතුළත් වේ: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

පාදක URL

https://api.smartmoneyapi.com/v1

පහත සඳහන් සියලුම අන්ත ලක්ෂ්‍ය මෙම පාදක URL ට සාපේක්ෂ වේ. සියලු ප්‍රතිචාර JSON වේ Content-Type: application/json.

දෝෂ

දෝෂ සම්මත HTTP තත්ත්ව කේත සහ ස්ථාවර JSON ශරීරය භාවිතා කරයි. සෑම විටම තත්ත්ව කේතය මත අතු කරන්න, ප්‍රතිචාර පෙළ මත නොවේ. ඔබ බොහෝ විට පහර දෙන තුන:

තත්ත්වය	කේතය	අර්ථය සහ කළ යුතු දේ
401	අනවසරය	API යතුර නැති හෝ වලංගු නොවේ. පරීක්ෂා කරන්න `X-API-Key` ශීර්ෂය පවතින අතර නිවැරදිද යන්න.
402	payment_required	අන්ත ලක්ෂ්‍යය හෝ සංකේතයට ඔබගේ යතුරට වඩා ඉහළ සැලැස්මක් අවශ්‍යය (උදා: නොමිලේ යතුරක් WebSocket firehose අමතනවා). යාවත්කාලීන කරන්න හෝ පොදු අන්ත ලක්ෂ්‍යයකට ආපසු යන්න.
429	rate_limit_exceeded	දිනපතා හෝ පිපිරුම් සීමාව ඉක්මවා ඇත. පසුපසට ගොස් පසුව නැවත උත්සාහ කරන්න `X-RateLimit-Reset`; තුවක්කු නොකරන්න.

සෑම දෝෂයක්ම එකම හැඩය ආපසු ලබා දෙයි:

JSON
{
 "error": "rate_limit_exceeded",
 "message": "Daily limit of 100 calls reached. Resets at 00:00 UTC.",
 "status": 429
}

සම්පූර්ණ තත්ත්ව කේත ලැයිස්තුව සඳහා (400 / 403 / 500 / 503 සහ තවත්), බලන්න දෝෂ කේත. ශක්තිමත් ඒකාබද්ධ කිරීමක් 5xx සහ 429 තාවකාලික ලෙස සලකයි (පසුපසට ගොස් නැවත උත්සාහ කරන්න) සහ 401/402/403 අවසාන ලෙස (යතුර හෝ සැලැස්ම නිවැරදි කරන්න).

ආරක්ෂක හොඳම පරිචයන්

යතුර ශීර්ෂයේ යවන්න, URL එකේ කිසි විටෙකත් නොවේ. සෑම විටම යවන්න X-API-Key HTTP ශීර්ෂයක් ලෙස. විමසුම් නූල් වල යතුරු (?key=) ප්‍රොක්සි, බර සමතුලිත කරන්නන් සහ බ්‍රවුසර ඉතිහාසය මගින් ලොග් කරනු ලැබේ — පැරණි ?key= auth තවදුරටත් WebSocket අන්ත ලක්ෂ්‍ය වල පිළිගන්නේ නැත මෙම හේතුව නිසාම.

යතුරු සර්වර් පැත්තේ තබා ගන්න. කිසි විටෙකත් API යතුරක් ක්ලයන්ට්-පැත්තේ JavaScript, ජංගම යෙදුම් බන්ඩලයක හෝ පොදු ගබඩාවක ඇතුළත් නොකරන්න. එය පරිසර විචල්‍යයකින් හෝ රහස් කළමනාකරුවෙකුගෙන් පූරණය කරන්න. යතුරක් ගලා ගියහොත්, එය භ්‍රමණය කරන්න.

යතුරු වරින් වර භ්‍රමණය කරන්න. ඔබගේ යතුර නැවත ජනනය කරන්න උපකරණ පුවරුව කාලසටහනක් මත සහ ඔබ නිරාවරණය වී ඇතැයි සැක කරන්නේ නම් වහාම. පැරණි යතුර නව එකක් නිකුත් කරන මොහොතේ නවතී.

බ්‍රවුසර සොකට් සඳහා ටිකට් භාවිතා කරන්න. බ්‍රවුසරයෙන් තත්වය ප්‍රතික්ෂේප කරන ප්‍රවාහ සඳහා, ඔබගේ යතුර තනි භාවිත ටිකට් එකක් සඳහා හුවමාරු කරන්න — බලන්න WebSocket සත්‍යාපනය (ටිකට්).

කේතීකරණ නියෝජිතයන් / LLMs සමඟ භාවිතා කිරීම

Claude Code, Codex, Cursor, හෝ ඕනෑම LLM කේතීකරණ නියෝජිතයෙකු සමඟ ගොඩනඟනවාද? ඔබට මෙම API නිවැරදිව සම්බන්ධ කිරීමට අවශ්‍ය සියල්ල එක් පහරකින් නියෝජිතයාට ලබා දිය හැකිය. යන්ත්‍ර කියවිය හැකි යොමු දෙකක් ප්‍රකාශයට පත් කර ඇත:

සම්පත්	URL
LLM සාරාංශය	`https://smartmoneyapi.com/llms.txt`
OpenAPI විශේෂාංග	`github.com/tashiardit/smartmoneyapi-docs`

ඔබගේ නියෝජිතයා යොමු කරන්න /llms.txt ගොනුවට (the llms.txt සම්ප්‍රදාය) සංක්ෂිප්ත විශ්ලේෂණයක් සඳහා, පසුව OpenAPI විශේෂාංග නිශ්චිත ඉල්ලීම්/ප්‍රතිචාර හැඩතල සඳහා. ඉතා හොඳින් ක්‍රියා කරන එක් පේළි ඉල්ලීමක්:

ඉල්ලීම

# Claude Code / Cursor / Codex එකට අලවන්න
https://smartmoneyapi.com/llms.txt සහ OpenAPI විශේෂාංග කියවන්න
github.com/tashiardit/smartmoneyapi-docs, පසුව මගේ බොට් එකට පූර්ව-වෙළඳාම්
පරීක්ෂාවක් එක් කරන්න GET /v1/confirm අමතන සහ ඇතුළත් කිරීම් මඟ හරින්න
ක්‍රියාව CONFIRM නොවන තාක් කල්.

බලන්න Cookbook ක්‍රියාත්මක කළ කේතීකරණ නියෝජිත වට්ටෝරුවක් සඳහා.

අන්ත ලක්ෂ්‍ය

GET /confirm

ප්‍රධාන අන්ත ලක්ෂ්‍යය. දී ඇති වෙළඳ දිශාවක් සඳහා සංයුක්ත විශ්වාසනීයත්ව ලකුණු සහ ක්‍රියා නිර්දේශය ආපසු ලබා දෙයි. ඕනෑම තනතුරක් ඇතුළත් කිරීමට පෙර මෙය අමතන්න.

පැහැදිලි වචන වලින් ආවරණය. /confirm දැනට ලකුණු කරයි BTC, ETH සහ SOL — විශ්වාසනීය ඉතිහාසයක් සහිතව සාධාරණයෙන් තහවුරු කිරීමට ප්‍රමාණවත් සංකේත. ව්‍යුත්පන්න පරිලෝකකය වෙන වෙනම ~519 ව්‍යුත්පන්න වෙළඳපොල නිරීක්ෂණය කරයි අරමුදල්, OI සහ ද්‍රව්‍යකරණ දත්ත සඳහා, සහ තල්මසුන් ගමන් කළමනාකරණය 600+ බඩුතොග ආවරණය කරයි. Pro සම්පූර්ණ පරිලෝකකය, අපනයන සහ විශාල වෙළඳපොල ආවරණය අගුළු ඇරයි; /confirm සංකේත සහය එක් එක් වෙළඳපොල විශ්වාසනීය ඉතිහාසයක් රැස් කරන විට පුළුල් කරනු ලැබේ.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
සංකේතයඅවශ්‍යයි	පේළිය	අස්ථි සංකේතය. එකක්: `BTC`, `ETH`, `SOL` (Trader+)
දිශාවඅවශ්‍යයි	පේළිය	වෙළඳ දිශාව: `long` හෝ `short`
මූලාශ්‍රයවිකල්ප	පේළිය	ඔබගේ සංඥා මූලාශ්‍රය සඳහා ලේබලය (විශ්ලේෂණ සඳහා ලොග් කර ඇත). උපරිම 32 අක්ෂර.

ඉල්ලීම් උදාහරණය

cURL

curl -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

ප්‍රතිචාර උදාහරණය

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "direction": "long",
 "composite": 0.74,
 "confidence": "HIGH",
 "action": "CONFIRM_FULL",
 "size_mult": 1.5,
 deriv_score: 0.81,
 onchain_score: 0.68,
 whale_score: 0.73,
 x_score: 0.0,
 factors: {
 derivatives: { score: 0.81, weight: 0.40, weighted: 0.324 },
 onchain: { score: 0.68, weight: 0.35, weighted: 0.238, source: coinmetrics, available: True },
 whale: { score: 0.73, weight: 0.25, staleness_factor: 1.0, weighted: 0.183 }
  },
 adjustments: { agreement: 0.0, trend: 0.0, news_macro: 0.0 },
 weights: { derivatives: 0.40, onchain: 0.35, whale_intel: 0.25 },
 coverage: { derivatives: True, whale: True, onchain: True },
 reasons: [
 Funding rate positive across all venues,
 LSR favors longs: 1.42,
 Whales: 67% long consensus,
 MVRV above 1.0 — on-chain bullish
  ]
}

Transparent by design. Every response carries a factors object showing each leg's score × weight = weighted contribution, an adjustments object for post-filter tweaks, the weights used, and a coverage map. The on-chain leg uses real free Coin Metrics data (MVRV / exchange-flow / active-address) when no Glassnode key is set. This is a multi-factor confluence score — decision support, not a guaranteed win-rate.

Untracked symbols are honest. A symbol outside the tracked derivatives/whale universe returns an explicit "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" with "unsupported":true — never a fabricated LOW.

Response Fields

Field	Type	Description
ts	integer	Unix timestamp of the calculation
symbol	string	Asset symbol (BTC/ETH/SOL)
direction	string	Requested direction (long/short)
composite	float	Composite confluence score from -1.0 (extreme contra) to +1.0 (strong confirm). Not a win-rate.
base_composite	float	Composite before post-filter adjustments were applied
confidence	string	`HIGH` / `MEDIUM` / `LOW` / `VETO` / `NO_DATA`
action	string	`CONFIRM_FULL` / `CONFIRM_REDUCED` / `CONFIRM_MINIMAL` / `VETO_SKIP` / `NO_DATA_SKIP`
size_mult	float	Suggested position size multiplier (e.g. 0.0 – 1.5)
unsupported	bool	`true` when the symbol is outside coverage (paired with NO_DATA)
deriv_score	float	Derivatives sub-score (-1 to 1)
onchain_score	float	On-chain sub-score (-1 to 1)
whale_score	float	Whale consensus sub-score (-1 to 1)
x_score	float	X/social-sentiment sub-score (-1 to 1); 0 when unused
factors	object	Per-leg breakdown: `score × weight = weighted` for derivatives / onchain / whale / x_sentiment (onchain includes `source`)
adjustments	object	Signed post-filter tweaks (agreement, trend, rsi_1h, news_macro, momentum, time_of_day, streak_decay)
weights	object	Weight set actually used for this evaluation
coverage	object	`{derivatives, whale, onchain}` — which legs had real data
reasons	array	Human-readable explanation strings for the score

GET /snapshot

Returns a full market snapshot including all sub-scores, raw metrics, and indicator values for a given symbol. Useful for dashboards and logging.

Requires: වෙළෙන්දා ප්‍රෝ

GET /onchain

අමු on-chain මෙට්‍රික්ස් ආපසු ලබා දෙයි: MVRV, SOPR, exchange net flow, realized cap ratio, සහ cycle position classification.

අවශ්‍යයි: වෙළෙන්දා ප්‍රෝ

GET /v1/derivatives/*

500+ සංකේත හරහා cross-exchange derivatives screener: funding-rate heatmap, open-interest rankings, සහ long/short-ratio signal detection. ඉහළම පේළි 10 පොදුවේ ඇත; සම්පූර්ණ screener සඳහා Trader හෝ Pro අවශ්‍යයි. Endpoints: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET /v1/options/*

Deribit-sourced BTC & ETH options analytics (පොදු, no auth): put/call ratio, max pain, සහ open interest by strike. Endpoints: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

Spot BTC & ETH ETF දිනපතා net flows සහ per-fund breakdown (පොදු). Endpoints: /v1/etf/flows, /v1/etf/funds.

GET /v1/historical/*

ඓතිහාසික funding, open interest, long/short ratio (Binance), සහ OHLCV (CoinGecko) backtesting සඳහා. Endpoints: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET /v1/dex/*

DexScreener-powered trending pairs, token search, සහ pair details (පොදු, no auth). Endpoints: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET /v1/news/*

ප්‍රවෘත්ති බුද්ධිය: ප්‍රතිපත්ති/භූගෝලීය/ක්‍රිප්ටෝ ප්‍රවෘත්ති බලපෑම් කාණ්ඩවලට වර්ගීකරණය කර ඇත, එයට Fear & Greed (පොදු, no auth) ඇතුළත් වේ. Endpoints: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET /whales

තල්මසුන් wallet consensus දත්ත ආපසු ලබා දෙයි: long/short split, total notional exposure, ඉහළම ස්ථාන 10 (Pro පමණි), සහ wallet count.

අවශ්‍යයි: වෙළෙන්දා ප්‍රෝ

GET /signals

සියලුම නිරීක්ෂණය කරන ඇසට් සඳහා මෑතකාලීන HIGH/MEDIUM සංඥාවල stream එකක් ආපසු ලබා දෙයි. අවස්ථා ස්කැන් කිරීම සඳහා ප්‍රයෝජනවත් වේ.

අවශ්‍යයි: ප්‍රෝ

GET /v1/strategies/*

Smart Money සංඥා මත ක්‍රියාත්මක වන ස්වයංක්‍රීය වෙළඳ උපායමාර්ග සඳහා පාරදෘෂ්‍ය, read-only track record — එයට deriv40 SmartMoney Copytrade උපායමාර්ගය (account=9). සියලුම endpoints ?account=<id> query parameter එකක් ගනී සහ JSON ආපසු ලබා දෙයි. සත්‍යාපනය අවශ්‍ය නැත (පොදු track record).

Endpoints

GET /v1/strategies/stats?account=9 — headline metrics: total_trades, win_rate, profit_factor, total_pnl_usdt, account_growth_percent, initial_equity, current_equity, max_drawdown_portfolio, max_drawdown_trade.
GET /v1/strategies/equity?account=9 — equity curve for charting: { initial_equity, curve: [{ time, equity }] }.
GET /v1/strategies/trades?account=9&limit=500 — closed-trade ledger: array (හෝ {trades:[…]}) of symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
GET /v1/strategies/active?account=9 — currently open positions: array (හෝ {positions:[…]}) of symbol, side/direction, entry_price, unrealized_pnl.
GET /v1/strategies/signals — signal-type breakdown feeding the strategies (count / wins / win_rate / avg_pnl per signal type).

පසුගිය කාර්ය සාධනය අනාගත ප්‍රතිඵලයන්හි දර්ශකයක් නොවේ. රූප සටහන් single ~3-month regime එකක් පුරා backfilled කර ඇති අතර live trades ඇතුළත් වේ, සහ pre-fee ලෙස දක්වා ඇති තැන්වල දක්වා ඇත.

GET /export

ඓතිහාසික සංඥා දත්ත CSV ලෙස download කරන්න backtesting සඳහා. පරාමිතීන්: symbol, from (unix ts), to (unix ts).

අවශ්‍යයි: ප්‍රෝ

GET /health

පද්ධති සෞඛ්‍ය පරීක්ෂාව. සෑම මූලාශ්‍රයක් සඳහාම දත්ත නවීකරණය සහ සමස්ත API status ආපසු ලබා දෙයි. සත්‍යාපනය අවශ්‍ය නැත.

JSON Response
{
 "status": "ok",
 "uptime_s": 1209600,
 "sources": {
 "bybit": { "lag_s": 42, "ok": true },
 "binance": { "lag_s": 38, "ok": true },
 "hyperliquid": { "lag_s": 61, "ok": true },
 "onchain": { "lag_s": 290, "ok": true }
  }
}

GET /usage

ඔබගේ වර්තමාන API භාවිත සංඛ්‍යාලේඛන ආපසු ලබා දෙයි: අද කෑලි, මාසික එකතු, quota සීමාවන්, සහ reset කාලයන්.

POST /webhooks

අවශ්‍යයි: ප්‍රෝ

ඔබගේ නිරීක්ෂණය කරන ඇසට සංඥාවක් ගිනි ගන්නා විට real-time signed event pushes ලබා ගැනීම සඳහා HTTPS URL එකක් ලියාපදිංචි කරන්න. භාරදීම් X-SmartMoney-Event header එකක් සහ HMAC-SHA256 අත්සනක් ගෙන යයි X-SmartMoney-Signature, සහ backoff සමඟ 3× දක්වා retry කරයි.

Request Body

Field	Type	Description
urlrequired	string	HTTPS endpoint to POST events to (must start with `https://`)
eventsrequired	array	Event names, e.g. `["HIGH","MEDIUM","VETO"]` or `["*"]`
symbolsrequired	array	Symbols to filter, e.g. `["BTC","ETH"]` or `["*"]`
secretrequired	string	Your signing secret, ≥ 16 chars (stored hashed)

Verifying the signature

The HMAC key is the SHA-256 hex digest of your registered secret. Compute the HMAC-SHA256 of the raw request body with that key and compare (constant-time) against X-SmartMoney-Signature. See the Webhook Implementation guide.

බුද්ධිමත් තොරතුරු

GET /analysis

අවශ්‍යයි: Pro

AI-බලගැන්වූ වෙළඳපල ක්‍රමය වර්ගීකරණය සහ සංඥා ගැටුම් හඳුනාගැනීම ලබා දෙයි. ව්‍යුත්පන්න, ඔන්-චේන් සහ වේල් දත්ත අතර ගැළැස්ම හඳුනාගෙන, ඉදිරි අවදානම් සාධක සහ කාලීන නිර්දේශ සහිත ස්වාභාවික භාෂා සාරාංශයක් නිපදවයි.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
symbolrequired	string	අස්ථාවර සංකේතය: `BTC`, `ETH`, හෝ `SOL`

උදාහරණ ප්‍රතිචාරය

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "regime": "late_cycle_divergence",
 "regime_label": "Late Cycle — Signal Divergence",
 "summary": "BTC අවසන් ගව චක්‍රයේ පවතින අතර, ඔන්-චේන් ශක්තිය ව්‍යුත්පන්න අධික භාවය සමඟ ගැටෙයි. වේල් අඩු කරමින් සිටින අතර රිටේල් LSR ඉහළ යයි.",
 "signal_conflicts": [
 "වේල් ලකුණු අඩුවෙන් ඇති අතර ඔන්චේන් ලකුණු ඉහළය",
 "අරමුදල් අනුපාතය 3-මාසයේ උච්චයේ — සම්බාව්‍ය අවපීඩන අවදානම"
  ],
 "risk_factors": ["ඉහළ අරමුදල්", "OI ගැළැස්ම", "වේල් අඩුවීම"],
 "recommendation": "දිගු අනාවරණය අඩු කරන්න, නවතින තද කරන්න. වර්තමාන මිලට ඉහළින් නව දිගු වලකන්න.",
 "time_horizon": "4h–12h"
}

Pro යෝජනා ක්‍රමය අවශ්‍යයි. මෙම අන්ත ලක්ෂ්‍යය AI ප්‍රතිකාර අතිරේකය හේතුවෙන් ඉල්ලීමකට API ඇමතුම් 3 ක් භාවිතා කරයි.

GET /liquidations

අවශ්‍යයි: Trader Pro

ආපසු ලබා දෙයි පරිපූරක දර්ශන දෙකක්: (1) ලෙවරේජ්-ප්‍රක්ෂේපිත levels — ඇස්තමේන්තුවක් යනු ද්‍රවීකරණ කළඹ ඇති ස්ථානය; සහ (2) එකක් realized_heatmap — REAL ක්‍රියාත්මක කළ බලහත්කාර ද්‍රවීකරණ තීව්‍රතාව (මිල × කාලය), පොදු විනිමය WebSocket සංදේශ වලින් සජීවීව සමුච්චය කර ඇත: Binance, OKX, Bybit, Bitget, BitMEX. උණුසුම් සිතියම සංකේතය සඳහා දත්ත ඇති විට පවතී (ඉතා සන්සුන් වෙළඳපලක හෝ ආරම්භයෙන් පසු නොමැති විය හැක).

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තර
සංකේතයවිකල්ප	පේළිය	අස්ථා සංකේතය (පෙරනිමිය `BTC`). සත්‍ය තාප සිතියම සක්‍රීයව වෙළඳාම් කරන පර්ප් සංකේත ආවරණය කරයි.

උදාහරණ ප්‍රතිචාරය

JSON

{
 "symbol": "BTC",
 "cascade_risk": "HIGH",
 "nearest_long_liq_pct": -3.2,
 "nearest_short_liq_pct": 4.1,
 // සත්‍ය ක්‍රියාත්මක කළ ද්‍රවීකරණ — 5 විනිමය ගිණුම් වලින් සජීවීව
 "realized_heatmap": {
 "window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
 "clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
 "by_side": { "long": 6100000.0, "short": 2400000.0 },
 "totals": { "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
  }
}

වෙළෙන්දා සැලැස්ම: cascade_risk, ආසන්නතම දුර, සහ සත්‍ය එකතු/පැත්ත අනුව. Pro සැලැස්ම: සම්පූර්ණ ප්‍රක්ෂේපිත levels ප්ලස් සම්පූර්ණ realized_heatmap (matrices, per-price clusters, per-exchange counts). ප්‍රක්ෂේපිත ඇස්තමේන්තුව "නවතින තැන් කොහෙද" යන ප්‍රශ්නයට පිළිතුරු දෙයි; සත්‍ය තාප සිතියම "සත්‍යයෙන් ද්‍රවීකරණය වූ දේ" පෙන්වයි.

GET /liquidations/heatmap

ලබා ගත හැක්කේ: Free සත්‍යාපනය අවශ්‍ය නැත (ප්‍රති-IP තර්ජනය කර ඇත)

පොදු මිල-මට්ටමේ ද්‍රවීකරණ තාප සිතියම. Coinglass-විලාසයේ මිල × කාල අනුකෘතියක් ආපසු ලබා දෙයි සත්‍ය ක්‍රියාත්මක කළ බලහත්කාර ද්‍රවීකරණ, එක් එක් ද්‍රවීකරණය මුද්‍රණය වූ මිල අනුව බෑග් කර ඇත — පොදු විනිමය ගිණුම් වල සජීවී WebSocket සංදේශ වලින් සමුච්චය කර ඇත: Binance, OKX, Bybit, Bitget, BitMEX. The clusters array යනු ප්‍රායෝගික ප්‍රතිදානයයි: ද්‍රවීකරණය කළ නොෂනල් අනුව ශ්‍රේණිගත කරන ලද මිල බෑග්, එක් එක් එහි ප්‍රධාන පැත්ත සමඟ ටැග් කර ඇත. දත්ත සජීවී ස්ට්‍රීම් මත රඳා පවතී — ඉතා නිශ්ශබ්ද සංකේතයක් හෝ නැවත ආරම්භ කළ ගේට්වේ යහපත් ආකෘතියේ හිස් ව්‍යුහයක් සහ නිර්දෝෂ note. පෙන්වන මට්ටම් සැමවිටම සත්‍ය ද්‍රවීකරණ වේ, කිසිවිටෙකත් ඇස්තමේන්තු නොවේ.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
symboloptional	string	අස්ථාන සංකේතය (පෙරනිමිය `BTC`).
window_minutesoptional	int	මිනිත්තු වලින් පසුපස බැලීමේ කවුළුව (පෙරනිමිය `240`, 5–1440 දක්වා සීමා කර ඇත).
price_bucketsoptional	int	මිල බෑග් ගණන (පෙරනිමිය `50`, 5–100 දක්වා සීමා කර ඇත).

උදාහරණ ප්‍රතිචාරය

JSON

{
 "symbol": "BTC", "window_minutes": 240, "price_buckets": 50,
 "price_min": 91000.0, "price_max": 99000.0, "price_bucket_size": 160.0,
 "price_levels": [ 91080.0, 91240.0, … ], "time_buckets": [ … ],
 "matrix": [ [ … ] ], "long_matrix": [ [ … ] ], "short_matrix": [ [ … ] ],
 "clusters": [
    { "price": 93250.0, "notional": 4820000.0, "long_notional": 4100000.0,
 "short_notional": 720000.0, "count": 37, "dominant_side": "long" }
  ],
 "by_side": { "long": 6100000.0, "short": 2400000.0 },
 "totals": { "long_liq_notional": 6100000.0, "short_liq_notional": 2400000.0, "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 },
 "generated_at": 1710940200, "public": true
}

සාධාරණ සටහන: මෙම අන්ත ලක්ෂ්‍යය සජීවී ප්‍රවාහය අල්ලා ගත් දේ පමණක් පිළිබිඹු කරයි. සංකේතය නිහ calm හෝ ප්‍රවාහය ආරම්භ වූ විට, totals.count is 0, clusters හිස් ය, සහ note ක්ෂේත්‍රයක් එයට හේතුව පැහැදිලි කරයි. එය ක්‍රියාත්මක කරන ලද ද්‍රවීකරණ වාර්තාවකි — අනාවැකියක් නොවේ. ප්‍රක්ෂේපිත "නවතින තැන් කොහෙද" ඇස්තමේන්තුව සඳහා, සත්‍යාපනය කරන ලද /liquidations අන්ත ලක්ෂ්‍යය භාවිතා කරන්න.

GET /liquidations/onchain

අවශ්‍යයි: Trader Pro

Executed on-chain DeFi ණය දීම් ද්‍රවීකරණ අපගේම දේශීය BSC + Avalanche සම්පූර්ණ නෝඩ් — ඕනෑම වෙළඳ බොට් එකකින් ස්වාධීන. BSC හි Venus/Cream සහ Moolah, සහ Avalanche හි AAVE V3/V2, Benqi, BankerJoe, Granary සහ Vinium ආවරණය කරයි. Pro තරණය අතිරේකව ආපසු ලබා දෙයි at_risk ස්ථාන (බොට්-ජඩ්, නොමැති විය හැකිය).

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
chainoptional	string	`bsc` හෝ `avax`. සියලු දාම සඳහා ඉවත් කරන්න.
limitoptional	integer	උපරිම පේළි (පෙරනිමි 100, උපරිම 500). නවතම-පළමු.

උදාහරණ ප්‍රතිචාරය

JSON

{
 "chain": "bsc", "count": 2,
 "liquidations": [
    { "chain": "bsc", "protocol": "Venus", "borrower": "0x2be6…8dfa",
 "debt_symbol": "DAI", "repay_usd": 426.15,
 "collateral_symbol": "WBNB", "tx_hash": "0x718c…7c0e", "block": 89170816, "ts": 1710940200 }
  ],
 "summary": {
 "window_hours": 24, "enabled": true,
 "by_protocol": { "bsc:Venus": { "count": 61, "repay_usd_known": 148230.55 } },
 "nodes": { "bsc": { "reachable": true, "head_block": 89173010, "events_total": 61 } }
  }
}

GET /smart-stop

අවශ්‍යයි: Trader Pro

වත්මන් ද්‍රවශීලතා තාප සිතියම, අස්ථාවරතා පටි, සහ වෙළඳපල ව්‍යුහය මත පදනම්ව බුද්ධිමත් stop-loss මට්ටම් ගණනය කරයි. ඔබේ ඇතුල්වීමේ මිල සහ අවදානම් ඉවසීම අනුව සකස් කරන ලද තට්ටු stop නිර්දේශ සහ ලාභ ගැනීමේ යෝජනා ආපසු ලබා දෙයි.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
symbolrequired	string	අස්ථාවරතා සංකේතය: `BTC`, `ETH`, or `SOL`
directionrequired	string	ස්ථාන දිශාව: `long` or `short`
entry_priceoptional	float	ඔබේ ඇතුල්වීමේ මිල. අතහැර දැමුවහොත් වත්මන් වෙළඳපල මිලට පෙරනිමිය.
risk_pctoptional	float	ගිණුමේ % ලෙස උපරිම අවදානම් ඉවසීම. පෙරනිමිය: `2.0`

උදාහරණ ප්‍රතිචාරය

JSON

{
 "symbol": "BTC",
 "direction": "long",
 "entry_price": 96420,
 "stops": {
 "tight": { "price": 95100, "note": "පහත 1h ව්‍යුහය. scalps සඳහා හොඳම." },
 "recommended": { "price": 93800, "note": "ප්‍රධාන liq cluster යටතේ $94K. සම්මත swing stop." },
 "wide": { "price": 91200, "note": "පහත 4h ඉල්ලුම කලාපය. ස්ථාන වෙළඳ stop." }
  },
 "avoid_zones": [
    { "low": 94200, "high": 94800, "reason": "දense ද්‍රවශීලතා cluster — ඉහළ slippage අවදානම" }
  ],
 "take_profit_suggestions": [
    { "tp1": 98500, "tp2": 101000, "tp3": 104200 }
  ]
}

Trader සැලැස්ම: ආපසු ලබා දෙන්නේ recommended stop පමණි. Pro සැලැස්ම: සියලු stop තට්ටු තුන, avoid_zones, සහ සම්පූර්ණ ලාභ ගැනීමේ යෝජනා.

GET /funding-arb

අවශ්‍යයි: Trader Pro

තත්පරයකට cross-exchange අරමුදල් අනුපාත අර්බුද අවස්ථා හඳුනා ගනී. ඇස්තමේන්තුගත වාර්ෂික ඵලදායිතාවය, ප්‍රශස්ත හුවමාරු යුගලය, සහ විස්තාරය අල්ලා ගැනීමට අවශ්‍ය hedge ක්‍රියාව සමඟ අවස්ථා ශ්‍රේණිගත කර ආපසු ලබා දෙයි.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
min_spreadoptional	float	ඇතුලත් කිරීමට අවම අරමුදල් අනුපාත විස්තාරය (දශමයක් ලෙස). පෙරනිමිය: `0.01`
symboloptional	string	නිශ්චිත අස්ථාවරතාවයකට පෙරහන් කරන්න. සියලු සහාය ලබන අස්ථාවරතා ස්කෑන් කිරීමට අතහැර දමන්න.

උදාහරණ ප්‍රතිචාරය

JSON

{
 "ts": 1710940821,
 "opportunities": [
    {
 "symbol": "BTC",
 "spread": 0.032,
 "apr": 84.2,
 "long_exchange": "hyperliquid",
 "short_exchange": "bybit",
 "action": "Long HYPE / Short BYBIT",
 "estimated_profit_8h_usd": 26.4
    }
  ]
}

Trader සැලැස්ම: ඉහළම අවස්ථාව 1 පමණක්, ඓතිහාසික විස්තාර දත්ත නැත. Pro සැලැස්ම: හුවමාරු යුගලයකට 24h විස්තාර ඉතිහාසය සමඟ සියලු වත්මන් අවස්ථා.

නිදහස් පොදු ප්‍රභේදය No auth

යතුරු-නැති පොදු අන්ත ලක්ෂ්‍යයක් cross-exchange screener සමඟ ඉහළම අවස්ථා 10 ආපසු ලබා දෙයි, embed කිරීමට හෝ ඉක්මන් පරීක්ෂා සඳහා සුදුසුය. එය per-symbol විස්තාර ඉතිහාසය සහ බර ක්ෂේත්‍ර අතහැර දමන අතර 120-තත්පර cache එකකින් සේවය කරයි. නැතුවාදීකරණ කවුළුව තුළ cross-exchange අරමුදල් විස්තාර නොමැති විට එය හිස් opportunities array සමඟ note — කිසි විටෙකත් සාදන ලද දත්ත නොවේ.

GET (no auth)

GET /v1/derivatives/funding-arb

JSON

{
 "opportunities": [
    {
 symbol: OGN,
 spread_pct: 0.297667,
 annualized_apr: 325.95,
 long_exchange: bybit,
 short_exchange: hyperliquid,
 estimated_profit_per_10k: 29.77,
 risk_notes: අඩු පැතිරීම — අතිරික්ත ආයෝජන ආන්තිකය පාගානොගැනීමට ගාස්තු සහතික කරන්න.
    }
  ],
 scanned_symbols: 222,
 ts: 1783268753,
 public: True,
 limited: True
}

නොමිලේ, API යතුරක් නැත. ඉහළම අවස්ථා 10 පමණක්, සීමා කර ඇති සහ කෑච් කර ඇත (120 s). සජීවි පරිලෝකන පිටුව: funding-arb.html.

GET /smart-money/flow

අවශ්යයි: Trader Pro

ගුණාත්මක බරකින් යුත් තල්මසුන්ගේ දිශානති දර්ශකය සංකේතයකට, ලකුණු කර ඇත -100 (තල්මසුන්ගේ මුදල් කෙටි කාලීනව නැමී ඇත) සිට +100 (දිගු කාලීනව නැමී ඇත). දහස් ගණනක් ගණනය කරන ලද Hyperliquid තල්මසුන්ගේ පසුම්බි වලින් ගොඩනගා ඇත — එක් එක් එහි ඓතිහාසික ජයග්‍රහණ අනුපාතය සහ PnL මගින් බර කර ඇති අතර අලුත් බව අඩු කර ඇත. මෙය ස්ථානගත දර්ශකයකි, මිල අනුමානයක් හෝ මිල පුරෝකථනයක් නොවේ. සංයෝජනය කරන පසුම්බි කිහිපයක් ඇති සංකේත ලේබල් කර ඇත thin සහ අවංකව ලකුණු කර ඇත. සජීවි පිටුව: smart-money-flow.html.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
symbolවිකල්ප	string	තනි සංකේතය (උදා. `BTC`). සියලුම ගණනය කරන ලද සංකේත \|score\| අනුව ලබා ගැනීමට ඉවත් කරන්න.
window_hoursවිකල්ප	int	ලකුණු කිරීමේ කවුළුව, සීමා කර ඇත `1..168`. පෙරනිමිය `24`.

උදාහරණ ප්‍රතිචාරය

JSON

{
 symbols: [
    {
 symbol: SPX,
 score: -90.93,
 direction: strong_short,
 n_wallets: 26,
 long_usd: 184200.0, short_usd: 2410000.0,
 quality_weighted: True,
 sample_quality: rich,
 top_contributors: [ { wallet: 0x31ca…974b, direction: short, value_usd: 5338.25, weight: 0.4948 } ]
    }
  ],
 window_hours: 24,
 quality_weighted: True,
 ts: 1783270000,
 note: ගුණාත්මක බරකින් යුත් තල්මසුන්ගේ දිශානති ස්ථානගත දර්ශකය (-100..+100). මිල පුරෝකථනයක් හෝ මිල අනුමානයක් නොවේ.
}

Trader සැලැස්ම: ඉහළම සංකේත 12, දායකයින්ගේ විස්තර රහස්ය. Pro සැලැස්ම: සියලුම සංකේත සඳහා සංකේතයකට top_contributors. පසුම්බි බර සීමා කර ඇත [0.25,1.0]; PnL යනු නවතම ස්ථාන ස්නැප්ෂොට් වලින් අසාධාරණ ප්‍රතිනිදර්ශකයකි.

GET /v1/whales/crowding

ලබා ගත හැක්කේ: Free සත්‍යාපනය අවශ්‍ය නැත — නිර්නාමිකව ඉහළම සංකේත 10 ලබා ගනී, Trader+ සම්පූර්ණ ලැයිස්තුව ලබා ගනී

සංයුක්ත තල්මසුන්ගේ ස්ථානගත කිරීම සහ ගැඹුරු සන්දර්භය සංකේතයකට, ඒකාබද්ධ කර ඇත Hyperliquid + GMX v2 + Jupiter Perps. ග්‍රෝස්/නෙට් නොට්ෂනල්, දිශානති ආනතිය, පසුම්බි සහ ස්ථාන ගණන, ස්ථාන සාන්ද්රණය (ඉහළම-3 බැගින් + HHI), බරකින් යුත් සාමාන්‍ය උත්පාදකය, සහ ද්‍රවශීලතා-සමීපතා බෑග් (USD නොට්ෂනල් ඇස්තමේන්තුගත ද්‍රවශීලතා මිලෙන් 5% සහ 10% තුළ, දිගු/කෙටි බෙදා ඇත). මෙය සන්දර්භයකි, දිශානති සංඥාවක් නොවේ. ව්‍යුත්පන්න කළ නොහැකි ක්ෂේත්‍ර null සහ පෙන්වන්න — — උදා. lev_wavg/crowding_index උත්පාදකයක් නොමැති විට. ද්‍රවශීලතා දුර යනු වෙන් කරන ලද ආන්තික ඇස්තමේන්තුවකි (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), නොවේ විනිමය වාර්තා කළ ද්‍රවශීලතා මිල.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
min_notionalවිකල්ප	float	ඇතුළත් කිරීම සඳහා අවම සංයුක්ත ග්‍රෝස් නොට්ෂනල් (USD). පෙරනිමිය: `1000000`.

උදාහරණ ඉල්ලීම

GET (no auth)

curl "https://api.smartmoneyapi.com/v1/whales/crowding?min_notional=1000000"

උදාහරණ ප්‍රතිචාරය

JSON

{
 "ok": True, "ts": 1783423500, අවම නාමික: 1000000, සංකේත ගණන: 92,
 සංකේත: [
    {
 සංකේතය: BTC,
 සමස්ත ඇමරිකානු ඩොලර්: 2447900000.0, ශුද්ධ ඇමරිකානු ඩොලර්: -51000000.0, වක්රය: -0.021,
 තල් මසුන් ගණන: 414, ස්ථාන ගණන: 3,
 ස්ථාන: {
 hl: { සමස්ත: 1900000000.0, ශුද්ධ: -40000000.0, තල් මසුන් ගණන: 272 },
 gmx: { සමස්ත: 320000000.0, ශුද්ධ: -6000000.0, තල් මසුන් ගණන: 59 },
 jupiter: { සමස්ත: 227900000.0, ශුද්ධ: -5000000.0, තල් මසුන් ගණන: 83 }
      },
 conc_top3: 0.159, hhi: 0.011, lev_wavg: 19.1,
 liq_within_5pct: { දිගු: 621700000.0, කෙටි: 665600000.0 },
 liq_within_10pct: { දිගු: 840000000.0, කෙටි: 910000000.0 },
 crowding_index: 0.003
    }
  ],
 ආවාට: [ ද්රවශීලන දුර පමණයි-මායිම් ඇස්තමේන්තු, විනිමය-වාර්තා කළ නොවේ. ]
}

සාධාරණ සටහන: skew is net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). සත්යයෙන්ම පවතින ස්ථාන පමණක් පෙන්වයි venues. උත්තෝලනය නැති ස්ථාන ද්රවශීලන බෑග් වලින් බැහැර කර ඇත. නිර්නාමික ඇමතුම්කරුවන්ට සමස්ත අනුව ඉහළම සංකේත 10 ලැබේ (සමඟ gated: true); ට්‍රේඩර්+ සම්පූර්ණ ලැයිස්තුව ලබා ගනී.

GET /v1/options/gex

ලබා ගත හැකි: නිදහස් සත්යාපනය අවශ්‍ය නැත (ප්‍රති-IP සීමා කර ඇත)

ඩීලර් ගැමා බාධාව (GEX) විශ්ලේෂණ සඳහා BTC & ETH, පොදු Deribit විකල්ප දාමයෙන් සජීවීව ගණනය කර ඇත (සත්යාපනය නැත). එක් එක් පහර සඳහා ශුද්ධ ඩීලර් GEX ආපසු ලබා දෙයි (SpotGamma ඩීලර්-කෙටි සම්මුතිය), ගැමා-පෙරළුම් මට්ටම (ශුද්ධ GEX ශුන්‍යය තරණය කරන පහර), IV පද ගොඩනැගිල්ල (දින-ඉකුම්වීම අනුව ATM ඇඟවුම් කළ පරිමාව), සහ ඉදිරි-ඉකුම්වීම IV වක්රය (25Δ-ප්‍රොක්සි අවදානම් ප්‍රතිලෝමය). GEX ක්‍රමය positive (ඩීලර් දිගු ගැමා → පරිමා-සීමා කිරීම) හෝ negative (පරිමා-වර්ධනය). සම්පූර්ණයෙන්ම ස්වයං-අඩංගු — සෑම ඇමතුමකදීම නැවත ගණනය කරනු ලැබේ, ගබඩා-DB යැපීමක් නැත.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
සංකේතයවිකල්ප	පේළිය	`BTC` හෝ `ETH` පමණි. පෙරනිමි: `BTC`.

ඉල්ලීමේ උදාහරණය

GET (සත්යාපනය නැත)

curl "https://api.smartmoneyapi.com/v1/options/gex?symbol=BTC"

ප්‍රතිචාර උදාහරණය

JSON

{
 "symbol": "BTC", "available": true, "spot": 63203.0,
 "net_gex": 18240000.0, "regime": "positive",
 "gamma_flip": 64919.82, "gamma_flip_pct": 2.72,
 "call_gex": 31200000.0, "put_gex": -12960000.0,
 "by_strike": [
    { "strike": 60000, "net_gex": -2100000.0 },
    { "strike": 65000, "net_gex": 4800000.0 }
  ],
 "term_structure": [
    { "expiry": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
    { "expiry": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
  ],
 "skew": {
 "expiry": "8JUL26", "dte": 0.76,
 "put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
 "risk_reversal": 14.35, "bias": "downside_fear"
  }
}

සාධාරණ සටහන: Deribit ගිවිසුම් ගුණකය 1 (කාසි-නාමික OI). ඕනෑම ලබා ගැනීමේ අසාර්ථකත්වයකදී අන්ත ලක්ෂ්‍යය ආපසු ලබා දෙයි available: false හිස් පැනල සමඟ — කිසිවිටෙක ගොඩනඟන ලද GEX නොවේ. IV වක්රය 25Δ සඳහා ස්ථාවර ±10% පහර ප්‍රොක්සි භාවිතා කරයි (සත්ය 25-ඩෙල්ටා සඳහා එක් එක් පහර සඳහා ඩෙල්ටා විසඳීම අවශ්‍යයි); ප්‍රදර්ශනය සඳහා ප්‍රමාණවත්, ආසන්න ලෙස ලියාපදිංචි කර ඇත.

GET /v1/liquidations/simulate

ලබා ගත හැකි: නිදහස් සත්යාපනය අවශ්‍ය නැත (ප්‍රති-IP සීමා කර ඇත)

අන්තර්ක්‍රියාකාරී ද්රවීකරණ ඇලි පීඩන පරීක්ෂණය. උපකල්පිත මිල චලනයක් ලබා දී, තක්සේරු කරන ලද ලෙවරේජ් කරන ලද ස්ථාන ලබා දෙනු ඇත, මිල මට්ටම / පැත්ත / විනිමය අනුව බලහත්කාර පරිමාව, සහ ඇලි-ගැඹුරු කියවීමක්. පහළට චලනයක් තක්සේරු කරයි දිගු එහි liq-price ඉලක්කයට / ඉහළින් ඇති; ඉහළට චලනයක් තක්සේරු කරයි කෙටි එහි liq-price ඉලක්කයට / පහළින් ඇති. ස්වාධීන ක්රම දෙකක් ඒකාබද්ධ වේ: අනුගමනය කරන Hyperliquid තල්මසුන්ගේ නිශ්චිත ද්රවීකරණ මිල සැබෑ ලෙවරේජ් / ඇතුළත් කිරීම, විනිමයකට සංඛ්යානමය OI-band ක්ලස්ටර් (කණ්ඩායම් ලෙවරේජ් අරමුදල් වලින් අනුමාන කරන ලද). සියල්ල පැහැදිලිව ලේබල් කර ඇත estimated: true — එය එක් එක් ගිණුම් මාණුව, ක්රොස් vs හුදකලා, එකතු කරන ලද මාණුව, හෝ ADL දැනගත නොහැක.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
සංකේතයවිකල්ප	පේළිය	අයිතම සංකේතය. පෙරනිමිය: `BTC`.
move_pctවිකල්ප	පාවෙන	උපකල්පිත මිල චලනයක් ප්රතිශතයක් ලෙස (සෘණ = පහළ, ධන = ඉහළ). පෙරනිමිය: `-5`.

ඉල්ලීමේ උදාහරණය

GET (සත්යාපනය නැත)

curl "https://api.smartmoneyapi.com/v1/liquidations/simulate?symbol=BTC&move_pct=-5"

ප්රතිචාර උදාහරණය

JSON

{
 "ok": true, "estimated": true, "symbol": "BTC",
 "ref_price": 63000.0, "move_pct": -5.0, "target_price": 59850.0,
 "triggered_notional_usd": 380000000.0,
 "cascade_depth": 0.029, "cascade_bucket": "low",
 "by_exchange": { "hyperliquid": 260000000.0, "binance": 80000000.0, "bybit": 40000000.0 },
 "by_side": { "long": 380000000.0, "short": 0.0 },
 "clusters": [
    { "price": 60100.0, "side": "long", "notional_usd": 42000000.0, "whale_usd": 18000000.0, "oi_usd": 24000000.0 }
  ],
 "whale_positions_used": 272, "exchanges": 3,
 "realized_context": { "available": true, "coverage_hours": 17.8, "by_side_24h": { "long": 6100000.0, "short": 2400000.0 } },
 "methodology": { "disclaimer": "ඇස්තමේන්තු කරන ලද — එක් එක් ගිණුම් මාණුව, ක්රොස් vs හුදකලා, එකතු කරන ලද මාණුව, හෝ ADL දැනගත නොහැක." }
}

සාධාරණ සටහන: සෑම ප්රක්ෂේපිත අංකයක්ම සැබෑ DB කියවීම් වලින් ලබා ගනී; අසාර්ථක වූ විට කිසිවක් නිර්මාණය කර නැත. අනුගමනය නොකරන සංකේතයක්, පැරණි ස්නැප්ෂොට්, හෝ නැතිවූ මිල ප්රතිචාරයක් ok: true, empty: true සරල ඉංග්රීසි පණිවිඩයක් සමඟ, ව්යාජ තීරු නොවේ. realized_context සජීවී බලහත්කාර ද්රවීකරණ ප්රවාහයෙන් ලබා ගන්නා තරුණ, වර්ධනය වන නියැදියකි, ප්රස්ථාරයක් ලෙස පමණක් පෙන්වනු ලැබේ — එය කිසි විටෙකත් ප්රක්ෂේපනය "සාක්ෂාත් කරන" නොකරයි.

GET /v1/wallet/{addr}/profile

ලබා ගත හැකි: නොමිලේ සත්යාපනය අවශ්ය නැත (එක් IP අනුව සීමා කර ඇත)

අන්තර්-ස්ථානයක පසුම්බියේ පැතිකඩ සජීවී අනුගමනය කරන තල්මසුන්ගේ ස්ථාන ස්නැප්ෂොට් වලින් සම්පූර්ණයෙන්ම ගොඩනගා ඇත. අනුගමනය කරන Hyperliquid තල්මසුන් සඳහා, වත්මන් විවෘත ස්ථාන, අසාක්ෂාත් PnL / නිරාවරණය / ස්ථාන-ගණන කාල අනුක්රමය, OPEN/CLOSE/FLIP ක්රියාකාරකම් කාලරේඛාව (අනුක්රමික ස්නැප්ෂොට් වල වෙනස්කම් කිරීමෙන් නැවත ගොඩනගා ඇත), විකේතනය කරන ලද HL-නායක පුවරු ලේබලය, සහ විවෘත පොත සාරාංශය. සජීවී පිටුව: wallet-profiler.html.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
addrඅවශ්ය	පේළිය	පසුම්බි ලිපිනය (මාර්ග ඛණ්ඩය), උදාහරණයක් ලෙස `/v1/wallet/0x3bcae23e…/profile`.
දිනවිකල්ප	පූර්ණ සංඛ්යාව	කාල අනුක්රමය සහ කාලරේඛාව සඳහා පසුපස ජනෙල්. පෙරනිමිය: `30`.

ඉල්ලීමේ උදාහරණය

GET (සත්යාපනය නැත)

curl "https://api.smartmoneyapi.com/v1/wallet/0x3bcae23e8c380dab4732e9a159c0456f12d866f3/profile?days=30"

ප්රතිචාර උදාහරණය

JSON

{
 "ok": true, "wallet": "0x3bcae23e…", "tracked": true,
 "first_seen_ts": 1782827733, "latest_snapshot_ts": 1783418468, "as_of": 1783418468,
 "hyperliquid": {
 "label": { "name": "Andre is back", "score": 74,
 "window_pnl_usd": 1307000, ජයග්‍රහණ අනුපාතය ප්‍රතිශතය: 71, වෙළඳාම්: 42 },
 ස්ථාන: [
      { ස්ථානය: හයිපර්ලික්විඩ්, සංකේතය: ETH, දිශාව: කෙටි,
 ප්‍රමාණය: 1200.0, ඇතුළත් වීමේ මිල: 1800.0, අසාධාරණ ලාභය: 34800.0,
 ලෙවරේජ්: 20.0, අගය USD: 2160000.0 }
    ],
 මාලාව: [ { ts: 1783330000, අසාධාරණ ලාභය: 42000.0, අනාවරණය USD: 18400000.0, ස්ථාන: 5 } ],
 කාලරේඛාව: [ { ts: 1783400000, සිදුවීම: පෙරළුම, සංකේතය: ETH,
 දිශාව: කෙටි, පෙර දිශාවෙන්: දිගු, අගය USD: 2160000.0 } ],
 සාරාංශය: {
 විවෘත ස්ථාන: 5, ලාභයෙන්: 3, අලාභයෙන්: 2, දිගු: 0, කෙටි: 5,
 සම්පූර්ණ අසාධාරණ ලාභය: -12000.0, සම්පූර්ණ අනාවරණය USD: 21000000.0, මිශ්‍ර ලෙවරේජ්: 19.9,
 කවුළු දින: 30, කවුළුව තුළ ඡායාරූප: 474,
 සාධාරණ ලාභය: None, සාධාරණ ලාභය සටහන: අවකලනය කළ නොහැක — විවෘත ඡායාරූප පමණක් දක්නට ලැබේ, කිසිවිටෙකත් වසා දැමීම් නැත.
    }
  }
}

සාධාරණ සටහන: සියල්ල පෙන්වා ඇත්තේ සැබෑ ඡායාරූප දත්ත වලින් — pnl HL හිමි අසාධාරණ වෙළඳපොල සලකුණු කිරීම, value_usd විවෘත නොට්ෂනල්. රවුන්ඩ්-ට්‍රිප් එකකට සාධාරණ P&L ලබා ගත නොහැක (අපි විවෘත ඡායාරූප පමණක් දකිමු, කිසිවිටෙකත් වසා දැමීම් නැත) සහ පෙන්වා ඇත්තේ null / —; කාලරේඛාව CLOSE සිදුවීම් වලට P&L අයිතියක් නැත. වලංගු නමුත් නොඅධික්‍ෂිත ලිපිනයක් ආපසු එයි tracked: false සටහනක් සමඟ; අවලංගු ලිපිනයක් ආපසු එයි ok: false, error: "invalid_address" (HTTP 400). HL-නායකයාගේ ලේබලය HL හිමි කවුළුව සොයා ගැනීමේදී ඇති අංශයකි, අප විසින් ගණනය කර නැත.

GET /flows

අවශ්‍ය: Pro

BTC, ETH, සහ SOL අතර බහු කාල කවුළුවල ධන ධාරාව දත්ත පෙන්වයි. ඕනෑම මොහොතක ධනය රැස් කරන ඇසට් සහ බෙදා හරින ඇසට් හඳුනා ගැනීමට ප්‍රයෝජනවත් වේ.

උදාහරණ ප්‍රතිචාරය

JSON

{
 ts: 1710940821,
 flows: {
 BTC: { 1h: 142000000, 4h: 380000000, 12h: -90000000, 24h: 220000000 },
 ETH: { 1h: -38000000, 4h: -110000000, 12h: 55000000, 24h: -80000000 },
 SOL: { 1h: 12000000, 4h: 29000000, 12h: 18000000, 24h: 44000000 }
  },
 පෙරළීම් හඳුනාගත්තා: [
 ETH සිට BTC වෙත ධන ධාරාව 4h කවුළුව තුළ,
 සියලුම කවුළුවල SOL රැස් කිරීම ස්ථාවරයි
  ]
}

Pro සැලැස්ම අවශ්‍යයි. ධාරා අගයන් යනු USD නෙට් ආදායම (ධනාත්මක) හෝ අපදායම (ඍණාත්මක) කාල කවුළුවකට අනුව.

GET /whale-events

අවශ්‍ය: වෙළෙන්දා Pro

අධික්‍ෂිත බඩු සහ චේන් ලිපින තුළ නිශ්චිත පසුපස කවුළුව තුළ හඳුනාගත් සැලකිය යුතු තල්මසුන් ස්ථාන වෙනස් — විවෘත, වසා දැමීම්, සහ දිශා පෙරළීම් — ආපසු එයි.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
සංකේතයවිකල්ප	පේළිය	ඇසට් අනුව පෙරහන් කරන්න. සියලුම නිරීක්ෂිත ඇසට් සඳහා ඉවත් කරන්න.
සැලකිය යුතුකමවිකල්ප	පේළිය	සිදුවීම් සැලකිය යුතුකම අනුව පෙරහන් කරන්න: `high`, `medium`, හෝ `all`. පෙරනිමිය: `all`
පැයවිකල්ප	නිඛිල	පසුපස කවුළුව පැය තුළ. පෙරනිමිය: `24`

උදාහරණ ප්‍රතිචාරය

JSON

{
 සංකේතය: BTC,
 සාරාංශය: {
 දිගු වෙත පෙරළීම්: 3,
 කෙටි වෙත පෙරළීම්: 1,
 නව විවෘත: 7,
 වසා දැමීම්: 2
  },
 සිදුවීම්: [
    {
 "type": "flip_long",
 "wallet": "0xWhale...a4f2",
 "direction": "long",
 "size_usd": 4200000,
 "ts": 1710938400
    }
  ]
}

වෙළෙන්දා සැලැස්ම: ප්‍රතිලාභ ලබා දෙන්නේ summary වස්තුව පමණි. Pro සැලැස්ම: සම්පූර්ණ events පෝෂණය අතරට wallet හඳුනාගැනීම්, ප්‍රමාණ, සහ කාල සටහන් ඇතුළත් වේ.

GET /regimes/history

අවශ්‍යයි: Pro

දී ඇති වත්කමක් සඳහා ඓතිහාසික පාලන ක්‍රම වර්ගීකරණ දත්ත ලබා දෙයි. විශේෂිත පාලන ක්‍රම වර්ග ඓතිහාසිකව කෙසේ ක්‍රියා කර ඇත්ද, එක් එක් පාලන ක්‍රම වර්ගය සාමාන්‍යයෙන් කොපමණ කාලයක් පවතීද, සහ පාලන ක්‍රම සංක්‍රමණ කාලයත් සමඟ කෙසේ පැහැදිලි වේද යන්න පරීක්ෂා කිරීමට මෙය භාවිතා කරන්න.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
"symbol"විකල්ප	string	වත්කම් සංකේතය. පෙරනිමිය: `BTC`
"regime"විකල්ප	string	විශේෂිත පාලන ක්‍රම වර්ගයකට පෙරහන් කරන්න, උදා. `late_cycle_divergence`. සියලු පාලන ක්‍රම සඳහා ඉවත් කරන්න.
"days"විකල්ප	integer	දින වලින් පසුපස බලන්න. පෙරනිමිය: `30`. උපරිම: `365`

උදාහරණ ප්‍රතිචාරය

JSON

{
 "symbol": "BTC",
 "current_regime": "late_cycle_divergence",
 "regime_summary": {
 "late_cycle_divergence": { "occurrences": 4, "avg_duration_h": 38, "avg_return_pct": -2.1 },
 "accumulation": { "occurrences": 6, "avg_duration_h": 72, "avg_return_pct": 5.4 },
 "breakout": { "occurrences": 3, "avg_duration_h": 18, "avg_return_pct": 9.2 }
  },
 "transitions": [
    { "from": "accumulation", "to": "breakout", "ts": 1710850000 },
    { "from": "breakout", "to": "late_cycle_divergence", "ts": 1710915000 }
  ]
}

Pro සැලැස්ම අවශ්‍යයි. සංයෝජනය කරන්න /analysis ඓතිහාසික පාලන ක්‍රම කාර්ය සාධන දත්ත සමඟ උපායමාර්ගික උපකල්පන සත්‍යාපනය කිරීමට.

GET /exchange-health

ලබා ගත හැක්කේ: නොමිලේ වෙළෙන්දා Pro

සියලුම නිරීක්ෂණය කරන ගණුදෙනු කේන්ද්‍ර සඳහා තත්ව ප්‍රතිලාභ ලබා දෙයි, එයට එක් එක් ගණුදෙනු කේන්ද්‍රය සඳහා ප්‍රමාදය, දෝෂ අනුපාත, සහ දත්ත පරණ අංක ඇතුළත් වේ. සත්‍යාපනය අවශ්‍ය නැත — ප්‍රසිද්ධ ප්‍රවේශයට ලක්වන අන්ත ලක්ෂ්‍යය.

උදාහරණ ප්‍රතිචාරය

JSON

{
 "overall_status": "ok",
 "ts": 1710940821,
 "exchanges": {
 "bybit": { "status": "ok", "latency_ms": 42, "error_rate_1h": 0.0, "last_data_age_s": 18 },
 "binance": { "status": "ok", "latency_ms": 38, "error_rate_1h": 0.0, "last_data_age_s": 22 },
 "hyperliquid": { "status": "degraded", "latency_ms": 310, "error_rate_1h": 0.04, "last_data_age_s": 95 },
 "okx": { "status": "ok", "latency_ms": 55, "error_rate_1h": 0.0, "last_data_age_s": 30 }
  }
}

GET /sentiment

අවශ්‍යයි: වෙළෙන්දා Pro

ව්‍යුත්පන්න චේතනාව, තල්මසුන් ක්‍රියාකාරකම්, අස්ථාවරත්වය, සහ සමාජ සංඥා වලින් ගණනය කරන ලද තත්වාන්විත බිය සහ ලෝභ දර්ශකය (0-100) ලබා දෙයි. ප්‍රවණතා විශ්ලේෂණය සඳහා සංරචක බිඳ වැටීම සහ පැය 24 ඉතිහාසය ඇතුළත් වේ.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
"symbol"විකල්ප	string	වත්කම් සංකේතය. පෙරනිමිය: `BTC`

උදාහරණ ප්‍රතිචාරය

JSON

{
 "symbol": "BTC",
 "score": 72,
 "label": "Greed",
 "components": {
 "volatility": 65,
 "momentum": 78,
 "derivatives": 70,
 "whale_activity": 75,
 "social": 68
  },
 "history_24h": [
    { "ts": 1710940800, "score": 68, "label": "Greed" },
    { "ts": 1710937200, "score": 65, "label": "Greed" }
  ],
 "ts": 1710940821
}

අභියෝගකාරී සමාන: Santiment Social Volume + Alternative.me Fear & Greed — තනි අන්ත ලක්ෂයකට ඒකාබද්ධ කර ඇති සංරචක බිඳ දැමීම සමඟ.

අනුකලනයන්

GET /tradingview/setup

අවශ්‍ය: වෙළෙන්දා Pro

ඔබගේ පුද්ගලීකරණය කරන ලද TradingView අනුකලන සැකසුම ආපසු ලබා දෙයි: වෙබ්හුක් URL, සත්‍යාපනය සඳහා රහස්, සහ Smart Money API සමඟ සෘජුවම සම්බන්ධ වන පයින් ස්ක්‍රිප්ට් දර්ශක. අපගේ සංඥා ඕනෑම ප්‍රස්තාරයක් මත අතිච්ඡාදනය කිරීමට TradingView වෙත පයින් ස්ක්‍රිප්ට් පිටපත් කර ඇලවීම.

උදාහරණ ප්‍රතිචාරය

JSON

{
 "webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
 "webhook_secret": "tvs_a1b2c3...",
 "pine_scripts": {
 "composite_indicator": "// Smart Money Composite v1
//@version=5
indicator(...)...",
 "whale_activity": "// Whale Activity Overlay v1
...",
 "funding_dashboard": "// Funding Rate + LSR Dashboard v1
..."
  }
}

POST /tradingview/webhook

ලබා ගත හැක්කේ: වෙළෙන්දා Pro

TradingView ඇඟවීමක් ලබා ගන්නා අතර, එය හරහා ධාවනය කරයි /confirm, සහ තහවුරු කිරීම ආපසු ලබා දෙයි. TradingView අභිරුචි ශීර්ෂ යැවිය නොහැක, එබැවින් ඔබගේ වෙබ්හුක් රහස් secret JSON ශරීරය තුළ ඇතුළත් කිරීමෙන් සත්‍යාපනය කරන්න (මෙම අන්ත ලක්ෂය X-API-Key භාවිතා නොකරයි). ප්‍රතිචාරය තහවුරු කිරීම ඔතා ගෙන යන අතර ඉහළ මට්ටමේ action එකතු කරයි CONFIRMED (daemon confidence HIGH/MEDIUM) හෝ VETOED.

ඉල්ලීමේ ශරීරය

JSON

{
 "secret": "your_webhook_secret",
 "symbol": "BTC",
 "direction": "long",
 "timeframe": "1h",
 "strategy": "EMA crossover",
 "price": 67500.0
}

අවශ්‍ය: secret, symbol, direction (long|short). විකල්ප: source, timeframe, strategy, price.

පුද්ගලීකරණය

GET /preferences

අවශ්‍ය: වෙළෙන්දා Pro

පෙරනිමි වෙළඳ පරාමිතීන්, අවදානම් පැතිකඩ, නිරීක්ෂණ ලැයිස්තුව සහ දැනුම්දීමේ අභිප්‍රේත සමඟ ඔබගේ වර්තමාන පුද්ගලීකරණ සැකසුම් ආපසු ලබා දෙයි.

PUT /v1/preferences

පහත ක්ෂේත්‍රවල ඕනෑම උප කුලකයක් JSON ශරීරයක් යැවීමෙන් අභිප්‍රේත යාවත්කාලීන කරන්න. ඉවත් කරන ලද ක්ෂේත්‍ර ඔවුන්ගේ වර්තමාන අගයන් රඳවා ගනී.

අභිප්‍රේත ක්ෂේත්‍ර

ක්ෂේත්‍රය	වර්ගය	විස්තරය
default_trade_size_usd	float	Kelly සහ smart-stop ගණනය කිරීම් සඳහා USD හි පෙරනිමි ස්ථාන ප්‍රමාණය
risk_tolerance	string	`conservative`, `moderate`, හෝ `aggressive`
default_risk_pct	float	ගිණුමේ % ලෙස පෙරනිමි වෙළඳ අවදානම. භාවිතා කරනු ලබන්නේ `/smart-stop` විට `risk_pct` ඉවත් කර ඇත
watchlist	array	වත්කම් සංකේතවල ඇණවුම් කළ ලැයිස්තුව, උදා. `["BTC","ETH","SOL"]`
notification_email	string	ඇඟවීම් ලබා දීම සඳහා ඊමේල් ලිපිනය
timezone	string	IANA timezone string, උදා. `America/New_York`

PUT — උදාහරණ ශරීරය

{
 "default_trade_size_usd": 5000,
 "risk_tolerance": "moderate",
 "default_risk_pct": 1.5,
 "watchlist": ["BTC", "ETH", "SOL"]
}

GET /watchlist

අවශ්‍ය වන්නේ: වෙළෙන්දා ප්‍රෝ

ඔබ වින්‍යාසගත කර ඇති නිරීක්ෂණ ලැයිස්තුවේ ඇති සියලුම සංකේත සඳහා තහවුරු කිරීමේ තත්ත්වයේ කෙටි සටහනක් සහ ප්‍රධාන අවදානම් මිණුම් ලබා දෙයි. එක් එක් සංකේතය සඳහා වෙන වෙනම ඇමතුම් නොකර බහු-සම්පත් දළ විශ්ලේෂණයක් සපයයි. /confirm වෙන වෙනම සංකේත සඳහා.

උදාහරණ ප්‍රතිචාරය

JSON

{
 "ts": 1710940821,
 "watchlist": [
    {
 "symbol": "BTC",
 "confidence": "HIGH",
 "action": "CONFIRM",
 "regime": "accumulation",
 "cascade_risk": "LOW"
    },
    {
 "symbol": "ETH",
 "confidence": "MEDIUM",
 "action": "REDUCE",
 "regime": "late_cycle_divergence",
 "cascade_risk": ඉහළ
    },
    {
 සංකේතය: SOL,
 විශ්වාසය: ඉහළ,
 ක්‍රියාව: තහවුරු කරන්න,
 රජය: බිඳ වැටීම,
 ඇලීමේ අවදානම: මධ්‍යම
    }
  ]
}

තත්පර-තත්පර ප්‍රවාහය (සජීවී හුවමාරු)

අපගේම BSC සහ Avalanche නෝඩ් වලින් තත්පර-තත්පර අනාවරණය වන DEX හුවමාරු $500 ට වැඩි ප්‍රවාහය. ප්‍රවාහ දෙකක් ලබා ගත හැකිය: නොමිලේ/බ්‍රවුසර් ගනුදෙනුකරුවන් සඳහා පොදු Server-Sent Events (SSE) ප්‍රවාහයක් සහ ගෙවන තල සඳහා අඩු ප්‍රමාදයක් සහිත WebSocket ගිනි නලයක්. සිදුවීම් අවරෝධනය වීමෙන් තත්පර කිහිපයක් තුළ ප්‍රචාරය වේ.

පොදු SSE ප්‍රවාහය (නොමිලේ)

ලබා ගත හැක්කේ: නොමිලේ වෙළෙන්දා Pro

GET /v1/stream/public-swaps

සත්‍යාපනය අවශ්‍ය නොවේ. ස්වදේශික EventSource සියලු නවීන බ්‍රවුසර් වල සහය. සේවාදායකය සිදුවීම් swap සහ ආවර්තිතා හෘද ස්පන්දන ප්‍රකාශයට පත් කර සම්බන්ධතාවය සජීවීව තබා ගනී.

JavaScript (බ්‍රවුසර්)

const es = new EventSource(https://api.smartmoneyapi.com/v1/stream/public-swaps);
es.addEventListener("swap", e => {
  const swap = JSON.parse(e.data);
  console.log(swap.chain, swap.pair, swap.amount_usd);
});

WebSocket Firehose (Paid)

අවශ්‍යයි: Trader Pro

WSS /v1/ws/live-swaps?ticket=…

සත්‍යාපනය (නිර්දේශිත): කිසිවිටෙකත් ඔබේ දිගුකාලීන යතුර URL එකේ තබන්න එපා — එය ප්‍රොක්සි මගින් ලොග් කරනු ලබන අතර බ්‍රවුසර ඉතිහාසයේ සුරකිනු ලැබේ. ඒ වෙනුවට ඔබේ යතුර POST කරන්න /v1/ws/ticket සුරක්ෂිත භාවිතා කරමින් X-API-Key header, ඉන්පසු ලබා දෙන එක් වර භාවිතය සඳහා සොකට් එක විවෘත කරන්න ticket (වලංගු ~60s, එක් වරක් භාවිතා කරනු ලැබේ). සර්වර් පැත්තේ ක්ලයන්ට් අතින් හෙඩර් සකස් කළ හැකි නම්, ඒ වෙනුවට අතින් යොමු කළ හැකිය X-API-Key සෘජුවම හසුරුවීමේදී. නිදහස් තල යතුරු සඳහා ලැබෙන්නේ 402 payment_required ප්‍රතිචාරයකි. A hello frame එක සම්බන්ධ වන විට ඔබේ තලය සහ විකාශන අවධි අගය සමඟ යවනු ලැබේ.

JavaScript (browser)

// 1. ඔබේ යතුර කෙටි කාලීන ටිකට් එකක් සඳහා හුවමාරු කරන්න (යතුර header එකේ රඳවා තබා ගනී)
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
  method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. එක් වර භාවිතය සඳහා ටිකට් එක සමඟ සොකට් එක විවෘත කරන්න
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
  const swap = JSON.parse(e.data);
  if (swap.type === "swap") console.log(swap);
};

WebSocket සත්‍යාපනය (ටිකට්)

ඇයි: කිසිවිටෙකත් ඔබේ API යතුර WebSocket URL එකේ තබන්න එපා — query strings ප්‍රොක්සි, load balancers, සහ බ්‍රවුසර ඉතිහාසයේ ලොග් කරනු ලබයි. ඒ වෙනුවට, ඔබේ යතුර කෙටි කාලීන, එක් වර භාවිතය සඳහා ticket සාමාන්‍ය සත්‍යාපනය කළ POST එකක් මගින් හුවමාරු කරන්න, ඉන්පසු එම ටිකට් එක සමඟ සම්බන්ධ වන්න.

ප්‍රවාහය: POST to /v1/ws/ticket ඔබේ සමඟ X-API-Key header → ලබා ගන්න { "ticket": "…", "expires_in": 60 }. ඉන්පසු විවෘත කරන්න wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. The ticket is තනිවර්තී සහ කල් ඉකුත් වන්නේ ~60 seconds. Server-side clients that can set request headers may instead pass X-API-Key directly on the WebSocket handshake — no ticket needed.

POST /v1/ws/ticket

අවශ්‍යයි: Trader Pro

Mints a one-time ticket for an authenticated WebSocket handshake. Authenticate with the X-API-Key header (your key never leaves the request headers). The returned ticket can be redeemed once on /v1/ws/live-swaps before it expires.

cURL

curl -X POST -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/ws/ticket"

Example Response

JSON

{
 "ticket": "wst_9f3c1a8e4b2d…",
 "expires_in": 60
}

Response Fields

Field	Type	Description
ticket	string	Single-use token to append as `?ticket=` on the WebSocket URL. Redeemed once, then invalidated.
expires_in	number	Seconds until the ticket expires (~60). Mint a fresh ticket per connection attempt.

Note: the legacy ?key= query-param authentication is no longer accepted on WebSocket endpoints for security reasons. Use a ticket (browser clients) or the X-API-Key handshake header (server-side clients).

REST Snapshot

GET /v1/live-swaps/recent?limit=20

Returns the last N broadcast swaps from the rolling buffer. Useful for first-paint on dashboards before the stream connection opens. Also available: /v1/live-swaps/status for broadcaster stats.

Event Schema

Field	Type	Description
chain	string	`bsc` or `avalanche`
dex	string	Router name (e.g. `pancakeswap_v2`, `traderjoe`) or `unknown_dex`
swapper	string	Full 0x address of the wallet that executed the swap
swapper_short	string	Abbreviated form for display (e.g. `0xb300…028d`)
swapper_url	string	Direct link to the swapper on the chain's block explorer
tx_hash	string	Transaction hash
explorer_url	string	Direct link to the transaction on BscScan / Snowtrace
token_in	string	Symbol of the token sold (e.g. `USDT`)
token_out	string	Symbol of the token bought
amount_usd	number	USD value of the swap (minimum: $500)
pair	string	Formatted pair label (e.g. `USDT → USDC`)
block	number	Block number where the swap was mined
timestamp	number	Unix epoch seconds
significance	string	`low` / `medium` / `high` / `critical` based on USD size
seq	number	Monotonic broadcast sequence number — use for gap detection

POST /alerts/conditions

අවශ්‍යයි: Pro

Create custom alert rules that trigger when a specified metric crosses a threshold. Alerts are delivered via webhook, email, or the dashboard notification feed depending on your preferences.

GET /v1/alerts/conditions

Returns a list of all your configured alert conditions with their IDs, definitions, and current status.

DELETE /v1/alerts/conditions/{id}

Permanently removes an alert condition by its ID.

GET /v1/alerts/history

Returns recent alert trigger events with timestamps, matched conditions, and the metric value at the time of trigger.

Create Alert — Request Body

Field	Type	Description
namerequired	string	මෙම ඇඟවීම සඳහා මිනිස්-කියවිය හැකි ලේබලය (උපරිම අක්ෂර 64)
metricrequired	string	මුරකාරීව නිරීක්ෂණය කිරීමට මෙට්‍රික්. පහත ඇති ලබා ගත හැකි මෙට්‍රික් වගුව බලන්න.
symboloptional	string	ඇසට් සන්දර්භය. සංකේත-විෂය පථයේ මෙට්‍රික් සඳහා අවශ්‍යයි `funding_rate`.
operatorrequired	string	සංසන්දන ක්‍රියාකාරකය: `gt`, `lt`, `eq`, `crosses_above`, `crosses_below`
thresholdrequired	float	මෙට්‍රික් සමඟ සංසන්දනය කිරීමට සංඛ්‍යාත්මක අගය
deliveryoptional	string	භාරදීම් නාලිකාව, උදා. `telegram` (default) or `webhook`
cooldown_minutesoptional	integer	නැවත-ප්‍රේරණයන් අතර අවම මිනිත්තු (පෙරනිමි 60)

ලබා ගත හැකි වලංගු මෙට්‍රික් සහ ක්‍රියාකාරකයන්ගේ සජීවී ලැයිස්තුව ආපසු ලබා දෙනු ලැබේ GET /v1/alerts/conditions as available_metrics and available_operators.

ලබා ගත හැකි මෙට්‍රික්

මෙට්‍රික්	විස්තරය
funding_rate	සංකේතය සඳහා වත්මන් අරමුදල් අනුපාතය (දශමයක් ලෙස)
global_lsr	සංකේතය සඳහා ගෝලීය දිග/කෙටි අනුපාතය
long_pct	සංකේතය සඳහා නෙට් දිග ගිණුම්වල ප්‍රතිශතය
top_trader_lsr	සංකේතය සඳහා ඉහළම වෙළෙන්දාගේ දිග/කෙටි අනුපාතය
taker_ratio	සංකේතය සඳහා ගැනුම්කරු/විකුණුම්කරු අනුපාතය
mvrv	වෙළඳපල අගය සිට සාක්ෂාත් කරගත් අගය අනුපාතය (BTC/ETH)
sopr	භාවිතා කළ ප්‍රතිදාන ලාභ අනුපාතය (BTC/ETH)
exchange_net_flow	චේන් මත විනිමය ජාල ගලා යාමේ සංඥාව
accumulation	චේන් මත සමුච්චය සංඥාව
whale_long_pct	සංකේතය සඳහා දිගු ස්ථාන රඳවා ගත් ලුහුබැඳි තල්මසුන්ගේ ප්‍රතිශතය
whale_n_wallets	සංකේතයේ ස්ථානයක් ඇති ලුහුබැඳි තල්මසුන්ගේ සංඛ්‍යාව
composite_long	දිගු දිශාවෙන් විමසූ සංකේතය සඳහා සංයුක්ත ලකුණු
composite_short	කෙටි දිශාවෙන් විමසූ සංකේතය සඳහා සංයුක්ත ලකුණු
funding_spread	සංකේතය සඳහා හරස්-ස්ථාන අරමුදල් පැතිරීම

POST — Example Body

{
 "name": "BTC funding rate spike",
 "metric": "funding_rate",
 "symbol": "BTC",
 "operator": "gt",
 "threshold": 0.05
}

GET /kelly

Requires: Pro

ලබා දී ඇති සංකේතය, විශ්වාසනීය මට්ටම සහ දිශාව සඳහා ඓතිහාසික සංඥා කාර්ය සාධනයට සකස් කරන ලද කෙලි නිර්දේශනයන් ආපසු ලබා දෙයි. අධික ලෙවරේජ් කිරීම වැළැක්වීම සඳහා ජයග්‍රහණ අනුපාතවල පදනම් වූ ස්ථාන ප්‍රමාණය.

Parameters

Parameter	Type	Description
symbolrequired	string	ඇසට් සංකේතය: `BTC`, `ETH`, or `SOL`
confidenceoptional	string	මාදිලියට සංඥා විශ්වාසනීය මට්ටම: `HIGH`, `MEDIUM`, or `LOW`. Default: `HIGH`
directionoptional	string	වෙළඳ දිශාව: `long` or `short`. Default: `long`
account_sizeoptional	float	ගණනය කිරීම සඳහා USD හි ගිණුම් ප්‍රමාණය `suggested_size_usd`. Default: `10000`

Example Response

JSON

{
 "symbol": "BTC",
 "confidence": "HIGH",
 "direction": "long",
 "win_rate": 0.68,
 "avg_reward_risk_ratio": 2.1,
 "kelly_fraction": 0.36,
 "half_kelly": 0.18,
 "suggested_size_usd": 1800,
 "samples": 142,
 "note": "Half-Kelly recommended for live trading to account for estimation error."
}

Pro සැලැස්ම අවශ්යයි. ගණනය කිරීම් ඉල්ලූ සංකේතය, විශ්වාසය සහ දිශා පරාමිතීන් සමඟ ගැලපෙන ඓතිහාසික සංඥා වල රෝලිං දින 90 ක නියැදිය මත පදනම්ව ගණනය කෙරේ.

GET /performance

භාවිතා කළ හැක්කේ: Free Trader Pro

API මගින් නිකුත් කරන ලද සංඥා සඳහා ඓතිහාසික නිරවද්යතා සංඛ්යාලේඛන විශ්වාසනීය මට්ටම් අනුව විස්තර කර ඇත. ධනය ආයෝජනය කිරීමට පෙර සංඥා විශ්වසනීයත්වය තේරුම් ගැනීමට ප්රයෝජනවත් වේ.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
symbolවිකල්ප	string	සම්පත් අනුව පෙරහන් කරන්න. සියලු සංකේත සඳහා සාරාංගික සංඛ්යාලේඛන සඳහා ඉවත් කරන්න.
daysවිකල්ප	integer	දින වලින් පසුපස බැලීමේ කවුළුව. පෙරනිමිය: `30`

උදාහරණ ප්රතිචාරය

JSON

{
 "symbol": "BTC",
 "period_days": 30,
 "by_confidence": {
 "HIGH": { "win_rate": 0.71, "samples": 58, "avg_return_pct": 3.4 },
 "MEDIUM": { "win_rate": 0.54, "samples": 84, "avg_return_pct": 1.2 }
  }
}

සංඛ්යාලේඛන සහ සංඥා

GET /v1/stats

භාවිතා කළ හැක්කේ: Free Trader Pro සත්යාපනය අවශ්ය නැත

වෙබ් අඩවිය පුරා සත්ය සාර්ථකත්ව සංඛ්යාලේඛන ලබා ගන්නේ smart_money_confirm වෙනස්-කෝල් ප්රතිඵල වලින්. HIGH සහ MEDIUM විශ්වාසනීය මට්ටම් වල ජය අනුපාත, සමස්ත නිරවද්යතාව, ලාභ සාධකය සහ සංකේතයකට අනුව විස්තර කිරීමක් ආපසු ලබා දෙයි. සියලු අගයන් ලකුණු කිරීමේ කවුළුව තුළ නියැදියේ ඇත; සන්දර්භය සහ ඉදිරි-හෝල්ඩ්වුට් ක්රමවේදය සඳහා calibration.html බලන්න.

උදාහරණ ප්රතිචාරය

JSON

{
 "high_winrate": 0.714,
 "high_winrate_n": 14,
 "medium_winrate": 0.530,
 "medium_winrate_n": 34,
 "overall_accuracy": 0.613,
 "overall_accuracy_n": 48,
 "profit_factor": 1.77,
 "avg_win_pct": 4.2,
 "winrate_horizon": "24h",
 "winrate_basis": "distinct confirm calls, 24h resolved outcomes",
 "winrate_by_symbol": {
 "BTC": { "win_rate": 0.68, "n": 22 },
 "ETH": { "win_rate": 0.55, "n": 18 },
 "SOL": { "win_rate": 0.60, "n": 8 }
  },
 "forward_holdout": {
 "win_rate": 0.59,
 "high_win_rate": 0.70,
 "high_n": 10,
 "is_distinct_from_insample": false
  }
}

නියැදි තුළ ඇති ආචාර ගුප්තය. මෙම ප්රතිචාරයේ සියලු අගයන් ගණනය කර ඇත්තේ ලකුණු කරන්නා සකස් කිරීමට භාවිතා කළ කාල පරිච්ඡේදයේ සිට ය. forward_holdout object යනු ලකුණු කරන්නා කිසිදා නොදුටු දත්ත මත රැස් කරන ලද එකම අංකයයි — කාලයත් සමඟ එය වර්ධනය වන ආකාරය නරඹන්න. සම්පූර්ණ ක්රමවේදය සහ නියැදි තුළ / ඉදිරි පරීක්ෂණ සීමාව සඳහා calibration.html බලන්න.

GET /v1/signals/performance

භාවිතා කළ හැක්කේ: Free Trader Pro සත්යාපනය අවශ්ය නැත

බහු අවබෝධ කාල සීමාවන් (4h, 12h, 24h, 72h) හරහා සංඥා ප්රතිඵල ගම්යතාව. එක් එක් අවබෝධ කාල සීමාව සඳහා පහර අනුපාත, සම්පූර්ණ සංඥා ගණන සහ සංඥා වර්ගය අනුව විස්තර කිරීමක් ආපසු ලබා දෙයි.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
daysවිකල්ප	integer	දින වලින් පසුපස බැලීමේ කවුළුව. පෙරනිමිය: `30`
signal_typeවිකල්ප	string	වර්ගය අනුව පෙරහන් කරන්න, උදා. `smart_money_confirm` or `regime_flip`. සියලු වර්ග සඳහා ඉවත් කරන්න.
symbolවිකල්ප	string	සම්පත් සංකේතය අනුව පෙරහන් කරන්න, උදා. `BTC`. සියලු සංකේත සඳහා සාරාංගික අගය සඳහා ඉවත් කරන්න.

උදාහරණ ප්රතිචාරය

JSON

{
 "signal_type": "smart_money_confirm",
 "symbol": "BTC",
 "days": 30,
 "total_signals": 48,
 ක්ෂිතිජ: {
 4h: { පහර අනුපාතය: 0.65, තීරණය කරන ලද: 46 },
 12h: { පහර අනුපාතය: 0.61, තීරණය කරන ලද: 44 },
 24h: { පහර අනුපාතය: 0.58, තීරණය කරන ලද: 40 },
 72h: { පහර අනුපාතය: 0.54, තීරණය කරන ලද: 32 }
  },
 වර්ගීකරණය බිඳ දැමීම: {
 ස්මාර්ට් මනි තහවුරු කිරීම: { ගණන: 35, පහර අනුපාතය_24h: 0.61 },
 පාලන තත්ත්වය වෙනස් වීම: { ගණන: 13, පහර අනුපාතය_24h: 0.47 }
  }
}

GET /v1/signals/recent

ලබා ගත හැකි: Free Trader Pro සත්‍යාපනය අවශ්‍ය නැත

සියලුම නිරීක්ෂණය කරන සංකේත ඔස්සේ මෑතක්හි ප්‍රකාශයට පත් කරන ලද HIGH සහ MEDIUM සංඥා ගැනීම. සංඥා වර්ගය, විශ්වාසනීයත්වය, දිශාව සහ තීරණ තත්ත්වය ඇතුළත් වේ.

උදාහරණ ප්‍රතිචාරය

JSON

{
 signals: [
    {
 id: 1042,
 symbol: BTC,
 direction: long,
 signal_type: smart_money_confirm,
 confidence: HIGH,
 composite: 0.74,
 ts: 1710940821,
 resolved: true,
 outcome_24h: win
    }
  ],
 count: 50
}

GET /v1/signals/{id}/outcome

ලබා ගත හැකි: Free Trader Pro සත්‍යාපනය අවශ්‍ය නැත

සංඛ්‍යාත්මක ID එකක් මගින් තනි සංඥාවක් සඳහා තීරණය කරන ලද ප්‍රතිඵලය. එක් එක් තීරණ ක්ෂිතිජයේ (4h, 12h, 24h, 72h) පහර/මිස අතර මිල සංඥා කාලයේ සහ තීරණයේදී ලබා දෙයි.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
idrequired	integer	සංඥා ID (මාර්ග ඛණ්ඩය), උදාහරණයක් ලෙස `/v1/signals/1042/outcome`

උදාහරණ ප්‍රතිචාරය

JSON

{
 id: 1042,
 symbol: BTC,
 direction: long,
 confidence: HIGH,
 entry_price: 63200.0,
 ts: 1710940821,
 outcomes: {
 4h: { result: win, price: 64100.0, pct: 1.41 },
 12h: { result: win, price: 65200.0, pct: 3.16 },
 24h: { result: win, price: 65800.0, pct: 4.11 },
 72h: { result: pending, price: null, pct: null }
  }
}

GET /v1/confirm-winrate

අවශ්‍යයි: Free Trader Pro

සත්‍යාපනය කරන ලද පරිශීලකයාගේම API යතුර සඳහා සංඥා ජය අනුපාත බිඳ දැමීම. එක් එක් විශ්වාසනීයත්වය, ලාභ සාධකය සහ සංකේතයකට අනුව ජය අනුපාත ලබා දෙයි. වලංගු X-API-Key header.

උදාහරණ ඉල්ලීම

cURL

curl -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm-winrate"

උදාහරණ ප්‍රතිචාරය

JSON

{
 high_winrate: 0.714,
 high_n: 14,
 medium_winrate: 0.530,
 medium_n: 34,
 overall_accuracy: 0.613,
 overall_n: 48,
 profit_factor: 1.77,
 winrate_horizon: 24h,
 by_symbol: {
 BTC: { win_rate: 0.68, n: 22 },
 ETH: { win_rate: 0.55, n: 18 }
  }
}

වෙනස් ඇමතුම් පදනම. ජය අනුපාත ගණනය කරනු ලබන්නේ සෑම සංකේතයකටම වෙනස් තහවුරු කිරීමේ ඇමතුමකට (සෑම මිනිත්තු 5 ක කවුළුවකට එක් එක් සංකේතයක්) වේ, සෑම API ඇමතුමකටම නොවේ — මෙය නැවත නැවත පරීක්ෂා කරන බොට් මගින් N-පුළුල් කිරීම වළක්වයි. අංක පෙන්වන්නේ පෙරනිමි දින 30 ක කවුළුව තුළ නියැදිය තුළ ඇත; එම අවවාදය /v1/stats අදාළ වේ.

Shadow Gate

අවශ්යයි: Free Trader Pro

නොවෙනස්, එකතු කිරීම පමණක් කළ හැකි පුද්ගලික තීරණ ලෙඩරයක්. ඔබේ වෙළඳ තීරණ ක්‍රියාත්මක කිරීමට පෙර හෝ පසු ඉදිරිපත් කරන්න; පද්ධතිය Smart Money එන්ජිමට එරෙහිව තහවුරු කිරීමේ ලකුණු ගණනය කර ස්ථිර පේළියක් එකතු කරයි. API හි සංඥා ඔබේ ඇතුළුවීම් සමඟ කෙතරම් හොඳින් ගැලපුණේද යන්න පිළිබඳ අවිචලිත, කාල සටහන්ගත වාර්තාවක් ගොඩනැගීමට එය භාවිතා කරන්න — ගෝලීය ජය අනුපාත පොලෙන් සම්පූර්ණයෙන්ම ස්වාධීනව. Free සහ Trader තල ප්‍රතිචාරවල සාක්ෂි ක්ෂේත්‍ර ඉවත් කර ඇත; Pro සම්පූර්ණ විස්තරය ලබා දෙයි. Free තල දත්තවලට තල ප්‍රමාදයක් අදාළ වේ.

POST /v1/shadow-gate/decisions

තීරණයක් ඉදිරිපත් කරන්න. අනන්‍යතාවය Idempotency-Key ඉල්ලීමේ ශීර්ෂය මත — එකම යතුර නැවත ඉදිරිපත් කිරීමෙන් පවතින පේළිය ආපසු ලබා දෙන අතර අනුපිටපතක් නොතනියි. පද්ධතිය වහාම තහවුරු කිරීමේ එන්ජිම අමතන අතර ප්‍රතිඵලය නොවෙනස් ලෙඩරය පේළියක් ලෙස එකතු කරයි.

Request Body

Field	Type	Description
symbolrequired	string	සම්පත් සංකේතය, උදා. `BTC`
siderequired	string	වෙළඳ දිශාව: `long` or `short`
strategy_idoptional	string	ඇමතුම්කරු අර්ථ දක්වන උපායමාර්ග ලේබලය (උපරිම අක්ෂර 64). කණ්ඩායම් කිරීම සහ පෙරහන් කිරීම සඳහා එලෙසම ගබඩා කර ඇත.

Example Request

cURL

curl -X POST \
 -H "X-API-Key: sm_your_key" \
 -H "Idempotency-Key: my-signal-20260701-001" \
 -H "Content-Type: application/json" \
 -d '{"symbol":"BTC","side":"long","strategy_id":"ema_crossover"}' \
 "https://api.smartmoneyapi.com/v1/shadow-gate/decisions"

Example Response

JSON

{
 "id": 318,
 "symbol": "BTC",
 "side": "long",
 "strategy_id": "ema_crossover",
 "decision": "CONFIRM",
 "confidence": "HIGH",
 "composite": 0.74,
 "size_mult": 1.5,
 ts: 1710940821,
 තීරණය කරන ලදී: false
}

කොටස් සටහන. නොමිලේ සහ වෙළඳුන්ගේ ප්‍රතිචාර වල සාක්ෂි ක්ෂේත්‍ර අත්හැර ඇත. factors / adjustments Pro සම්පූර්ණ තහවුරු කිරීමේ විස්තරය ලබා දෙයි. නොමිලේ සඳහා කොටස් ප්‍රමාදයක් අදාළ වේ - පේළිය වහාම ලියනු ලැබුවද, තහවුරු කිරීමේ ලකුණු ගබඩා කර ඇති දත්ත වලින් තත්පර 60 ක් පැරණි විය හැකිය.

GET /v1/shadow-gate/decisions

ඔබගේම shadow-gate තීරණ ලැයිස්තුගත කරන්න, නවතම ඒවා පළමුව. හිමිකාරිත්වය-සීමා කරන ලද — ඔබගේ API යතුර මගින් ඉදිරිපත් කරන ලද තීරණ පමණක් ලබා දෙනු ලැබේ.

පරාමිතීන්

පරාමිතිය	වර්ගය	විස්තරය
limitවිකල්ප	integer	ප්‍රතිඵලයක් ලෙස ලබා දිය යුතු උපරිම පේළි ගණන. පෙරනිමිය: `50`, උපරිම: `200`
cursorවිකල්ප	string	පෙර ප්‍රතිචාරයකින් ලබාගත් පැහැදිලි නැති පිටු සංක්‍රමණ cursor `next_cursor` ක්ෂේත්‍රය. පළමු පිටුව සඳහා ඉවත් කරන්න.

උදාහරණ ප්‍රතිචාරය

JSON

{
 "decisions": [
    { "id": 318, "symbol": "BTC", පැත්ත: දිගු, තීරණය: තහවුරු කරන්න, විශ්වාසය: ඉහළ, සංයුක්ත: 0.74, ප්‍රමාණය_ගුණකය: 1.5, ටීඑස්: 1710940821, තීරණය කරන ලදී: False },
    { හැඳුනුම්පත: 317, සංකේතය: ETH, පැත්ත: කෙටි, තීරණය: SKIP, විශ්වාසය: LOW, සංයුක්ත: -0.12, size_mult: 0.0, ts: 1710937000, resolved: True }
  ],
 count: 2,
 next_cursor: None
}

GET /v1/shadow-gate/decisions/{id}

ID අනුව තනි තීරණය, Pro tier සඳහා සම්පූර්ණ සාක්ෂි ඇතුළත්ව. Free සහ Trader tier ප්‍රතිචාරවල factors සහ adjustments ඉවත් කර ඇත. ආපසු දෙන්නේ 403 තීරණය වෙනත් API යතුරකට අයත් වේ නම්.

උදාහරණ ප්‍රතිචාරය (Pro)

JSON

{
 id: 318,
 symbol: BTC,
 side: long,
 strategy_id: ema_crossover,
 decision: CONFIRM,
 confidence: HIGH,
 composite: 0.74,
 size_mult: 1.5,
 factors: {
 derivatives: { score: 0.81, weight: 0.40, weighted: 0.324 },
 onchain: { score: 0.68, weight: 0.35, weighted: 0.238 },
 whale: { score: 0.73, weight: 0.25, weighted: 0.183 }
  },
 ts: 1710940821,
 resolved: False,
 outcome: None
}

POST /v1/shadow-gate/decisions/{id}/resolve

තීරණයක ප්‍රතිඵලය අතින් විසඳන්න. වෙළඳාම වසා දැමීමෙන් පසු මෙය ඇමතීමෙන් අවසාන ප්‍රතිඵලය ලෙජර් පේළියට පටිගත කරන්න. විසඳා ගත් පසු, පේළිය නොවෙනස් වන අතර නැවත වෙනස් කළ නොහැක.

ඉල්ලීමේ ශරීරය

ක්ෂේත්‍රය	වර්ගය	විස්තරය
outcomeඅවශ්‍යයි	string	වෙළඳාමේ ප්‍රතිඵලය: `win` හෝ `loss`
exit_priceවිකල්ප	float	වෙළඳාම සඳහා නික්මීමේ මිල. යොමුව සඳහා ගබඩා කර ඇත; සපයන්නේ නම් P&L % ගණනය කිරීමට භාවිතා කරයි.
pnl_pctවිකල්ප	float	තනතුර ප්‍රමාණයේ ප්‍රතිශතයක් ලෙස සාක්ෂාත් කරගත් P&L, උදාහරණයක් ලෙස `3.5` හෝ `-1.2`

උදාහරණ ප්‍රතිචාරය

JSON

{
 id: 318,
 resolved: True,
 outcome: win,
 exit_price: 65800.0,
 pnl_pct: 4.1,
 resolved_at: 1711027200
}

නොවෙනස් බව. ලෙජර් පේළිය එකතු කිරීම පමණි. තීරණයක් ඉදිරිපත් කළ පසු එය මකා දැමිය නොහැකි අතර, විසඳා ගත් පසු නැවත විසඳිය නොහැක. මෙය ඔබ ගොඩනඟන ලද වාර්තාව සාධාරණ සහ වෙනස් කිරීමට අපහසු බව සහතික කරයි.

දෝෂ කේත

තත්ත්වය	කේතය	විස්තරය
400	invalid_params	නැතිවූ හෝ වලංගු නොවන විමසුම් පරාමිතීන්
401	unauthorized	නැතිවූ හෝ වලංගු නොවන API යතුර
403	plan_restriction	ඔබගේ වත්මන් සැලැස්මේ අවසාන ලක්ෂ්‍යය ලබා ගත නොහැක
429	rate_limit_exceeded	දිනපතා හෝ පිපිරුම් සීමාවට ළඟා විය
500	internal_error	සේවාදායක දෝෂය — /health සඳහා මූලාශ්‍ර තත්ත්වය පරීක්ෂා කරන්න
503	data_stale	දත්ත මූලාශ්‍රය ලබා ගත නොහැක; අවසාන දන්නා දත්ත සමඟ ආපසු ලබා දෙනු ලැබේ

කේත උදාහරණ

Python

import requests

r = requests.get(
 https://api.smartmoneyapi.com/v1/confirm,
  params={symbol: BTC, direction: long},
  headers={X-API-Key: sm_your_key}
)
data = r.json()

print(data["confidence"])  # HIGH / MEDIUM
print(data["size_mult"]) # 1.5 / 1.0

Python

import requests

API_KEY = "sm_your_key"
BASE_URL = "https://api.smartmoneyapi.com/v1"

def confirm_trade(symbol, direction):
  resp = requests.get(
    f"{BASE_URL}/confirm",
    params={"symbol": symbol, "direction": direction},
    headers={"X-API-Key": API_KEY},
    timeout=5
  )
  resp.raise_for_status()
 return resp.json()

# In your trading loop:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
 print("Skipping — insufficient confidence")
else:
  size = base_size * signal["size_mult"]
 place_order(symbol, direction, size)

JavaScript / Node.js

JavaScript

const API_KEY = 'sm_your_key';

async function confirmTrade(symbol, direction) {
 const params = new URLSearchParams({ symbol, direction });
 const res = await fetch(
    `https://api.smartmoneyapi.com/v1/confirm?${params}`,
    { headers: { 'X-API-Key': API_KEY } }
  );
 if (!res.ok) throw new Error(`API error: ${res.status}`);
 return res..json();
}

// Usage
confirmTrade('BTC', 'long')..then((data) => => {
  console.log((data.confidence, data.size_mult);
});

cURL

Shell

# Confirm a long trade
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

# Get whale data
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/whales?symbol=BTC"

# Check usage
curl -X GET \
  -H X-API-Key: sm_your_key \
 https://api.smartmoneyapi.com/v1/usage

Freqtrade ඒකාබද්ධ කිරීම

Freqtrade උපායමාර්ගයකට Smart Money තහවුරු කිරීම එක් කිරීමට ‍ confirm_trade_entry method අභිබවා යන්න.

Python — Freqtrade උපායමාර්ගය

ආයාත කරන්න requests
සිට freqtrade.strategy ආයාත කරන්න IStrategy

වර්ගය SmartMoneyStrategy(IStrategy):
  SM_API_KEY = "sm_your_key"
  SM_BASE = "https://api.smartmoneyapi.com/v1"

 def confirm_trade_entry(self, pair, order_type,
                         amount, rate, time_in_force,
                         current_time, entry_tag, **kwargs):
    symbol = pair.split("/")[0]
 if symbol not in ["BTC", "ETH", "SOL"]:
 return True # Skip check for unsupported
 try:
      r = requests.get(
        f"{self.SM_BASE}/confirm",
        params={"symbol": symbol, "direction": "long"},
        headers={"X-API-Key": self.SM_API_KEY},
        timeout=3
      ).json()
 return r.get("confidence") in ["HIGH", "MEDIUM"]
 except:
 return True # Fail open on API error

CCXT + Smart Money

Python — CCXT

ආයාත කරන්න ccxt, requests

exchange = ccxt.bybit({
 "apiKey": "YOUR_BYBIT_KEY",
 "secret": "YOUR_BYBIT_SECRET"
})

SM_KEY = "sm_your_key"

def smart_trade(symbol, side, amount):
 # Check confirmation first
  conf = requests.get(
 "https://api.smartmoneyapi.com/v1/confirm",
    params={"symbol": symbol, "direction": side},
    headers={"X-API-Key": SM_KEY}
  ).json()

 if conf["confidence"] not in ["HIGH", "MEDIUM"]:
 print(f"Skipping {symbol} {side} — insufficient confidence.")
 return None

  adj_amount = amount * conf["size_mult"]
  order = exchange.create_market_order(
    f"{symbol}/USDT", side, adj_amount
  )
 print(f"Order placed: {adj_amount} {symbol} {side}")
 return order

උදව් අවශ්යද?

පරීක්ෂා කරන්න API තත්ත්ව පිටුව තත්ත්ව තොරතුරු සඳහා, හෝ භාවිතා කරන්න අපගේ සම්බන්ධතා පෝරමය.