API ကိုးကားချက်

Smart Money API

သင့်ရဲ့ trading bot အတွက် derivatives data၊ on-chain metrics နှင့် whale wallet activity တို့ကို စုစည်းပြီး ယုံကြည်စိတ်ချရမှုအဆင့်တစ်ခုအဖြစ် ပေးစွမ်းနိုင်သော professional-grade intelligence API တစ်ခု။

လက်ရှိ API ဗားရှင်း v1. Base URL https://api.smartmoneyapi.com/v1

ဒီဇိုင်းအခြေခံမူများ

ဤ API မှထုတ်ပေးသော endpoint တိုင်းနှင့် အဆင့်တိုင်းကို ပုံဖော်ပေးသည့် အတွေးအခေါ်လေးခု။ ၎င်းတို့သည် ၎င်း၏ကတိကဝတ်များနှင့် မကတိကဝတ်များကိုလည်း ဖော်ပြပေးသည်။

Strategy-first, not signal-first. ဤသည် ဝယ်/ရောင်း အချက်ပြများပေးသော feed တစ်ခုမဟုတ်ပါ။ သင့်တွင် ဗျူဟာနှင့် ဝင်ရောက်မှုရှိပြီးသားဖြစ်သည်။ API က သင့်လုပ်ဆောင်လိုသော ကုန်သွယ်မှုနှင့် ပတ်သက်သော ဈေးကွက်ဖွဲ့စည်းပုံ — derivatives positioning၊ funding၊ open interest၊ liquidations၊ on-chain flow နှင့် whale consensus — တို့ကို သဘောတူမှုရှိမရှိ ပြောပြပေးသည်။

Confidence-scored, not binary prediction. တိုင်းတာမှုတိုင်းတွင် အဆင့်သတ်မှတ်ချက် confidence (HIGH / MEDIUM / LOW) နှင့် composite -1.0 မှ +1.0 အထိ ပါဝင်သည်။ အာမခံချက်များနှင့် oracle ခေါ်ဆိုမှုများမရှိပါ။ သဘောတူညီမှုနှင့် ၎င်းနောက်ကွယ်ရှိအကြောင်းရင်းများကို သိရှိနိုင်ပြီး သင့်ယုံကြည်မှုအလိုက် အရွယ်အစားကို ချိန်ညှိနိုင်သည်။

Decision support, not execution advice. API သည် CONFIRM / REDUCE / SKIP အကြံပြုချက်နှင့် အရွယ်အစားမြှင့်တင်မှုကို ပြန်ပေးသည်။ သင့် logic ကို လုပ်ဆောင်ရန်။ ၎င်းသည် order များမထားပါ၊ ဤနေရာတွင် ဘာမှငွေကြေးအကြံပေးချက်မဟုတ်ပါ။ အန္တရာယ်၊ အရွယ်အစားနှင့် လုပ်ဆောင်မှုတို့အတွက် သင့်တာဝန်ဖြစ်သည်။

Living metrics, not fixed guarantees. Win rates၊ regime statistics နှင့် accuracy figures တို့ကို rolling sample မှတွက်ချက်ပြီး ဈေးကွက်လှုပ်ရှားမှုအလိုက် ရွေ့လျားသည်။ ကျွန်ုပ်တို့သည် ၎င်းတို့ကို ရိုးသားစွာထုတ်ပြန်သည်၊ အလယ်အလတ်ဖြစ်သည့်အခါများပါ ပါဝင်သည်။ မည်သည့်မက်ထရစ်ကိုမဆို လက်ရှိလေ့လာမှုတစ်ခုအဖြစ် သတ်မှတ်ပါ၊ အနာဂတ်အတွက် ကတိကဝတ်မဟုတ်ပါ။

ဤ API သည် မည်သူ့အတွက်ဖြစ်သည်

ဤ API ကို crypto bot၊ algo နှင့် AI-agent developers များအတွက် တည်ဆောက်ထားသည်။ သင့်တွင် long/short signal — TA strategy၊ ML model၊ Freqtrade pipeline၊ TradingView alert သို့မဟုတ် LLM agent — ရှိပြီး capital မချမှတ်မီ မြန်ဆန်သော pre-trade CONFIRM / REDUCE / SKIP ဆုံးဖြတ်ချက်ကို လိုချင်သူများအတွက်။

ပုံမှန်လုပ်ငန်းစဉ်၊ သင့်ဗျူဟာက “go long BTC” → သင် ခေါ်ဆို GET /v1/confirm?symbol=BTC&direction=long → သင် အတည်ပြု၊ လျှော့ချ သို့မဟုတ် ဝင်ရောက်မှုကို ကျော်လွှားပြီး အရွယ်အစားကို ချိန်ညှိ size_mult။ တစ်ခေါက်ခေါ်ဆိုမှု၊ single low-latency JSON response၊ အပိုအခြေခံအဆောက်အအုံမလိုအပ်။

၎င်းသည် မဟုတ် standalone signal generator၊ charting product သို့မဟုတ် execution venue တစ်ခုမဟုတ်ပါ။ သင့်တွင် ကိုယ်ပိုင် signal မရှိပါက performance page ကို ကြည့်ပြီး live bot တွင် ချိတ်ဆက်မှုမပြုလုပ်မီ ဤအဆင့်ကို မည်သို့လုပ်ဆောင်ခဲ့သည်ကို ကြည့်ပါ။

အသုံးပြုခွင့်ရယူခြင်း

1 — အကောင့်ဖွင့်ပါ။ အခမဲ့အကောင့်တစ်ခုကို ဖန်တီးပါ signup (email/password သို့မဟုတ် Google)။ အခမဲ့ tier အတွက် ကဒ်မလိုအပ်ပါ။

2 — သင့်ဒက်ရှ်ဘုတ်ကို ဖွင့်ပါ။ သင့် dashboard တွင် သင့် API key၊ လက်ရှိအစီအစဉ်နှင့် နေ့စဉ်သတ်မှတ်ချက်နှင့် လက်ရှိအသုံးပြုမှုကို ပြသသည်။

3 — သင့် API key ကို ကူးယူပါ။ Keys များကို ရှေ့ဆက်ထားသည် sm_။ ၎င်းကို X-API-Key header အဖြစ် လျှောက်ထားပါ (ကြည့်ပါ Authentication။ မည်သည့်အချိန်တွင်မဆို အဆင့်မြှင့်နိုင်သည်။ စျေးနှုန်းစာမျက်နှာ ကန့်သတ်ချက်များတိုးမြှင့်ရန်နှင့် သင်္ကေတများနှင့် endpoint များကို ပိုမိုဖွင့်လှစ်ရန်။

Spec, SDK & Cookbook

ကိုယ်တိုင်ကုဒ်ရေးသည်ဖြစ်စေ၊ coding agent ထံအပ်နှံသည်ဖြစ်စေ အမြန်ပေါင်းစည်းနိုင်ရန် လိုအပ်သမျှ။

အရင်းအမြစ်	အဓိပ္ပါယ်
Cookbook	အသုံးများဆုံးပေါင်းစပ်မှုများအတွက် ကူးယူထည့်သွင်းနိုင်သော နည်းလမ်းများ — ဝင်ရောက်မှုမပြုလုပ်မီ အတည်ပြုခြင်း၊ Freqtrade အချက်ပြမှုကို ထိန်းချုပ်ခြင်း၊ အဆများစွာဖြင့် အရွယ်အစားသတ်မှတ်ခြင်း၊ 402/429 ကို ကိုင်တွယ်ခြင်းနှင့် coding agent ထံသို့ ချိတ်ဆက်ခြင်း။
OpenAPI spec	Endpoint တိုင်း၏ စက်ဖတ်နိုင်သော OpenAPI အဓိပ္ပါယ်ဖွင့်ဆိုချက်။ Postman/Insomnia သို့ တင်သွင်းခြင်း၊ client များထုတ်လုပ်ခြင်း သို့မဟုတ် LLM သို့ ပေးပို့ခြင်း။ `github.com/tashiardit/smartmoneyapi-docs`.
Python client	တရားဝင် Python client library ကို `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	API ၏ LLM-အဆင်ပြေသော ရိုးရှင်းစာသားအနှစ်ချုပ်။ Claude, Codex သို့မဟုတ် Cursor ကို ညွှန်ပြပါ (ကြည့်ရန် Coding Agents).

၂ မိနစ်အတွင်း အမြန်စတင်ခြင်း

အဆင့် ၁ — Base URL။ Endpoint တိုင်းသည် အောက်ပါတွင် တည်ရှိသည်။

Base URL
https://api.smartmoneyapi.com

အဆင့် ၂ — သင့် API key ကိုရယူပါ။ အခမဲ့စာရင်းသွင်းပါ (ခရက်ဒစ်ကတ်မလိုအပ်ပါ) နှင့် သင့်သော့ကို dashboardမှ ကူးယူပါ။ ထိုသော့ကို X-API-Key header အဖြစ် ဖြတ်သန်းပါ။

အဆင့် ၃ — သင့်၏ပထမဆုံးခေါ်ယူမှု။ ဤအရာကို သင့် terminal ထဲသို့ ကူးထည့်ပြီး sm_your_key ကို သင့် dashboard မှ သော့ဖြင့် အစားထိုးပါ။

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": ["Funding rate positive across all venues", "Whales: 67% long consensus"]
}

အခါ confidence ဖြစ်သည် HIGH သို့မဟုတ် MEDIUM နှင့် action ဖြစ်သည် CONFIRM, သင့်အနေအထားအရွယ်အစားကို size_multဖြင့် စကေးချပါ။ ထိုအရာသည် ပေါင်းစပ်မှုကွင်းဆက်တစ်ခုလုံးဖြစ်သည်။ အပြည့်အစုံ field ကိုးကားချက်အတွက် Response Fields ကိုကြည့်ပါ။

Authentication

ခေါ်ယူမှုအားလုံးသည် API key ကို X-API-Key HTTP header အဖြစ် ဖြတ်သန်းရန် လိုအပ်သည်။

HTTP Header
X-API-Key: sm_your_api_key_here

သင့် API key ကို dashboard မှ စာရင်းသွင်းပြီးနောက် ရရှိနိုင်ပါသည်။ သင့်သော့ကို လျှို့ဝှက်ထားပါ — client-side code သို့မဟုတ် အများသုံး repositories တွင် မဖော်ပြပါနှင့်။

WebSocket auth သည် ကွဲပြားသည်။ သင့်သော့ကို WebSocket URL တွင် ဘယ်သောအခါမှ မထည့်ပါနှင့်။ Real-time streams များသည် အချိန်တိုသုံး၊ တစ်ကြိမ်သာသုံး ticketsကို အသုံးပြုသည်။ သင့်သော့ကို /v1/ws/ticket သို့ POST လုပ်ပြီး X-API-Key header ဖြင့်၊ ပြီးနောက် ပြန်လာသော ticket ဖြင့် ချိတ်ဆက်ပါ။ ကြည့်ရန် WebSocket authentication (tickets).

Google Sign-In (Firebase Auth)

အသုံးပြုသူများသည် Firebase Authentication မှတဆင့် ၎င်းတို့၏ Google အကောင့်ကို အသုံးပြု၍ အတည်ပြုနိုင်သည်။ Client တွင် Google sign-in အောင်မြင်ပြီးနောက်၊ Firebase ID token ကို ချိတ်ဆက်ထားသော API session အဖြစ် လဲလှယ်ပါ။ စနစ်သည် သင့် Google လက္ခဏာကို API key စနစ်နှင့် အလိုအလျောက် ချိန်ညှိပေးသည်။

ရရှိနိုင်မည့်သူများ။ Free Trader Pro

POST /auth/google

Request Body

Field	Type	Description
id_tokenrequired	string	Client တွင် Google sign-in ပြုလုပ်ပြီးနောက် ရရှိသော Firebase ID token

Example Response

JSON

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

အသုံးပြုသူ profile အချက်အလက် — အီးမေးလ်၊ အစီအစဉ်၊ အသုံးပြုမှုမှတ်တမ်း၊ ဦးစားပေးချက်များ — ကို Firestore တွင် သိမ်းဆည်းထားပြီး သင့် Google အကောင့်နှင့် ချိတ်ဆက်ထားသည်။ အချက်အလက်တင်ပို့မှု သို့မဟုတ် အကောင့်ဖျက်မှုကို dashboard Privacy Settings မှတဆင့် မည်သည့်အချိန်တွင်မဆို တောင်းဆိုနိုင်သည်။

Rate Limits

Plan	Calls/Day	Burst Limit	Data Delay
Free	50	2/min	60 seconds
Trader	1,000	20/min	Real-time
Pro	5,000	၆၀/မိနစ်	တကယ့်အချိန်နှင့်တစ်ပြေးညီ
Enterprise	100,000	၄၀၀/မိနစ်	တကယ့်အချိန်နှင့်တစ်ပြေးညီ

Rate limit headers တွေကို တုံ့ပြန်ချက်တိုင်းမှာ ထည့်ပေးထားပါတယ်။ X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Base URL

https://api.smartmoneyapi.com/v1

အောက်ပါ endpoint တွေအားလုံးက ဒီ base URL နဲ့ ဆက်စပ်နေပါတယ်။ တုံ့ပြန်ချက်အားလုံးက JSON ဖြစ်ပြီး Content-Type: application/json.

အမှားများ

အမှားတွေမှာ standard HTTP status codes တွေနဲ့ တသမတ်တည်း JSON body ကို သုံးပါတယ်။ အမြဲတမ်း status code ကိုပဲ ကြည့်ပြီး ဆုံးဖြတ်ပါ၊ တုံ့ပြန်ချက်စာသားကို မကြည့်ပါနဲ့။ သင့်အများဆုံးကြုံရမယ့် အချက် ၃ ခု -

Status	Code	အဓိပ္ပါယ်နှင့် ဘာလုပ်ရမလဲ
401	unauthorized	API key ပျောက်နေတာ ဒါမှမဟုတ် မမှန်ဘူး။ စစ်ဆေးပါ `X-API-Key` header ပါရဲ့လား၊ မှန်ရဲ့လား။
402	payment_required	ဒီ endpoint ဒါမှမဟုတ် symbol က သင့် key မှာရှိတဲ့ plan ထက် ပိုမြင့်တဲ့ plan လိုအပ်နေတယ် (ဥပမာ - WebSocket firehose ကို free key နဲ့ခေါ်တာ) အဆင့်မြှင့်ပါ ဒါမှမဟုတ် public endpoint ကို ပြန်သုံးပါ။
429	rate_limit_exceeded	နေ့စဉ် ဒါမှမဟုတ် burst limit ပြည့်သွားပြီ။ နောက်ပြန်ဆုတ်ပြီး `X-RateLimit-Reset`အချိန်ကျမှ ပြန်ကြိုးစားပါ။ ဆက်တိုက်မတင်ပါနဲ့။

အမှားတိုင်းမှာ အောက်ပါပုံစံအတိုင်း ပြန်ပေးပါတယ် -

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

Status code တွေအားလုံးရဲ့ စာရင်း (400 / 403 / 500 / 503 နှင့် အခြား) အတွက် ကြည့်ပါ Error Codes။ ခိုင်မာတဲ့ integration တစ်ခုမှာ 5xx နဲ့ 429 ကို ယာယီအဖြစ် (backoff နဲ့ ပြန်ကြိုးစားပါ)၊ 401/402/403 ကို အဆုံးသတ်အဖြစ် (key ဒါမှမဟုတ် plan ကို ပြင်ပါ) ဆက်ဆံပါ။

လုံခြုံရေး အကောင်းဆုံးအလေ့အထများ

Key ကို URL မှာမဟုတ်ဘဲ header မှာပဲပို့ပါ။ အမြဲတမ်း X-API-Key ကို HTTP header အဖြစ်ပို့ပါ။ Query string ထဲက key တွေ (?key=) ကို proxy တွေ၊ load balancer တွေ၊ browser history တွေမှာ log တင်မိတတ်ပါတယ် - အရင်က ?key= auth ကို WebSocket endpoint တွေမှာ ဒီအတွက်ကြောင့်ပဲ လက်မခံတော့ပါဘူး။

Key တွေကို server-side မှာပဲထားပါ။ API key ကို client-side JavaScript၊ mobile app bundle၊ ဒါမှမဟုတ် public repository တစ်ခုမှာ အမြဲတမ်းမထည့်ပါနဲ့။ Environment variable ဒါမှမဟုတ် secret manager ကနေ ဖတ်ပါ။ Key ယိုစိမ့်သွားရင် အသစ်လဲပါ။

Key တွေကို ပုံမှန်လဲပါ။ သင့်ရဲ့ key ကို dashboard ကနေ အချိန်ဇယားအတိုင်း ပြန်ထုတ်ပါ၊ ထိမိမယ်ထင်ရင်လည်း ချက်ချင်းလဲပါ။ အဟောင်းကို အသစ်ထုတ်လိုက်တာနဲ့ အလုပ်လုပ်တော့မှာ မဟုတ်ပါဘူး။

Browser socket တွေအတွက် ticket တွေသုံးပါ။ Browser ကနေ တကယ့်အချိန်နှင့်တစ်ပြေးညီ stream တွေအတွက် raw key နဲ့ချိတ်မယ့်အစား သင့် key ကို အကြိမ်ကန့်သတ်ထားတဲ့ ticket တစ်ခုနဲ့လဲပါ - ကြည့်ပါ WebSocket authentication (tickets).

Coding agents / LLMs တွေနဲ့သုံးခြင်း

Claude Code၊ Codex၊ Cursor ဒါမှမဟုတ် LLM coding agent တစ်ခုခုနဲ့ တည်ဆောက်နေလား။ ဒီ API ကို မှန်မှန်ကန်ကန်ချိတ်ဆက်ဖို့ လိုအပ်တဲ့အရာအားလုံးကို agent ကို တစ်ခါတည်းပေးနိုင်ပါတယ်။ Machine-readable ရည်ညွှန်းချက် ၂ ခု ထုတ်ပြန်ထားပါတယ် -

Resource	URL
LLM summary	`https://smartmoneyapi.com/llms.txt`
OpenAPI spec	`github.com/tashiardit/smartmoneyapi-docs`

သင့် agent ကို /llms.txt file (the llms.txt convention) ကို ညွှန်ပြပြီး အကျဉ်းချုပ်ကြည့်ခိုင်းပါ၊ ပြီးရင် OpenAPI spec ကို တိကျတဲ့ request/response ပုံစံတွေအတွက် ကြည့်ပါ။ အလုပ်ဖြစ်တဲ့ one-line prompt တစ်ခု -

Prompt

# Claude Code / Cursor / Codex ထဲကို paste လုပ်ပါ
Read https://smartmoneyapi.com/llms.txt and the OpenAPI spec at
github.com/tashiardit/smartmoneyapi-docs, then add a pre-trade
check to my bot that calls GET /v1/confirm and skips entries
unless action is CONFIRM.

ကြည့်ပါ Cookbook coding-agent recipe အပြည့်အစုံအတွက်။

Endpoints

GET /confirm

အဓိက endpoint။ ပေးထားတဲ့ trade direction အတွက် composite confidence score နဲ့ action recommendation ကိုပြန်ပေးပါတယ်။ ဘယ် position ကိုမဆို မဝင်ခင် ဒီကိုခေါ်ပါ။

Coverage, ရိုးရိုးရှင်းရှင်းပြောရရင်။ /confirm လောလောဆယ် score တွေက BTC, ETH နဲ့ SOL - အမှန်အတိုင်း confirm လုပ်နိုင်တဲ့ သမိုင်းကြောင်းလုံလောက်တဲ့ symbols တွေပါ။ Derivatives screener က သီးသန့် derivatives markets ၅၁၉ ခုကို စောင့်ကြည့်နေပါတယ် funding, OI နဲ့ liquidation data တွေအတွက်၊ whale tracking က wallet ၆၀၀+ ကို ဖုံးထားပါတယ်။ Pro က full screener၊ exports နဲ့ ပိုကျယ်ပြန့်တဲ့ market coverage ကိုဖွင့်ပေးပါတယ်။ /confirm symbol support ကို market တစ်ခုချင်းစီက ယုံကြည်စိတ်ချရတဲ့ track record စုလာတာနဲ့အမျှ တိုးချဲ့ပေးပါတယ်။

Parameters

Parameter	Type	Description
symbolrequired	string	Asset symbol။ တစ်ခုထဲက - `BTC`, `ETH`, `SOL` (Trader+)
directionrequired	string	Trade direction - `long` or `short`
sourceoptional	string	သင့်ရဲ့ signal source အတွက် လေဘယ် (analytics အတွက် log တင်ပါတယ်)။ အများဆုံး ၃၂ လုံး။

Example Request

cURL

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

Example Response

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,
 အချက်များ: {
 ဒယ်ရီဗေးတစ်များ: { အမှတ်: 0.81, အလေးချိန်: 0.40, အလေးချိန်ထား: 0.324 },
 onchain: { အမှတ်: 0.68, အလေးချိန်: 0.35, အလေးချိန်ထား: 0.238, အရင်းအမြစ်: coinmetrics, ရရှိနိုင်: True },
 ဝေလငါး: { အမှတ်: 0.73, အလေးချိန်: 0.25, staleness_factor: 1.0, အလေးချိန်ထား: 0.183 }
  },
 ချိန်ညှိမှုများ: { သဘောတူညီချက်: 0.0, ဦးတည်ချက်: 0.0, news_macro: 0.0 },
 အလေးချိန်များ: { ဒယ်ရီဗေးတစ်များ: 0.40, onchain: 0.35, whale_intel: 0.25 },
 ဖုံးလွှမ်းမှု: { ဒယ်ရီဗေးတစ်များ: True, ဝေလငါး: True, onchain: True },
 အကြောင်းပြချက်များ: [
 Funding rate positive across all venues,
 LSR favors longs: 1.42,
 Whales: 67% long consensus,
 MVRV above 1.0 — on-chain bullish
  ]
}

ဒီဇိုင်းအားဖြင့် ပွင့်လင်းမြင်သာမှု။ တုံ့ပြန်ချက်တိုင်းတွင် factors object ပြသထားသော အဆင့်တစ်ခုစီ၏ score × weight = weighted ပံ့ပိုးကူညီမှု၊ adjustments object သည် post-filter tweaks များအတွက်၊ weights အသုံးပြုထားသော၊ coverage map ။ on-chain အဆင့်သည် real free Coin Metrics data (MVRV / exchange-flow / active-address) when no Glassnode key is set. This is a multi-factor ပေါင်းစပ်မှု အမှတ် — ဆုံးဖြတ်ချက်အတွက် အထောက်အပံ့၊ 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: Trader Pro

GET /onchain

အချက်အလက်များကို မူရင်းအတိုင်း ပြန်လည်ပေးပို့သည် - MVRV, SOPR, ငွေလဲလှယ်မှု သန့်စင်စီးဆင်းမှု၊ လက်ခံနိုင်သော အရင်းအနှီးအချိုး၊ စက်ဝန်းအနေအထား ခွဲခြားသတ်မှတ်ခြင်း။

လိုအပ်သည် - Trader Pro

GET /v1/derivatives/*

ငွေလဲလှယ်မှု ၅၀၀+ ကျော်ကို ဖြတ်ကျော်သော ချေးငွေများစာရင်း - ငွေကြေးနှုန်းအပူပုံ၊ ဖွင့်ထားသောအကျိုးစီးပွားအဆင့်သတ်မှတ်ချက်များ၊ ရှည်လျား/တိုတောင်းသောအချိုးအစားအချက်ပြမှုများ။ ထိပ်တန်း ၁၀ အတန်းများကို အများသူငါကြည့်ရှုနိုင်သည်။ ပြည့်စုံသောစာရင်းကို Trader သို့မဟုတ် Pro လိုအပ်သည်။ Endpoints - /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET /v1/options/*

Deribit မှရရှိသော BTC & ETH ရွေးချယ်မှုများဆိုင်ရာ ခွဲခြမ်းစိတ်ဖြာမှု (အများသူငါ၊ အတည်ပြုမှုမလိုအပ်) - ထည့်သွင်း/ခေါ်ယူအချိုး၊ အများဆုံးနာကျင်မှု၊ ထိပ်တန်းအဆင့်သတ်မှတ်ချက်များဖြင့် ဖွင့်ထားသောအကျိုးစီးပွား။ Endpoints - /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

Spot BTC & ETF နေ့စဉ်သန့်စင်စီးဆင်းမှုများနှင့် ရန်ပုံငွေအလိုက်ခွဲခြမ်းစိတ်ဖြာမှု (အများသူငါ)။ Endpoints - /v1/etf/flows, /v1/etf/funds.

GET /v1/historical/*

အတိတ်ငွေကြေးနှုန်းများ၊ ဖွင့်ထားသောအကျိုးစီးပွား၊ ရှည်လျား/တိုတောင်းသောအချိုးအစား (Binance)၊ နှင့် OHLCV (CoinGecko) အတွက် နောက်ပြန်စမ်းသပ်မှုများ။ Endpoints - /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET /v1/dex/*

DexScreener မှ လူကြိုက်များသောအတွဲများ၊ တိုကင်ရှာဖွေမှု၊ နှင့် အတွဲအသေးစိတ်များ (အများသူငါ၊ အတည်ပြုမှုမလိုအပ်)။ Endpoints - /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET /v1/news/*

သတင်းအချက်အလက် - မူဝါဒ/ပထဝီနိုင်ငံရေး/ကြိုးဝိုင်းသတင်းများကို သက်ရောက်မှုအမျိုးအစားများအလိုက်ခွဲခြမ်းစိတ်ဖြာမှု၊ နှင့် ကြောက်ရွံ့မှုနှင့် လောဘ (အများသူငါ၊ အတည်ပြုမှုမလိုအပ်)။ Endpoints - /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET /whales

ဝေလငါးငွေအိတ်အများသဘောတူညီချက်အချက်အလက်များကို ပြန်လည်ပေးပို့သည် - ရှည်လျား/တိုတောင်းသောအချိုးအစားခွဲခြားမှု၊ စုစုပေါင်းအမှန်တကယ်ထုတ်ပြန်မှု၊ ထိပ်တန်း ၁၀ အနေအထားများ (Pro သာလိုအပ်)၊ နှင့် ငွေအိတ်အရေအတွက်။

လိုအပ်သည် - Trader Pro

GET /signals

အမြင့်ဆုံး/အလယ်အလတ်အချက်ပြမှုများကို စီးဆင်းသောအချက်အလက်များကို ပြန်လည်ပေးပို့သည်။ အခွင့်အလမ်းရှာဖွေရန်အတွက် အသုံးဝင်သည်။

လိုအပ်သည် - Pro

GET /v1/strategies/*

Smart Money အချက်ပြမှုများအပေါ်တွင် လုပ်ဆောင်သော အလိုအလျောက်ကုန်သွယ်မှုများအတွက် ပွင့်လင်းမြင်သာသော၊ ဖတ်ရန်သာရှိသော မှတ်တမ်း - ပါဝင်သည် deriv40 SmartMoney Copytrade မဟာဗျူဟာ (account=9)။ Endpoints အားလုံးသည် ?account=<id> query parameter ကို ယူပြီး JSON ကို ပြန်လည်ပေးပို့သည်။ အတည်ပြုမှုမလိုအပ် (အများသူငါမှတ်တမ်း)။

Endpoints

GET /v1/strategies/stats?account=9 — ခေါင်းစဉ်အချက်အလက်များ - 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 — ဇယားဆွဲရန်အတွက် အရင်းအနှီးမျဉ်း - { initial_equity, curve: [{ time, equity }] }.
GET /v1/strategies/trades?account=9&limit=500 — ပိတ်ထားသောကုန်သွယ်မှုမှတ်တမ်း - array (သို့မဟုတ် {trades:[…]}) ဖြစ်သည် symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
GET /v1/strategies/active?account=9 — လက်ရှိဖွင့်ထားသောအနေအထားများ - array (သို့မဟုတ် {positions:[…]}) ဖြစ်သည် symbol, side/direction, entry_price, unrealized_pnl.
GET /v1/strategies/signals — မဟာဗျူဟာများကို ကျွေးမွေးသော အချက်ပြမှုအမျိုးအစားခွဲခြမ်းစိတ်ဖြာမှု (အရေအတွက် / အောင်မြင်မှုများ / အောင်မြင်မှုနှုန်း / ပျမ်းမျှ pnl တစ်ခုစီအတွက်)။

အတိတ်စွမ်းဆောင်ရည်သည် အနာဂတ်ရလဒ်များကို ညွှန်ပြခြင်းမဟုတ်ပါ။ ကိန်းဂဏန်းများကို တစ်ခုတည်းသော ~၃ လအတွင်း နောက်ပြန်ဖြည့်သွင်းထားပြီး လက်ရှိကုန်သွယ်မှုများနှင့် ဖော်ပြထားသောနေရာတွင် ကြိုတင်ကြေးများဖြင့် ပြသထားသည်။

GET /export

နောက်ပြန်စမ်းသပ်မှုအတွက် အတိတ်အချက်ပြမှုအချက်အလက်များကို CSV အဖြစ် ဒေါင်းလုပ်ဆွဲပါ။ Parameters - symbol, from (unix ts), to (unix ts)။

လိုအပ်သည် - Pro

GET /health

စနစ်ကျန်းမာရေးစစ်ဆေးမှု။ မူလအရင်းအမြစ်တစ်ခုစီအတွက် အချက်အလက်လတ်ဆတ်မှုနှင့် API အနေအထားကို ပြန်လည်ပေးပို့သည်။ အတည်ပြုမှုမလိုအပ်။

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 အသုံးပြုမှုစာရင်းဇယားများကို ပြန်လည်ပေးပို့သည် - ယနေ့ခေါ်ဆိုမှုများ၊ လစဉ်စုစုပေါင်း၊ ကန့်သတ်ချက်များ၊ နှင့် ပြန်လည်သတ်မှတ်ချိန်များ။

POST /webhooks

လိုအပ်သည် - Pro

သင့်စောင့်ကြည့်ထားသောအရာများတွင် အချက်ပြမှုတစ်ခုဖြစ်ပေါ်လာသောအခါ လက်ငင်းလက်မှတ်ထိုးထားသောအဖြစ်အပျက်များကို လက်ခံရရှိရန် HTTPS URL တစ်ခုကို မှတ်ပုံတင်ပါ။ ပေးပို့မှုများသည် X-SmartMoney-Event header နှင့် HMAC-SHA256 လက်မှတ်ကို ပါဝင်သည် X-SmartMoney-Signature, နှင့် နောက်ပြန်ဆုတ်ခြင်းဖြင့် ၃ ကြိမ်အထိ ပြန်လည်ကြိုးစားသည်။

Request Body

Field	Type	Description
urlrequired	string	အဖြစ်အပျက်များကို POST လုပ်ရန် HTTPS endpoint (အစပြုရန် လိုအပ်သည် `https://`)
eventsrequired	array	အဖြစ်အပျက်အမည်များ၊ ဥပမာ `["HIGH","MEDIUM","VETO"]` သို့မဟုတ် `["*"]`
symbolsrequired	array	စစ်ထုတ်ရန် သင်္ကေတများ၊ ဥပမာ `["BTC","ETH"]` သို့မဟုတ် `["*"]`
secretrequired	string	သင့်လက်မှတ်ထိုးထားသော လျှို့ဝှက်စာလုံး၊ ≥ 16 chars (ဟက်ရှ်ထားသည်)

လက်မှတ်ကို အတည်ပြုခြင်း

HMAC key သည် သင့်မှတ်ပုံတင်ထားသော လျှို့ဝှက်စာလုံး၏ SHA-256 hex digest ဖြစ်သည်။ ထို့နောက် မူရင်းတောင်းဆိုမှုခန္ဓာကိုယ်ကို HMAC-SHA256 ဖြင့် တွက်ချက်ပြီး (အမြဲတမ်း-အချိန်) နှင့် နှိုင်းယှဉ်ပါ။ X-SmartMoney-Signature. See the Webhook Implementation guide.

Intelligence

GET /analysis

Requires: Pro

Returns AI-powered market regime classification with signal conflict detection. Analyzes cross-signal agreement, identifies divergences between derivatives, on-chain, and whale data, and produces a natural-language summary with forward-looking risk factors and a time-horizoned recommendation.

Parameters

Parameter	Type	Description
symbolrequired	string	Asset symbol: `BTC`, `ETH`, or `SOL`

Example Response

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "regime": "late_cycle_divergence",
 "regime_label": "Late Cycle — Signal Divergence",
 "summary": "BTC is in a late bull cycle phase with on-chain strength conflicting with derivatives overextension. Whales are reducing exposure while retail LSR climbs.",
 "signal_conflicts": [
 "Whale score bearish while onchain score bullish",
 "Funding rate at 3-month high — potential squeeze risk"
  ],
 "risk_factors": ["Elevated funding", "OI divergence", "Whale reduction"],
 "recommendation": "Reduce long exposure, tighten stops. Avoid new longs above current price.",
 "time_horizon": "4h–12h"
}

Pro plan required. This endpoint consumes 3 API calls per request due to AI processing overhead.

GET /liquidations

Requires: Trader Pro

Returns two complementary views: (1) leverage-projected levels — an estimate of where liquidation clusters sit; and (2) a realized_heatmap — the REAL executed forced-liquidation intensity (price × time), aggregated live from public exchange WebSocket feeds: Binance, OKX, Bybit, Bitget, BitMEX. The heatmap is present when the stream has data for the symbol (absent in a very calm market or just after startup).

Parameters

Parameter	Type	Description
symboloptional	string	Asset symbol (default `BTC`). Real heatmap covers actively-traded perp symbols.

Example Response

JSON

{
 "symbol": "BTC",
 "cascade_risk": "HIGH",
 "nearest_long_liq_pct": -3.2,
 "nearest_short_liq_pct": 4.1,
 // REAL executed liquidations — live from 5 exchanges
 "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 }
  }
}

Trader plan: cascade_risk, nearest distances, and realized totals/by-side. Pro plan: full projected levels plus the full realized_heatmap (matrices, per-price clusters, per-exchange counts). The projected estimate answers "where are the stops"; the realized heatmap shows "what actually got liquidated."

GET /liquidations/heatmap

Available to: Free No authentication required (per-IP throttled)

Public price-level liquidation heatmap. Returns a Coinglass-style price × time matrix of REAL executed forced liquidations, bucketed by the price at which each liquidation printed — aggregated live from public exchange WebSocket feeds: Binance, OKX, Bybit, Bitget, BitMEX. The clusters array is the practical output: price buckets ranked by liquidated notional, each tagged with its dominant side. Data depends on the live stream — a very quiet symbol or a just-restarted gateway returns the well-formed empty structure plus an honest note. Levels shown are only ever real liquidations, never estimated.

ပါရာမီတာများ

ပါရာမီတာ	အမျိုးအစား	ဖော်ပြချက်
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
}

ဖွင့်ဟချက်- ဤ endpoint သည် live stream ဖမ်းယူထားသည်များကိုသာ ထင်ဟပ်ပြသည်။ သင်္ကေတတစ်ခု ငြိမ်သက်နေချိန် သို့မဟုတ် stream အသစ်စပါက၊ totals.count is 0, clusters ဗလာဖြစ်ပြီး note field တွင် အကြောင်းရင်းကို ရှင်းပြထားသည်။ ၎င်းသည် အကောင်အထည်ဖော်ပြီး liquidations မှတ်တမ်းဖြစ်သည် — ခန့်မှန်းချက် မဟုတ်။ "ဆိုင်းငံ့နေသော နေရာများ" ခန့်မှန်းချက်အတွက်၊ authenticated /liquidations endpoint ကို အသုံးပြုပါ။

GET /liquidations/onchain

လိုအပ်သည်- Trader Pro

အကောင်အထည်ဖော်ပြီး on-chain DeFi ချေးငွေ liquidations ကျွန်ုပ်တို့၏ ကိုယ်ပိုင် local BSC + Avalanche full nodes မှ တိုက်ရိုက်ဖမ်းယူထားသည် — မည်သည့် trading bot နှင့်မှ မသက်ဆိုင်ပါ။ BSC တွင် Venus/Cream နှင့် Moolah၊ Avalanche တွင် AAVE V3/V2, Benqi, BankerJoe, Granary နှင့် Vinium ကို ဖုံးလွှမ်းသည်။ Pro tier တွင် အပိုအနေဖြင့် at_risk positions များကို ပြန်ပေးသည် (bot အပေါ်မူတည်ပြီး မပါဝင်နိုင်ပါ)။

ပါရာမီတာများ

ပါရာမီတာ	အမျိုးအစား	ဖော်ပြချက်
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, အမေရိကန်ဒေါ်လာပြန်ဆပ်ရန် (သိထားပြီး): 148230.55 } },
 nodes: { bsc: { ရောက်ရှိနိုင်သော: true, head_block: 89173010, events_total: 61 } }
  }
}

GET /smart-stop

လိုအပ်ချက်: Trader Pro

လက်ရှိ liquidation heatmap၊ volatility bands နှင့် market structure အပေါ်အခြေခံ၍ ဉာဏ်ရည်ထက်မြက်သော stop-loss အဆင့်များကို တွက်ချက်ပေးသည်။ သင့်ဝင်ရောက်ဈေးနှုန်းနှင့် စွန့်စားမှုသည်းခံနိုင်စွမ်းအလိုက် ညှိထားသော အဆင့်ဆင့် stop အကြံပြုချက်များနှင့် take-profit အကြံပြုချက်များကို ပြန်ပေးသည်။

Parameters

Parameter	Type	Description
symbolrequired	string	Asset symbol: `BTC`, `ETH`, or `SOL`
directionrequired	string	Position direction: `long` or `short`
entry_priceoptional	float	သင့်ဝင်ရောက်ဈေးနှုန်း။ ပျက်ကွက်ပါက လက်ရှိဈေးကွက်ဈေးနှုန်းကို မူရင်းအတိုင်းယူသည်။
risk_pctoptional	float	အကောင့်၏ % အဖြစ် အများဆုံးလက်ခံနိုင်သော စွန့်စားမှု။ မူရင်း: `2.0`

Example Response

JSON

{
 "symbol": "BTC",
 "direction": "long",
 "entry_price": 96420,
 "stops": {
 "tight": { "price": 95100, "note": "1h structure အောက်။ scalps အတွက် အကောင်းဆုံး။" },
 "recommended": { "price": 93800, "note": "$94K တွင် major liq cluster အောက်။ Standard swing stop။" },
 "wide": { "price": 91200, "note": "4h demand zone အောက်။ Position trade stop။" }
  },
 "avoid_zones": [
    { "low": 94200, "high": 94800, "reason": "Dense liquidation cluster — high slippage risk" }
  ],
 "take_profit_suggestions": [
    { "tp1": 98500, "tp2": 101000, "tp3": 104200 }
  ]
}

Trader plan: Returns the recommended stop only. Pro plan: All three stop tiers, avoid_zones, and full take-profit suggestions.

GET /funding-arb

လိုအပ်ချက်: Trader Pro

Cross-exchange funding rate arbitrage အခွင့်အလမ်းများကို အချိန်နှင့်တစ်ပြေးညီ ဖော်ထုတ်ပေးသည်။ ခန့်မှန်းနှစ်စဉ်အမြတ်ငွေ၊ အကောင်းဆုံး exchange စုံတွဲနှင့် spread ကိုဖမ်းယူရန် လိုအပ်သော hedge action တို့ပါဝင်သော အဆင့်သတ်မှတ်ထားသည့် အခွင့်အလမ်းများကို ပြန်ပေးသည်။

Parameters

Parameter	Type	Description
min_spreadoptional	float	ပါဝင်ရန် အသေးဆုံး funding rate spread (ဒဿမအဖြစ်)။ မူရင်း: `0.01`
symboloptional	string	သီးသန့် asset တစ်ခုကို စစ်ထုတ်ရန်။ ပျက်ကွက်ပါက ပံ့ပိုးထားသော asset အားလုံးကို စစ်ဆေးသည်။

Example Response

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 plan: Top 1 opportunity only, no historical spread data. Pro plan: All current opportunities with 24h spread history per exchange pair.

Free public variant No auth

No-key public endpoint တစ်ခုသည် top 10 အခွင့်အလမ်းများကို live cross-exchange screener ဖြင့် ပြန်ပေးသည်၊ embedding သို့မဟုတ် အမြန်စစ်ဆေးမှုများအတွက် သင့်လျော်သည်။ ၎င်းသည် per-symbol spread history နှင့် heavy fields များကို ဖယ်ရှားပြီး 120-second cache မှ ဝန်ဆောင်မှုပေးသည်။ Freshness window တွင် cross-exchange funding spreads မရှိပါက ၎င်းသည် ဘယ်သောအခါမှ fabricated data မပါသော opportunities array with a note — never fabricated data.

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: Low spread — ensure fees do not consume the arbitrage margin.
    }
  ],
 scanned_symbols: 222,
 ts: 1783268753,
 public: True,
 limited: True
}

အခမဲ့၊ API key မလိုအပ်ပါ။ အထူးအခွင့်အလမ်း ၁၀ ခုသာ၊ အကန့်အသတ်နှင့် cache လုပ်ထားသည် (၁၂၀ စက္ကန့်)။ တိုက်ရိုက်စစ်ဆေးရေးစာမျက်နှာ - funding-arb.html.

GET /smart-money/flow

လိုအပ်ချက် - Trader Pro

အရည်အသွေးအလေးချိန်ထားသော ဝေလငါးဦးတည်ချက်ညွှန်းကိန်း သင်္ကေတတစ်ခုချင်းစီအတွက်၊ အမှတ်ပေးထားသည် -100 (ဝေလငါးငွေများ short ဘက်သို့ယိမ်းသည်) မှ +100 (long ဘက်သို့ယိမ်းသည်)။ Hyperliquid ဝေလငါးပိုက်ဆံအိတ်ထောင်ပေါင်းများစွာမှ တည်ဆောက်ထားသည် - တစ်ခုချင်းစီကို ၎င်း၏သမိုင်းကြောင်းအောင်မြင်မှုနှုန်းနှင့် PnL အရ အလေးချိန်ပေးပြီး နောက်ဆုံးလုပ်ဆောင်ချက်အရ လျော့ပါးစေသည်။ ၎င်းသည် နေရာချထားမှုညွှန်းကိန်းဖြစ်ပြီး၊ ဝယ်/ရောင်း အချက်ပြချက် သို့မဟုတ် ဈေးနှုန်းခန့်မှန်းချက် မဟုတ်ပါ။ ပါဝင်ဆောင်ရွက်သည့်ပိုက်ဆံအိတ်အနည်းငယ်သာရှိသော သင်္ကေတများကို ခွဲခြားသတ်မှတ်ထားပြီး thin ရိုးသားစွာအမှတ်ပေးထားသည်။ တိုက်ရိုက်စာမျက်နှာ - smart-money-flow.html.

Parameters

Parameter	Type	Description
symboloptional	string	တစ်ခုတည်းသောသင်္ကေတ (ဥပမာ `BTC`). \|score\| အလိုက်စီထားသော ခြေရာခံထားသည့်သင်္ကေတအားလုံးရရန် ချန်ထားပါ။
window_hoursoptional	int	အမှတ်ပေးသည့်အချိန်ကာလ၊ ကန့်သတ်ထားသည် `1..168`. Default `24`.

Example Response

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: အရည်အသွေးအလေးချိန်ထားသော ဝေလငါးဦးတည်ချက်နေရာချထားမှုညွှန်းကိန်း (-၁၀၀..+၁၀၀)။ ဈေးနှုန်းခန့်မှန်းချက် သို့မဟုတ် ဝယ်/ရောင်း အချက်ပြချက် မဟုတ်ပါ။
}

Trader plan - ထိပ်တန်းသင်္ကေတ ၁၂ ခု၊ ပါဝင်သူအသေးစိတ်ကို ဖော်ပြမထားပါ။ Pro plan - သင်္ကေတအားလုံးနှင့် တစ်ခုချင်းစီအတွက် top_contributors. ပိုက်ဆံအိတ်အလေးချိန်များကို ကန့်သတ်ထားသည် [0.25,1.0]; PnL သည် နောက်ဆုံးနေရာသိမ်းဆည်းမှုများမှ မရရှိသေးသော proxy တစ်ခုဖြစ်သည်။

GET /v1/whales/crowding

ရနိုင်သူ - Free အထောက်အထားမလိုအပ်ပါ - အမည်မဖော်သူသည် ထိပ်တန်းသင်္ကေတ ၁၀ ခုသာရပြီး Trader+ သည် အပြည့်အစုံရသည်

ပေါင်းစပ်ထားသော ဝေလငါးနေရာချထားမှုနှင့် လူထူထပ်မှုအခြေအနေ သင်္ကေတတစ်ခုချင်းစီအတွက်၊ ပေါင်းစပ်ထားသည် Hyperliquid + GMX v2 + Jupiter Perps. စုစုပေါင်းအမည်ခံ၊ ဦးတည်ချက်စောင်းမှု၊ ပိုက်ဆံအိတ်နှင့် နေရာအရေအတွက်၊ နေရာစုစည်းမှု (ထိပ်တန်း-၃ ဝေစု + HHI)၊ အလေးချိန်ပျမ်းမျှလီဗာရိတ်နှင့် ဖျက်သိမ်းမှုနီးကပ်မှုအဆင့်များ (အမည်ခံငွေသည် ၎င်း၏ခန့်မှန်းဖျက်သိမ်းမှုဈေး၏ ၅% နှင့် ၁၀% အတွင်းတွင် ရှိနေသည်၊ long/short ခွဲထားသည်)။ ၎င်းသည် အခြေအနေဖော်ပြချက်ဖြစ်ပြီး၊ ဦးတည်ချက်အချက်ပြချက် မဟုတ်ပါ။ ရယူ၍မရနိုင်သော အကွက်များသည် null ဖြစ်ပြီး ပြသမှုသည် — — ဥပမာ lev_wavg/crowding_index လီဗာရိတ်မပါသောနေရာများရှိပါက။ ဖျက်သိမ်းမှုအကွာအဝေးများသည် သီးသန့်မာဂျင်ခန့်မှန်းချက်ဖြစ်သည် (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), မဟုတ်ပါ အိတ်ချိန်းမှဖော်ပြသော ဖျက်သိမ်းမှုဈေးများ။

Parameters

Parameter	Type	Description
min_notionaloptional	float	သင်္ကေတတစ်ခုပါဝင်ရန် လိုအပ်သော စုစုပေါင်းအမည်ခံအနည်းဆုံး (USD)။ Default - `1000000`.

Example Request

GET (no auth)

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

Example Response

JSON

{
 ok: True, ts: 1783423500, အနည်းဆုံးငွေပမာဏ: 1000000, သင်္ကေတအရေအတွက်: 92,
 သင်္ကေတများ: [
    {
 သင်္ကေတ: BTC,
 စုစုပေါင်း USD: 2447900000.0, အသားတင် USD: -51000000.0, စောင်းချိန်: -0.021,
 ဝေလငါးအရေအတွက်: 414, ဈေးကွက်အရေအတွက်: 3,
 ဈေးကွက်များ: {
 hl: { စုစုပေါင်း: 1900000000.0, အသားတင်: -40000000.0, ဝေလငါးအရေအတွက်: 272 },
 gmx: { စုစုပေါင်း: 320000000.0, အသားတင်: -6000000.0, ဝေလငါးအရေအတွက်: 59 },
 jupiter: { စုစုပေါင်း: 227900000.0, အသားတင်: -5000000.0, ဝေလငါးအရေအတွက်: 83 }
      },
 ထိပ်သုံးအာရုံစူးစိုက်မှု: 0.159, hhi: 0.011, ပျမ်းမျှအရှိန်: 19.1,
 5% အတွင်းအရည်အသွေး: { ရှည်: 621700000.0, တို: 665600000.0 },
 10% အတွင်းအရည်အသွေး: { long: 840000000.0, short: 910000000.0 },
 crowding_index: 0.003
    }
  ],
 သတိပြုရန်: [ Liquidation distances များသည် isolated-margin ခန့်မှန်းချက်များသာဖြစ်ပြီး exchange-reported မဟုတ်ပါ။ ]
}

သတိထားရန် skew သည် net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1)။ Only venues actually present appear in venues။ Positions with no leverage are excluded from the liq buckets rather than assumed. Anonymous callers receive the top 10 symbols by gross (with gated: true); Trader+ receive the full list.

GET /v1/options/gex

အသုံးပြုနိုင်သူများ Free No authentication required (per-IP throttled)

Dealer gamma exposure (GEX) အတွက် analytics BTC & ETH, computed live from the public Deribit options chain (no auth). Returns net dealer GEX per strike (SpotGamma dealer-short convention), the gamma-flip level (strike where cumulative net GEX crosses zero), the IV term structure (ATM implied vol by days-to-expiry), and a front-expiry IV skew (25Δ-proxy risk reversal). GEX regime is positive (dealers long gamma → vol-suppressing) or negative (vol-amplifying). Fully self-contained — recomputed on every call, no stored-DB dependency.

Parameters

Parameter	အမျိုးအစား	ဖော်ပြချက်
သင်္ကေတရွေးချယ်စရာ	စာသား	`BTC` သို့မဟုတ် `ETH` သာလျှင်။ ပုံသေ: `BTC`.

တောင်းဆိုမှု နမူနာ

GET (no auth)

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 contract multiplier သည် 1 ဖြစ်သည် (coin-denominated OI)။ မည်သည့်ရယူမှုမအောင်မြင်ပါက endpoint သည် available: false အချည်းနှီးသော panels များဖြင့်ပြန်လာမည် — ဘယ်တော့မှ fabricated GEX မဟုတ်ပါ။ IV skew သည် 25Δ အတွက် fixed ±10% strike proxy ကိုအသုံးပြုသည် (true 25-delta သည် delta per strike ကိုဖြေရှင်းရန်လိုအပ်သည်); ပြသရန်အတွက်လုံလောက်ပြီး၊ approximation အဖြစ်မှတ်တမ်းတင်ထားသည်။

GET /v1/liquidations/simulate

ရနိုင်သည်။ အခမဲ့ အထောက်အထားစစ်ဆေးခြင်းမလိုအပ်ပါ (IP တစ်ခုချင်းစီကို အရှိန်လျှော့ထားသည်)

အပြန်အလှန်ဆက်သွယ်နိုင်သော အရှုံးသတ်မှတ်ချက် ဆက်တိုက်ဖြစ်စဉ် စမ်းသပ်မှု. မှန်းဆထားသော ဈေးနှုန်းပြောင်းလဲမှုတစ်ခုကို ထည့်သွင်းစဉ်းစားပြီး၊ ခန့်မှန်းထားသော လီဗာရေ့ဂျ်ပါဝင်သည့် အနေအထားများ၊ ဈေးနှုန်းအဆင့်/ဘက်ခြမ်း/လဲလှယ်ရေးစင်တာများအလိုက် အတင်းအကျပ်ရောင်းချရမည့် ပမာဏ၊ နှင့် အဆင့်ဆင့်အရှုံးသတ်မှတ်ချက်နက်ရှိုင်းမှုကို ပြန်လည်ဖော်ပြပေးသည်။ အောက်ဘက်သို့ပြောင်းလဲမှုသည် long များကို အရှုံးသတ်မှတ်ချက်ဈေးနှုန်းသည် သတ်မှတ်ချက်ထက် ပိုမိုမြင့်မားသော (သို့) ညီမျှသော အနေအထားများကို အရှုံးသတ်မှတ်ပေးသည်။ အထက်ဘက်သို့ပြောင်းလဲမှုသည် short များကို အရှုံးသတ်မှတ်ချက်ဈေးနှုန်းသည် သတ်မှတ်ချက်ထက် ပိုမိုနိမ့်ကျသော (သို့) ညီမျှသော အနေအထားများကို အရှုံးသတ်မှတ်ပေးသည်။ နည်းလမ်းနှစ်မျိုးကို ပေါင်းစပ်ထားသည်- Hyperliquid ဝေလငါးကြီးများ၏ တိတိကျကျ ခြေရာခံထားသော အရှုံးသတ်မှတ်ချက်ဈေးနှုန်းများ real လီဗာရေ့ဂျ်/အဝင်ဈေးနှုန်း၊ နှင့် လဲလှယ်ရေးစင်တာတစ်ခုချင်းစီအတွက် စာရင်းအင်းအရ OI-band အစုအဝေးများ (ငွေကြေးထောက်ပံ့မှုမှ ခန့်မှန်းထားသော လူထုလီဗာရေ့ဂျ်)။ အရာအားလုံးကို ရှင်းလင်းစွာ တံဆိပ်ကပ်ထားသည် estimated: true — ၎င်းသည် တစ်ခုချင်းစီအတွက် အာမခံငွေ၊ cross vs isolated၊ ထပ်ပေါင်းထည့်ထားသော အာမခံငွေ၊ သို့မဟုတ် ADL ကို မသိရှိနိုင်ပါ။

အချက်များ

အချက်	အမျိုးအစား	ဖော်ပြချက်
symboloptional	string	အရင်းအမြစ်သင်္ကေတ။ ပုံသေ- `BTC`.
move_pctoptional	float	မှန်းဆထားသော ဈေးနှုန်းပြောင်းလဲမှုကို ရာခိုင်နှုန်းဖြင့် (အနုတ် = အောက်၊ အပေါင်း = အထက်)။ ပုံသေ- `-5`.

နမူနာ တောင်းဆိုမှု

GET (no auth)

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": "ခန့်မှန်း — တစ်ခုချင်းစီအတွက် အာမခံငွေ၊ cross vs isolated၊ ထပ်ပေါင်းထည့်ထားသော အာမခံငွေ၊ သို့မဟုတ် ADL ကို မသိရှိနိုင်ပါ။" }
}

ရိုးသားသော မှတ်ချက်- ခန့်မှန်းထားသော နံပါတ်တိုင်းကို အမှန်တကယ် DB ဖတ်ခြင်းမှ ရရှိသည်။ မည်သည့်အရာမျှ မအောင်မြင်မှုတွင် လုပ်ကြံဖန်တီးထားခြင်း မရှိပါ။ ခြေရာမခံထားသော သင်္ကေတ၊ ခေတ်နောက်ကျနေသော အချက်အလက်ဖမ်းယူမှု၊ သို့မဟုတ် ပျောက်ဆုံးနေသော ဈေးနှုန်းသည် ok: true, empty: true အင်္ဂလိပ်စာ ရိုးရှင်းသော မက်ဆေ့ဂျ်ဖြင့် ပြန်လာပါသည်၊ အတုအယောင် ဘားများ မဟုတ်ပါ။ realized_context သည် အသက်ဝင်နေသော အရှုံးသတ်မှတ်ချက် စီးကရက်မှ ငယ်ရွယ်ပြီး ကြီးထွားလာနေသော နမူနာတစ်ခုဖြစ်ပြီး၊ အကြောင်းအရာအဖြစ်သာ ဖော်ပြသည် — ၎င်းသည် ခန့်မှန်းချက်ကို "အမှန်တကယ်ဖြစ်ပြီ" အဖြစ် မဖန်တီးပါ။

GET /v1/wallet/{addr}/profile

ရနိုင်သည်- အခမဲ့ အတည်ပြုချက် မလိုအပ်ပါ (per-IP throttled)

ကူးပြောင်းနိုင်သော နေရာ ဝေလ်လက်တ် ပရိုဖိုင် အသက်ဝင်နေသော ခြေရာခံထားသည့် ဝေလငါးကြီးများ၏ အနေအထား အချက်အလက်ဖမ်းယူမှုများမှ တည်ဆောက်ထားသည်။ ခြေရာခံထားသော Hyperliquid ဝေလငါးကြီးတစ်ဦးအတွက်၊ လက်ရှိ ဖွင့်ထားသော အနေအထားများ၊ အမှတ်မထင်ရသော-PnL / ထိတွေ့မှု / အနေအထားအရေအတွက် အချိန်စီးရီး, OPEN/CLOSE/FLIP လှုပ်ရှားမှု အချိန်ဇယား (ဆက်တိုက်ဖြစ်သော အချက်အလက်ဖမ်းယူမှုများကို ကွာခြားချက်ဖြင့် ပြန်လည်တည်ဆောက်ထားသည်), ကုဒ်ဖြေထားသော HL-leaderboard လိပ်စာ၊ နှင့် ဖွင့်ထားသော စာအုပ်အကျဉ်းချုပ်ကို ပြန်လည်ပေးပို့သည်။ အသက်ဝင်နေသော စာမျက်နှာ- wallet-profiler.html.

အချက်များ

အချက်	အမျိုးအစား	ဖော်ပြချက်
addrrequired	string	ဝေလ်လက်တ် လိပ်စာ (လမ်းကြောင်းအပိုင်း), ဥပမာ `/v1/wallet/0x3bcae23e…/profile`.
daysoptional	integer	စီးရီးနှင့် အချိန်ဇယားအတွက် ပြန်ကြည့်ရန် ဝင်းဒိုး။ ပုံသေ- `30`.

နမူနာ တောင်းဆိုမှု

GET (no auth)

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, win_rate_pct: 71, trades: 42 },
 positions: [
      { venue: hyperliquid, symbol: ETH, direction: short,
 size: 1200.0, entry_px: 1800.0, unrealized_pnl: 34800.0,
 leverage: 20.0, value_usd: 2160000.0 }
    ],
 series: [ { ts: 1783330000, unrealized_pnl: 42000.0, exposure_usd: 18400000.0, positions: 5 } ],
 timeline: [ { ts: 1783400000, event: flip, symbol: ETH,
 direction: short, from_direction: long, value_usd: 2160000.0 } ],
 summary: {
 open_positions: 5, in_profit: 3, in_loss: 2, longs: 0, shorts: 5,
 total_unrealized_pnl: -12000.0, total_exposure_usd: 21000000.0, blended_leverage: 19.9,
 window_days: 30, snapshots_in_window: 474,
 realized_pnl: None, realized_pnl_note: Not derivable — only open snapshots are seen, never closing fills.
    }
  }
}

သတိထားရန် ပြသထားသည်များအားလုံးသည် အမှန်တကယ် snapshot ဒေတာမှ ဖြစ်သည် — pnl HL ၏ ကိုယ်ပိုင် unrealized mark-to-market ဖြစ်သည်၊ value_usd ဖွင့်ထားသော notional ဖြစ်သည်။ Realized P&L per round-trip ကို ရရှိနိုင်မည်မဟုတ်ပါ (ကျွန်ုပ်တို့သည် ဖွင့်ထားသော snapshots ကိုသာ မြင်ရပြီး closing fills ကို မမြင်ရပါ) နှင့် ပြသထားသည်မှာ null / —; timeline CLOSE events တွင် P&L claim မပါရှိပါ။ မှန်ကန်သော်လည်း ခြေရာမခံထားသော address သည် tracked: false မှတ်စုတစ်ခုဖြင့် ပြန်လာမည်; မမှန်ကန်သော address သည် ok: false, error: "invalid_address" (HTTP 400) ပြန်လာမည်။ HL-leaderboard label သည် HL ၏ ကိုယ်ပိုင် window standing at discovery ဖြစ်ပြီး ကျွန်ုပ်တို့မှ တွက်ချက်ထားခြင်း မဟုတ်ပါ။

GET /flows

လိုအပ်သည်: Pro

BTC, ETH, နှင့် SOL တို့ကြား အချိန်ကာလအမျိုးမျိုးတွင် ငွေကြေးလည်ပတ်မှုပုံစံများကို ပြသသည့် cross-asset capital flow ဒေတာကို ပြန်ပေးသည်။ မည်သည့်အချိန်တွင်မဆို ငွေကြေးစုဆောင်းနေသော အရာနှင့် ဖြန့်ဝေနေသော အရာကို ဖော်ထုတ်ရန် အသုံးဝင်သည်။

ဥပမာ တုံ့ပြန်မှု

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 }
  },
 rotations_detected: [
 Capital rotating from ETH to BTC over 4h window,
 SOL accumulation consistent across all windows
  ]
}

Pro plan လိုအပ်သည်။ Flow တန်ဖိုးများသည် USD net inflow (အပြုသဘော) သို့မဟုတ် outflow (အနုတ်သဘော) per time window ဖြစ်သည်။

GET /whale-events

လိုအပ်သည်: Trader Pro

သတ်မှတ်ထားသော look-back window အတွင်း tracked wallets နှင့် on-chain addresses များတွင် ဖော်ထုတ်ထားသော whale position အပြောင်းအလဲများ — opens, closes, နှင့် direction flips — ကို ပြန်ပေးသည်။

အချက်များ

Parameter	Type	Description
symboloptional	string	အရာအားဖြင့် စစ်ထုတ်ရန်။ စောင့်ကြည့်ထားသော အရာများအားလုံးအတွက် ချန်ထားပါ။
significanceoptional	string	အဖြစ်အပျက် အရေးပါမှုဖြင့် စစ်ထုတ်ရန်: `high`, `medium`, or `all`. Default: `all`
hoursoptional	integer	Look-back window in hours. Default: `24`

ဥပမာ တုံ့ပြန်မှု

JSON

{
 symbol: BTC,
 summary: {
 flips_to_long: 3,
 flips_to_short: 1,
 new_opens: 7,
 closes: 2
  },
 events: [
    {
 type: flip_long,
 wallet: 0xWhale...a4f2,
 direction: long,
 size_usd: 4200000,
 ts: 1710938400
    }
  ]
}

Trader plan: Returns the summary object only. Pro plan: Full events feed with wallet identifiers, sizes, and timestamps.

GET /regimes/history

Requires: Pro

Returns historical regime classification data for a given asset. Use this to backtest how specific regime types have performed historically, how long each regime type typically lasts, and how regime transitions unfold over time.

Parameters

Parameter	Type	Description
symboloptional	string	Asset symbol. Default: `BTC`
regimeoptional	string	Filter to a specific regime type, e.g. `late_cycle_divergence`. Omit for all regimes.
daysoptional	integer	Look-back window in days. Default: `30`. Maximum: `365`

Example Response

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 plan required. Combine with /analysis to validate strategy assumptions against historical regime performance data.

GET /exchange-health

Available to: Free Trader Pro

Returns real-time health status for all monitored exchanges including per-exchange latency, error rates, and data staleness indicators. No authentication required — publicly accessible endpoint.

Example Response

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

Requires: Trader Pro

Returns a real-time Fear & Greed index (0-100) computed from derivatives sentiment, whale activity, volatility, and social signals. Includes component breakdown and 24-hour history for trend analysis.

Parameters

Parameter	Type	Description
symboloptional	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 — တစ်ခုတည်းသော endpoint တွင် ပေါင်းစပ်ထားသော component ခွဲခြမ်းစိတ်ဖြာမှု။

ပေါင်းစည်းမှုများ

GET /tradingview/setup

လိုအပ်သည် - Trader Pro

သင့်ရဲ့ စိတ်ကြိုက် TradingView ပေါင်းစည်းမှု setup ကို ပြန်ပေးသည် - webhook URL, အတည်ပြုရန် secret, နှင့် Smart Money API နှင့် တိုက်ရိုက်ချိတ်ဆက်သည့် အဆင်သင့်သုံးနိုင်သော Pine Script indicators များ။ Pine Script ကို 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

အသုံးပြုနိုင်သူ - Trader Pro

TradingView alert တစ်ခုကို လက်ခံပြီး ၎င်းကို ဖြတ်သန်းစစ်ဆေးကာ /confirm, နှင့် အတည်ပြုချက်ကို ပြန်ပေးသည်။ TradingView သည် custom headers များ မပို့နိုင်သောကြောင့် သင့် webhook ကို secret JSON body တွင် ထည့်သွင်းခြင်းဖြင့် အတည်ပြုပါ (ဤ endpoint သည် X-API-Key ကို အသုံးမပြုပါ)။ တုံ့ပြန်မှုတွင် အတည်ပြုချက်ကို ထုပ်ပိုးပြီး အဆင့်အမြင့် action ၏ CONFIRMED (daemon confidence HIGH/MEDIUM) သို့မဟုတ် VETOED.

တောင်းဆိုမှု Body

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.

Personalization

GET /preferences

လိုအပ်ပါသည်။ Trader Pro

သင့်လက်ရှိ စိတ်ကြိုက်သတ်မှတ်ချက်များ၊ ပုံမှန်ကုန်သွယ်မှုအချက်အလက်များ၊ စွန့်စားမှုအဆင့်၊ စောင့်ကြည့်စာရင်းနှင့် အသိပေးချက်စိတ်ကြိုက်သတ်မှတ်ချက်များကို ပြန်ပေးပါမည်။

PUT /v1/preferences

အောက်ပါအကွက်များထဲမှ မည်သည့်အစုတစ်ခုနှင့်မဆို JSON body ပို့ခြင်းဖြင့် စိတ်ကြိုက်သတ်မှတ်ချက်များကို အပ်ဒိတ်လုပ်ပါ။ ချန်လှပ်ထားသောအကွက်များသည် ၎င်းတို့၏လက်ရှိတန်ဖိုးများကို ဆက်လက်ထိန်းသိမ်းထားပါမည်။

Preference Fields

Field	Type	Description
default_trade_size_usd	float	Kelly နှင့် smart-stop တွက်ချက်မှုများအတွက် USD ဖြင့် ပုံမှန်အနေအထားအရွယ်အစား
risk_tolerance	string	`conservative`, `moderate`, or `aggressive`
default_risk_pct	float	အကောင့်၏ % အဖြစ် ပုံမှန်စွန့်စားမှုတစ်ခုစီ။ ဤသည်မှာ အသုံးပြုသည့်အခါ `/smart-stop` when `risk_pct` is omitted
watchlist	array	ဥပမာ အရင်းအမြစ်သင်္ကေတများ၏ အစီအစဉ်စာရင်း `["BTC","ETH","SOL"]`
notification_email	string	သတိပေးချက်များပေးပို့ရန် အီးမေးလ်လိပ်စာ
timezone	string	IANA timezone string, ဥပမာ `America/New_York`

PUT — Example Body

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

GET /watchlist

လိုအပ်ချက်- Trader Pro

သင့်ရဲ့ watchlist တွင် သတ်မှတ်ထားသော symbols အားလုံးအတွက် confirmation status snapshot နှင့် အဓိက risk metrics များကို ပြန်ပေးပါသည်။ Symbol တစ်ခုချင်းစီအတွက် သီးသန့်ခေါ်ယူရန် မလိုဘဲ multi-asset overview ကို ပေးစွမ်းပါသည်။ /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": "HIGH"
    },
    {
 "symbol": "SOL",
 "confidence": "HIGH",
 "action": "CONFIRM",
 "regime": "breakout",
 "cascade_risk": "MEDIUM"
    }
  ]
}

Real-Time Streaming (Live Swaps)

ကျွန်ုပ်တို့၏ BSC နှင့် Avalanche nodes များမှ $500 နှင့်အထက် DEX swaps များကို real-time တွင် ထောက်လှမ်းပြီး stream လုပ်ပါသည်။ Public Server-Sent Events (SSE) stream (အခမဲ့/browser clients များအတွက်) နှင့် low-latency WebSocket firehose (အခကြေးငွေပေးသော tiers များအတွက်) ဟူ၍ transports နှစ်မျိုးရှိပါသည်။ Events များကို block တစ်ခုထဲသို့ ထည့်သွင်းပြီးနောက် စက္ကန့်ပိုင်းအတွင်း broadcast လုပ်ပါသည်။

Public SSE Stream (အခမဲ့)

ရနိုင်သူ- Free Trader Pro

GET /v1/stream/public-swaps

Authentication မလိုအပ်ပါ။ Native EventSource support သည် modern browsers အားလုံးတွင် ရှိပါသည်။ Server သည် swap events များနှင့် periodic heartbeats များကို connection အသက်ရှင်နေစေရန် ထုတ်လွှင့်ပါသည်။

JavaScript (browser)

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)

Requires: Trader Pro

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

Authentication (recommended): never put your long-lived key in the URL — it gets logged by proxies and saved in browser history. Instead POST your key to /v1/ws/ticket using the safe X-API-Key header, then open the socket with the returned single-use ticket (valid ~60s, redeemed once). Server-side clients that can set headers may instead pass X-API-Key directly on the handshake. Free-tier keys receive a 402 payment_required response. A hello frame is sent on connect with your tier and the broadcast threshold.

JavaScript (browser)

// 1. Exchange your key for a short-lived ticket (key stays in the 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. Open the socket with the single-use ticket
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 authentication (tickets)

Why: never put your API key in a WebSocket URL — query strings get logged by proxies, load balancers, and saved in browser history. Instead, exchange your key for a short-lived, single-use ticket over a normal authenticated POST, then connect with that ticket.

Flow: POST to /v1/ws/ticket with your X-API-Key header → receive { "ticket": "…", "expires_in": 60 }. Then open wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. The ticket is တစ်ကြိမ်သုံး နှင့် သက်တမ်းကုန်ဆုံးမည် ~60 စက္ကန့်. 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	ဤသတိပေးချက်အတွက် လူသားဖတ်နိုင်သော ခေါင်းစဉ် (အများဆုံး ၆၄ လုံး)
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	ပြန်လည် ဖြစ်ပေါ်မှုကြား အနည်းဆုံး မိနစ်များ (default 60)

The live list of valid metrics and operators is returned by GET /v1/alerts/conditions as available_metrics and available_operators.

Available Metrics

Metric	Description
funding_rate	Current funding rate for symbol (as decimal)
global_lsr	Global long/short ratio for symbol
long_pct	Percentage of accounts net long for symbol
top_trader_lsr	Top-trader long/short ratio for symbol
taker_ratio	Taker buy/sell ratio for symbol
mvrv	Market Value to Realized Value ratio (BTC/ETH)
sopr	Spent Output Profit Ratio (BTC/ETH)
exchange_net_flow	On-chain exchange net-flow signal
accumulation	On-chain accumulation signal
whale_long_pct	Percentage of tracked whale wallets holding long positions for symbol
whale_n_wallets	Number of tracked whale wallets with a position in symbol
composite_long	Composite score for symbol queried in long direction
composite_short	Composite score for symbol queried in short direction
funding_spread	Cross-venue funding spread for symbol

POST — Example Body

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

GET /kelly

Requires: Pro

Returns Kelly Criterion position sizing recommendations calibrated to historical signal performance for the given symbol, confidence level, and direction. Grounds position size in empirical win rates to avoid over-leveraging.

Parameters

Parameter	Type	Description
symbolrequired	string	Asset symbol: `BTC`, `ETH`, or `SOL`
confidenceoptional	string	Signal confidence level to model: `HIGH`, `MEDIUM`, or `LOW`. Default: `HIGH`
directionoptional	string	Trade direction: `long` or `short`. Default: `long`
account_sizeoptional	float	Account size in USD for computing `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 plan လိုအပ်ပါသည်။ တွက်ချက်မှုများကို မောင်းနှင်နေသော 90-ရက်နမူနာများအပေါ်အခြေခံထားပြီး၊ တောင်းဆိုထားသော သင်္ကေတ၊ ယုံကြည်မှုနှင့် ဦးတည်ချက်အချက်များနှင့်ကိုက်ညီသော သမိုင်းဝင်အချက်ပြမှုများကို အသုံးပြုထားသည်။

GET /performance

အသုံးပြုနိုင်သူများ: Free Trader Pro

API မှထုတ်ပြန်သော အချက်ပြမှုများ၏ သမိုင်းဝင်တိကျမှုစာရင်းဇယားများကို ယုံကြည်မှုအဆင့်အလိုက်ခွဲခြားပြီး ပြန်လည်ပေးပို့သည်။ အရင်းအနှီးမစတင်မီ အချက်ပြမှု၏ ယုံကြည်စိတ်ချရမှုကို နားလည်ရန်အထောက်အကူပြုသည်။

Parameters

Parameter	Type	Description
symboloptional	string	ပိုင်ဆိုင်မှုအလိုက် စစ်ထုတ်ရန်။ သင်္ကေတအားလုံးအတွက် စုပေါင်းစာရင်းဇယားများအတွက် ချန်လှပ်ထားပါ။
daysoptional	integer	နောက်ပြန်ကြည့်ရန် ရက်အပိုင်းအခြား။ Default: `30`

Example Response

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 }
  }
}

Stats & Signals

GET /v1/stats

အသုံးပြုနိုင်သူများ: Free Trader Pro No authentication required

Site-wide honest performance statistics sourced from smart_money_confirm distinct-call outcomes. Returns win rates at HIGH and MEDIUM confidence tiers, overall accuracy, profit factor, and a per-symbol breakdown. All figures are in-sample over the scoring window; consult calibration.html for context and forward-holdout methodology.

Example Response

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
  }
}

In-sample caveat. All figures in this response are computed from the same period used to tune the scorer. The forward_holdout object is the only number accrued on data the scorer has never seen — watch it grow over time. See calibration.html for the full methodology and the in-sample / forward-test boundary.

GET /v1/signals/performance

အသုံးပြုနိုင်သူများ: Free Trader Pro No authentication required

Signal outcome tracking across multiple resolution horizons (4h, 12h, 24h, 72h). Returns hit rates per horizon, total signal counts, and a breakdown by signal type.

Parameters

Parameter	Type	Description
daysoptional	integer	နောက်ပြန်ကြည့်ရန် ရက်အပိုင်းအခြား။ Default: `30`
signal_typeoptional	string	Filter by type, e.g. `smart_money_confirm` or `regime_flip`. Omit for all types.
symboloptional	string	Filter by asset symbol, e.g. `BTC`. Omit for aggregate across all symbols.

Example Response

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 }
  },
 အမျိုးအစားခွဲခြားချက်: {
 Smart Money အတည်ပြုချက်: { အရေအတွက်: 35, 24h အောင်မြင်နှုန်း: 0.61 },
 စနစ်ပြောင်းလဲမှု: { အရေအတွက်: 13, 24h အောင်မြင်နှုန်း: 0.47 }
  }
}

GET /v1/signals/recent

အသုံးပြုနိုင်သူများ အခမဲ့ ကုန်သည် 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

အသုံးပြုနိုင်သူများ အခမဲ့ ကုန်သည် Pro အတည်ပြုချက်မလိုအပ်ပါ

နံပါတ်အလိုက် ID ဖြင့် အချက်ပြတစ်ခု၏ အဖြေရှင်းပြီးရလဒ်။ အချိန်ကာလတစ်ခုစီတွင် (4h, 12h, 24h, 72h) အောင်မြင်မှု/မအောင်မြင်မှုကို အချက်ပြစျေးနှင့် အဖြေရှင်းစျေးနှင့်အတူ ပြန်ပေးသည်။

အချက်များ

အချက်	အမျိုးအစား	ဖော်ပြချက်
idလိုအပ်သည်	integer	Signal 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

လိုအပ်သည် အခမဲ့ ကုန်သည် Pro

အတည်ပြုထားသော အသုံးပြုသူ၏ API သော့အတွက် Confirm-signal အောင်မြင်နှုန်း ခွဲခြမ်းစိတ်ဖြာချက်။ ယုံကြည်မှုအဆင့်တစ်ခုစီ၊ အမြတ်အစွန်းအချက်နှင့် သင်္ကေတအလိုက် အောင်မြင်နှုန်းများကို ပြန်ပေးသည်။ မှန်ကန်သော 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 }
  }
}

Distinct-call basis. Win rates are computed per distinct confirm call (one per symbol per 5-minute window), not per every API hit — this prevents N-inflation from bots that poll repeatedly. Figures are in-sample over the default 30-day window; the same caveat as /v1/stats သက်ရောက်သည်။

Shadow Gate

လိုအပ်ချက်: အခမဲ့ ကုန်သည် Pro

ပြောင်းလဲ၍မရသော၊ ထပ်ထည့်သာလုပ်ဆောင်နိုင်သည့် ကိုယ်ပိုင်ဆုံးဖြတ်ချက်မှတ်တမ်း။ သင့်ရဲ့ငွေကြေးဆိုင်ရာဆုံးဖြတ်ချက်များကို အကောင်အထည်ဖော်မည့်အချိန်မတိုင်မီ သို့မဟုတ် ပြီးနောက်တွင် တင်သွင်းပါ။ စနစ်သည် Smart Money engine နှင့်တိုက်ဆိုင်စစ်ဆေးပြီး အမြဲတမ်းမှတ်တမ်းတစ်ခုအား ထပ်ထည့်ပေးမည်။ API ၏အချက်ပြမှုနှင့် သင့်ကိုယ်ပိုင်ထည့်သွင်းမှုများ မည်မျှကိုက်ညီကြောင်း အချိန်တစ်ခုနှင့်တစ်ခု မှတ်တမ်းတင်ထားသည့် ရိုးသားသောမှတ်တမ်းတစ်ခုကို တည်ဆောက်ရန် အသုံးပြုပါ။ ကမ္ဘာလုံးဆိုင်ရာအနိုင်နှုန်းစုစည်းမှုနှင့် လုံးဝမသက်ဆိုင်ပါ။ Free နှင့် Trader အဆင့်တုံ့ပြန်မှုများတွင် အထောက်အထားများပါဝင်မှုမရှိပါ။ Pro အဆင့်တွင် အပြည့်အစုံဖော်ပြမှုကို ရရှိမည်။ Free အဆင့်ဒေတာအတွက် အဆင့်နှောင့်နှေးမှုတစ်ခုလည်း ရှိပါသည်။

POST /v1/shadow-gate/decisions

ဆုံးဖြတ်ချက်တစ်ခုကို တင်သွင်းပါ။ Idempotent on the Idempotency-Key request header — တူညီသောသော့ချက်ကိုပြန်တင်ပါက ရှိပြီးသားအတန်းကိုပြန်ပေးပြီး နှစ်ထပ်မဖြစ်စေပါ။ စနစ်သည် confirm engine ကိုချက်ချင်းခေါ်ယူပြီး ရလဒ်ကို immutable ledger row အဖြစ်ချိတ်ဆက်ပေးပါသည်။

Request Body

Field	Type	ဖော်ပြချက်
သင်္ကေတလိုအပ်သည်	စာသား	အရင်းအမြစ်သင်္ကေတ၊ ဥပမာ `BTC`
ဘက်မျဉ်းလိုအပ်သည်	စာသား	ကုန်သွယ်မှုဦးတည်ချက် `long` သို့မဟုတ် `short`
မဟာဗျူဟာ_IDရွေးချယ်စရာ	စာသား	ခေါ်သူသတ်မှတ်ထားသောမဟာဗျူဟာအမည် (အများဆုံး ၆၄ လုံး)။ အဖွဲ့လိုက်နှင့်စစ်ထုတ်ရန်အတွက် မူလအတိုင်းသိမ်းဆည်းထားသည်။

တောင်းဆိုမှုနမူနာ

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"

တုံ့ပြန်မှုနမူနာ

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 တွင် အပြည့်အစုံအတည်ပြုချက် ခွဲခြမ်းစိတ်ဖြာမှုကို ပြန်ပေးသည်။ အခမဲ့အဆင့်အတွက် နှောင့်နှေးမှုတစ်ခု သက်ရောက်သည် - အတန်းကို ချက်ချင်းရေးသားသော်လည်း အတည်ပြုချက်အမှတ်သည် ကက်ရှ်သိမ်းထားသော အချက်အလက်များကို ၆၀ စက္ကန့်အထိ ဟောင်းနွမ်းနေနိုင်သည်။

GET /v1/shadow-gate/decisions

သင့်ကိုယ်ပိုင် shadow-gate ဆုံးဖြတ်ချက်များကိုစာရင်းပြုစုပါ၊ အသစ်ဆုံးမှစ၍။ Owner-scoped — သင့် API key မှတင်သွင်းထားသောဆုံးဖြတ်ချက်များကိုသာပြန်ပေးသည်။

ပါရာမီတာများ

ပါရာမီတာ	အမျိုးအစား	ဖော်ပြချက်
limitoptional	integer	ပြန်ပေးရမည့် အများဆုံးအတန်းများ။ ပုံသေ: `50`, အများဆုံး: `200`
cursoroptional	string	ယခင်တုံ့ပြန်မှုတစ်ခုမှ မမြင်ရသော စာမျက်နှာလှန်ခြင်း cursor `next_cursor` field။ ပထမစာမျက်နှာအတွက် ချန်ထားပါ။

ဥပမာ တုံ့ပြန်မှု

JSON

{
 "decisions": [
    { "id": 318, "symbol": "BTC", "side": "long", "decision": "CONFIRM", "confidence": "HIGH", "composite": 0.74, "size_mult": 1.5, "ts": 1710940821, "resolved": false },
    { "id": 317, "symbol": "ETH", "side": short, decision: SKIP, confidence: LOW, composite: -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 key တစ်ခုနှင့် သက်ဆိုင်ပါက။

ဥပမာ တုံ့ပြန်ချက် (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

ဆုံးဖြတ်ချက်၏ ရလဒ်ကို လက်ဖြင့် ဖြေရှင်းပါ။ ကုန်သွယ်မှုကို ပိတ်ပြီးနောက် ဤအရာကို ခေါ်ယူကာ ledger အတန်းတွင် နောက်ဆုံးရလဒ်ကို မှတ်တမ်းတင်ပါ။ တစ်ချိန်က ဖြေရှင်းပြီးပါက၊ အတန်းသည် ပြောင်းလဲ၍မရသော အရာဖြစ်ပြီး နောက်တစ်ကြိမ် ပြန်လည်ပြောင်းလဲ၍မရပါ။

တောင်းဆိုမှု Body

Field	Type	Description
outcomerequired	string	ကုန်သွယ်မှု ရလဒ်: `win` သို့မဟုတ် `loss`
exit_priceoptional	float	ကုန်သွယ်မှုအတွက် ထွက်ခွာသည့် ဈေးနှုန်း။ ကိုးကားရန် သိမ်းဆည်းထားသည်; ပေးပါက P&L % တွက်ချက်ရန် အသုံးပြုသည်။
pnl_pctoptional	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
}

ပြောင်းလဲ၍မရသော အရာ။ Ledger အတန်းသည် append-only ဖြစ်သည်။ တစ်ချိန်က ဆုံးဖြတ်ချက်တစ်ခု တင်ပြပြီးပါက ဖျက်၍မရပါ၊ နှင့် တစ်ချိန်က ဖြေရှင်းပြီးပါက ပြန်လည်ဖြေရှင်း၍မရပါ။ ဤသည်မှာ သင်တည်ဆောက်သော မှတ်တမ်းသည် ရိုးသားပြီး လှည့်စား၍မရသော အရာဖြစ်စေရန် သေချာစေသည်။

အမှားကုဒ်များ

Status	Code	Description
400	invalid_params	မပါဝင်သော သို့မဟုတ် မမှန်ကန်သော query parameters
401	unauthorized	မပါဝင်သော သို့မဟုတ် မမှန်ကန်သော API key
403	plan_restriction	သင့်လက်ရှိ plan တွင် endpoint မရနိုင်ပါ
429	rate_limit_exceeded	နေ့စဉ် သို့မဟုတ် burst limit ရောက်ရှိပြီ
500	internal_error	Server error — /health တွင် အရင်းအမြစ် status ကို စစ်ဆေးပါ
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()

# သင့် trading loop ထဲတွင်:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
 print("ကျော်သွားမည် - ယုံကြည်စိတ်ချမှု မလုံလောက်ပါ")
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 (!resok) throw new Error(`API error: ${resstatus}`);
 return res.json();
}

// အသုံးပြုပုံ
confirmTrade('BTC', 'long').then(data => {
  console.log(dataconfidence, datasize_mult);
});

cURL

Shell

# Long trade တစ်ခုအား confirm လုပ်ပါ
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

# Whale data ရယူပါ
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/whales?symbol=BTC"

# အသုံးပြုမှုကို စစ်ဆေးပါ
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 ဗျူဟာ

import requests
from freqtrade.strategy import IStrategy

class 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 # API error တွင် ဖွင့်ထားပါ

CCXT + Smart Money

Python — CCXT

import ccxt, requests

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

SM_KEY = "sm_your_key"

def smart_trade(symbol, side, amount):
 # ပထမဆုံး အတည်ပြုချက်ကို စစ်ဆေးပါ
  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

Need help?

Check the API status page for real-time health info, or use our contact form.