API Reference

Smart Money API

API ប្រណីភាពវិជ្ជាជីវៈដែលផ្ដុំទិន្នន័យដេរីវេទីវ ម៉ែត្រលើសង្វាក់ និងសកម្មភាពគណនីវាល់ជាពិន្ទុទំនុកចិត្តតែមួយសម្រាប់បូតធ្វើពាណិជ្ជកម្មរបស់អ្នក។

Current API version: v1។ Base URL: https://api.smartmoneyapi.com/v1

Design principles

គំនិតបួនរូបរាងគ្រប់ចំណុចចុង និងគ្រប់ពិន្ទុដែល API នេះត្រឡប់មកវិញ។ វាក៏ជាព្រំដែនស្មោះត្រង់នៃអ្វីដែលវាធ្វើ — និងមិនធ្វើ — សន្យា។

Strategy-first, not signal-first. នេះមិនមែនជាហែលសញ្ញាទិញ/លក់ទេ។ អ្នកនាំយកយុទ្ធសាស្ត្រ និងការចូល; API ប្រាប់អ្នកថាតើស្ថាប័នទីផ្សារជុំវិញ — ទីតាំងដេរីវេទីវ ការផ្ដល់មូលនិធិ ការចាប់អារម្មណ៍បើក ការលុបបំបាត់ លំហូនលើសង្វាក់ និងការយល់ព្រមរបស់វាល់ — យល់ព្រមជាមួយការធ្វើពាណិជ្ជកម្មដែលអ្នកចង់ធ្វើរួចហើយ។

Confidence-scored, not binary prediction. គ្រប់ចម្លើយដឹកជញ្ជូនពិន្ទុដែលបានដាក់ថ្នាក់ confidence (HIGH / MEDIUM / LOW) និង composite ពី -1.0 ដល់ +1.0។ មិនមានការធានានិងការហៅព្រះអាទិទេពទេ — អ្នកទទួលបានការអានដែលបានការងាយលើការយល់ព្រម ជាមួយនឹងហេតុផលនៅពីក្រោយវា ដូច្នេះអ្នកអាចធ្វើឱ្យមានទំហំសមាមាត្រទៅនឹងការជឿជាក់។

Decision support, not execution advice. API ត្រឡប់មកវិញជាការណែនាំ CONFIRM / REDUCE / SKIP និងមេគុណទំហំសម្រាប់ របស់អ្នក តក្កវិជ្ជាដើម្បីធ្វើសកម្មភាពលើ។ វាមិនដែលដាក់ការបញ្ជាទិញទេ ហើយគ្មានអ្វីនៅទីនេះជាដំបូន្មានហិរញ្ញវត្ថុទេ។ អ្នកនៅតែទទួលខុសត្រូវចំពោះហានិភ័យ ទំហំ និងការប្រតិបត្តិ។

Living metrics, not fixed guarantees. អត្រាឈ្នះ ស្ថិតិរបប និងតួលេខភាពត្រឹមត្រូវត្រូវបានគណនាពីគំរូវិល ហើយផ្លាស់ប្តូរនៅពេលដែលទីផ្សារផ្លាស់ប្តូរ។ យើងបោះពុម្ពវាដោយស្មោះត្រង់ រួមទាំងនៅពេលដែលពួកគេមានគុណភាពមធ្យម។ ព្យាករណ៍គ្រប់ម៉ែត្រដូចជាការសង្កេតបច្ចុប្បន្ន មិនមែនជាការសន្យាអំពីអនាគតទេ។

Who this API is for

API នេះត្រូវបានសាងសង់សម្រាប់ អ្នកអភិវឌ្ឍន៍បូត crypto អាល់ហ្គោ និងភ្នាក់ងារ AI ដែលមានសញ្ញាវែង/ខ្លីរួចហើយ — ពីយុទ្ធសាស្ត្រ TA ម៉ូដែល ML បំពង់ Freqtrade ការជូនដំណឹង TradingView ឬភ្នាក់ងារ LLM — ហើយចង់បានការសំរេចចិត្តមុនពេលធ្វើពាណិជ្ជកម្មយ៉ាងឆាប់រហ័ស CONFIRM / REDUCE / SKIP មុនពេលដាក់ដើមទុន។

A typical loop: your strategy fires "go long BTC" → you call GET /v1/confirm?symbol=BTC&direction=long → you confirm, reduce, or skip the entry and scale size by size_mult។ ការហៅមួយ ចម្លើយ JSON យឺតៗតែមួយ គ្មានហេដ្ឋារចនាសម្ព័ន្ធបន្ថែមទេ។

It is not ម៉ាស៊ីនបង្កើតសញ្ញាដាច់ដោយឡែក ផលិតផលគំនូសតាង ឬទីកន្លែងប្រតិបត្តិការទេ។ ប្រសិនបើអ្នកគ្មានសញ្ញាផ្ទាល់ខ្លួនដើម្បីរារាំង ចាប់ផ្តើមជាមួយ performance page ដើម្បីមើលពីរបៀបដែលពិន្ទុបានដំណើរការមុនពេលដោតវាទៅក្នុងបូតផ្ទាល់។

Getting access

1 — ចុះឈ្មោះ។ បង្កើតគណនីឥតគិតថ្លៃនៅ signup (អ៊ីមែល/ពាក្យសម្ងាត់ ឬ Google)។ មិនតម្រូវឱ្យមានកាតឥណទានសម្រាប់កម្រិតឥតគិតថ្លៃទេ។

2 — បើកផ្ទាំងគ្រប់គ្រងរបស់អ្នក។ របស់អ្នក dashboard បង្ហាញសោ API របស់អ្នក ផែនការបច្ចុប្បន្ន និងការប្រើប្រាស់ផ្ទាល់បញ្ច្រាសនឹងកូតាប្រចាំថ្ងៃរបស់អ្នក។

3 — ចម្លងសោ API របស់អ្នក។ Keys are prefixed sm_។ បញ្ជូនវាជា X-API-Key header លើគ្រប់សំណើ (មើល Authentication)។ ធ្វើឱ្យប្រសើរឡើងគ្រប់ពេលនៅលើ ទំព័រតម្លៃ ដើម្បីបង្កើនដែនកំណត់ និងដោះសោសញ្ញា និងចំណុចបញ្ចប់បន្ថែមទៀត។

លក្ខណៈបច្ចេកទេស, SDK & សៀវភៅចម្អិន

អ្វីគ្រប់យ៉ាងដែលអ្នកត្រូវការដើម្បីធ្វើសមាហរណកម្មយ៉ាងឆាប់រហ័ស ទោះជាអ្នកសរសេរកូដដោយខ្លួនឯង ឬផ្ទេរវាទៅភ្នាក់ងារសរសេរកូដ។

ធនធាន	វាជាអ្វី
សៀវភៅចម្អិន	រូបមន្តចម្លង-បិទភ្ជាប់សម្រាប់ការរួមបញ្ចូលដែលជាទូទៅបំផុត — បញ្ជាក់មុនពេលបញ្ចូល, គ្រប់គ្រងសញ្ញា Freqtrade, កំណត់ទំហំដោយពហុគុណ, ដោះស្រាយ 402/429, និងភ្ជាប់វាទៅភ្នាក់ងារសរសេរកូដ។
OpenAPI spec	និយមន័យ OpenAPI ដែលម៉ាស៊ីនអាចអានបាននៃចំណុចបញ្ចប់គ្រប់យ៉ាង។ នាំចូលទៅក្នុង Postman/Insomnia, បង្កើតអតិថិជន, ឬផ្គត់ផ្គង់ទៅ LLM ។ នៅ `github.com/tashiardit/smartmoneyapi-docs`.
អតិថិជន Python	បណ្ណាល័យអតិថិជន Python ផ្លូវការនៅ `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	សង្ខេបអាយអភីដែលមានភាពងាយស្រួលសម្រាប់ LLM ជាអត្ថបទធម្មតា។ ចង្អុល Claude, Codex, ឬ Cursor ទៅវា (មើល ភ្នាក់ងារសរសេរកូដ).

ការចាប់ផ្តើមរហ័សក្នុងរយៈពេល 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 គឺខុសគ្នា។ កុំដាក់កូដរបស់អ្នកនៅក្នុង URL WebSocket ជាដាច់ខាត។ ស្ទ្រីមពេលវេលាពិតប្រើ សំបុត្រ: POST កូដរបស់អ្នកទៅ /v1/ws/ticket ជាមួយនឹង X-API-Key ក្បាលរាយការណ៍, បន្ទាប់មកតភ្ជាប់ជាមួយសំបុត្រដែលបានត្រឡប់មកវិញ។ មើល ការផ្ទៀងផ្ទាត់ WebSocket (សំបុត្រ).

ការចូលដោយប្រើ Google (Firebase Auth)

អ្នកប្រើប្រាស់អាចផ្ទៀងផ្ទាត់ដោយប្រើគណនី Google របស់ពួកគេតាមរយៈ Firebase Authentication។ បន្ទាប់ពីការចូលដោយប្រើ Google ដោយជោគជ័យនៅលើអតិថិជន, ផ្លាស់ប្តូរ token ID Firebase សម្រាប់សម័យ API ដែលបានភ្ជាប់។ ប្រព័ន្ធនឹងធ្វើសមកាលកម្មអត្តសញ្ញាណ Google របស់អ្នកជាមួយនឹងប្រព័ន្ធកូដ API ដោយស្វ័យប្រវត្តិ។

អាចប្រើបានចំពោះ៖ ឥតគិតថ្លៃ អ្នកជំនួញ អ្នកជំនាញ

POST /auth/google

តួសំណើ

វាល	ប្រភេទ	ការពិពណ៌នា
id_tokenត្រូវការ	ខ្សែអក្សរ	Token ID Firebase ដែលទទួលបានបន្ទាប់ពីការចូលដោយប្រើ 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	តម្រូវការទូទាត់	ចំណុចបញ្ចប់ ឬសញ្ញាត្រូវការផែនការខ្ពស់ជាងកូដដែលអ្នកមាន (ឧទាហរណ៍ កូដឥតគិតថ្លៃដែលហៅផ្លូវ WebSocket firehose)។ ធ្វើឱ្យកម្រិតខ្ពស់ឡើង ឬត្រឡប់ទៅចំណុចបញ្ចប់សាធារណៈ។
429	ដែនកំណត់អត្រាត្រូវបានលើស	ដែនកំណត់ប្រចាំថ្ងៃ ឬការផ្ទុះត្រូវបានឈានដល់។ ថយក្រោយ និងព្យាយាមម្តងទៀតបន្ទាប់ពី `X-RateLimit-Reset`; កុំធ្វើការវាយ។

រាល់កំហុសត្រលប់មកវិញនូវរាងដូចគ្នា៖

JSON
{
 "កំហុស": "ដែនកំណត់អត្រាត្រូវបានលើស",
 "សារ": "ដែនកំណត់ប្រចាំថ្ងៃនៃការហៅ 50 ត្រូវបានឈានដល់។ កំណត់ឡើងវិញនៅ 00:00 UTC។",
 "ស្ថានភាព": 429
}

សម្រាប់បញ្ជីពេញលេញនៃលេខកូដស្ថានភាព (400 / 403 / 500 / 503 និងច្រើនទៀត) សូមមើល កូដកំហុស។ ការរួមបញ្ចូលដែលមានស្ថិរភាពព្យាបាល 5xx និង 429 ជាការបណ្តោះអាសន្ន (ព្យាយាមម្តងទៀតជាមួយការថយក្រោយ) និង 401/402/403 ជាការបញ្ចប់ (កែតម្រូវកូដ ឬផែនការ)។

ការអនុវត្តសុវត្ថិភាពដ៏ល្អបំផុត

ផ្ញើកូដក្នុងបឋមកថា កុំដាក់ក្នុង URL។ តែងតែបញ្ជូន X-API-Key ជាបឋមកថា HTTP។ កូដក្នុងខ្សែសំណួរ (?key=) ត្រូវបានកត់ត្រាដោយប្រូកស៊ី ប្រព័ន្ធតុល្យភាពបន្ទុក និងប្រវត្តិរុករក — ការផ្ទៀងផ្ទាត់ចាស់ ?key= មិនត្រូវបានទទួលយកទៀតទេនៅលើចំណុចបញ្ចប់ 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 ឯកសារ (អនុសញ្ញា llms.txt) សម្រាប់ការពិនិត្យរួមសង្ខេប បន្ទាប់មកប្រភេទ OpenAPI សម្រាប់រាងសំណើ/ឆ្លើយតបពិតប្រាកដ។ ខ្សែសំណើមួយដែលដំណើរការបានល្អ៖

សំណើ

# បិទភ្ជាប់ទៅ Claude Code / Cursor / Codex
អាន https://smartmoneyapi.com/llms.txt និងប្រភេទ OpenAPI នៅ
github.com/tashiardit/smartmoneyapi-docs, បន្ទាប់មកបន្ថែមការពិនិត្យមុនពេលធ្វើជំនួញ
ដែលហៅ GET /v1/confirm និងរំលងការចូល
លើកលែងតែសកម្មភាពគឺ CONFIRM។

សូមមើល សៀវភៅធ្វើម្ហូប សម្រាប់រូបមន្តភ្នាក់ងារកូដដែលបានធ្វើ។

ចំណុចបញ្ចប់

GET /confirm

ចំណុចបញ្ចប់គន្លឹះ។ ត្រឡប់ពិន្ទុជំនឿចំណុចបញ្ចប់ និងការណែនាំសកម្មភាពសម្រាប់ទិសដៅជំនួញដែលបានផ្តល់។ ហៅនេះមុនពេលចូលក្នុងតំណែងណាមួយ។

ការគ្របដណ្តប់ ជាភាសាសាមញ្ញ។ /confirm បច្ចុប្បន្នពិន្ទុ BTC, ETH និង SOL — សញ្ញាដែលមានប្រវត្តិដោះស្រាយគ្រប់គ្រាន់ដើម្បីផ្ទៀងផ្ទាត់ដោយស្មោះត្រង់។ កម្មវិធីស្ក្រីនដេរីវេទីវ័យដាច់ដោយឡែក ត្រួតពិនិត្យទីផ្សារដេរីវេទីវ័យ ~519 សម្រាប់ទិន្នន័យថវិកា OI និងការលក់ដី ហើយការតាមដានវាល់គ្របដណ្តប់ជាង 600+ កាប៊ីន។ Pro បើកស្ក្រីនពេញលេញ ការបញ្ចេញ និងការគ្របដណ្តប់ទីផ្សារធំទូលាយជាងមុន។ /confirm ការគាំទ្រសញ្ញាត្រូវបានពង្រីកនៅពេលដែលរាល់ទីផ្សារប្រមូលប្រវត្តិតាមដានដែលអាចទុកចិត្តបាន។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
សញ្ញាតម្រូវ	ខ្សែអក្សរ	សញ្ញាទ្រព្យសម្បត្តិ។ មួយក្នុងចំណោម៖ `BTC`, `ETH`, `SOL` (អ្នកជំនួញ+)
ទិសដៅតម្រូវ	ខ្សែអក្សរ	ទិសដៅជំនួញ៖ `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

វាល	ប្រភេទ	ការពិពណ៌នា
ts	integer	ពេលវេលា Unix នៃការគណនា
symbol	string	សញ្ញាអេសីត (BTC/ETH/SOL)
direction	string	ទិសដៅដែលបានស្នើសុំ (long/short)
composite	float	ពិន្ទុរួម composite ពី -1.0 (ផ្ទុយខ្លាំង) ដល់ +1.0 (បញ្ជាក់ខ្លាំង)។ មិនមែនជាអត្រាឈ្នះទេ។
base_composite	float	Composite មុនពេលអនុវត្តការកែតម្រូវ post-filter
confidence	string	`HIGH` / `MEDIUM` / `LOW` / `VETO` / `NO_DATA`
action	string	`CONFIRM_FULL` / `CONFIRM_REDUCED` / `CONFIRM_MINIMAL` / `VETO_SKIP` / `NO_DATA_SKIP`
size_mult	float	មេគុណទំហំតំណែងដែលបានណែនាំ (ឧ. 0.0 – 1.5)
unsupported	bool	`true` នៅពេលសញ្ញាហួសពីគម្រប (ផ្គូផ្គងជាមួយ NO_DATA)
deriv_score	float	ពិន្ទុរង derivatives (-1 ដល់ 1)
onchain_score	float	ពិន្ទុរង On-chain (-1 ដល់ 1)
whale_score	float	ពិន្ទុរងការឯកភាពរបស់ Whale (-1 ដល់ 1)
x_score	float	ពិន្ទុរង X/social-sentiment (-1 ដល់ 1); 0 នៅពេលមិនប្រើ
factors	object	ការបំបែកតាមជើង៖ `score × weight = weighted` សម្រាប់ derivatives / onchain / whale / x_sentiment (onchain រួមមាន `source`)
adjustments	object	ការកែតម្រូវ post-filter ដែលបានចុះហត្ថលេខា (ការយល់ព្រម, ទំនោរ, rsi_1h, news_macro, momentum, time_of_day, streak_decay)
weights	object	សំណុំទម្ងន់ដែលបានប្រើជាក់ស្តែងសម្រាប់ការវាយតម្លៃនេះ
coverage	object	`{derivatives, whale, onchain}` — ជើងណាមានទិន្នន័យពិត
reasons	array	ឃ្លាពន្យល់ដែលមនុស្សអាចអានបានសម្រាប់ពិន្ទុ

GET /snapshot

ត្រឡប់រូបភាពសង្ខេបទីផ្សារពេញលេញរួមទាំងពិន្ទុរងទាំងអស់ ម៉ែត្រដើម និងតម្លៃសូចនាករសម្រាប់សញ្ញាដែលបានផ្តល់។ មានប្រយោជន៍សម្រាប់ផ្ទាំងគ្រប់គ្រង និងការកត់ត្រា។

តម្រូវឱ្យមាន៖ អ្នកជំនួញ អ្នកជំនាញ

GET /onchain

ត្រឡប់ទិន្នន័យដើមនៅលើខ្សែសង្វាក់៖ MVRV, SOPR, លំហូរសុទ្ធនៃការផ្លាស់ប្តូរ, សមាមាត្រដើមទុនដែលបានសម្រេច, និងការចាត់ថ្នាក់វដ្ត។

តម្រូវឱ្យមាន៖ អ្នកជំនួញ អ្នកជំនាញ

GET /v1/derivatives/*

កម្មវិធីស្ក្រេនដេរីវេទីពឆ្លងកាត់ការផ្លាស់ប្តូរ 500+ និមិត្តសញ្ញា៖ ផែនទីកំដៅអត្រាកំណែទម្រង់, ការចំណាត់ថ្នាក់ចំណាប់អារម្មណ៍បើក, និងការស្វែងរកសញ្ញាសមាមាត្រវែង/ខ្លី។ ជួរទី 10 គឺសាធារណៈ; កម្មវិធីស្ក្រេនពេញលេញតម្រូវឱ្យមានអ្នកជំនួញឬអ្នកជំនាញ។ ចំណុចបញ្ចប់៖ /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET /v1/options/*

ការវិភាគជម្រើស BTC & ETH ដែលមកពី Deribit (សាធារណៈ, មិនត្រូវការការផ្ទៀងផ្ទាត់)៖ សមាមាត្រដាក់/ហៅ, ការឈឺចាប់អតិបរមា, និងចំណាប់អារម្មណ៍បើកតាមការវាយប្រហារ។ ចំណុចបញ្ចប់៖ /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

លំហូរសុទ្ធប្រចាំថ្ងៃនៃ ETF BTC & ETH និងការបំបែកតាមមូលនិធិ (សាធារណៈ)។ ចំណុចបញ្ចប់៖ /v1/etf/flows, /v1/etf/funds.

GET /v1/historical/*

ការផ្តល់មូលនិធិប្រវត្តិ, ចំណាប់អារម្មណ៍បើក, សមាមាត្រវែង/ខ្លី (Binance), និង OHLCV (CoinGecko) សម្រាប់ការធ្វើតេស្តឡើងវិញ។ ចំណុចបញ្ចប់៖ /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET /v1/dex/*

គូដែលកំពុងពេញនិយមដែលដំណើរការដោយ DexScreener, ការស្វែងរកតូខែន, និងព័ត៌មានលម្អិតអំពីគូ (សាធារណៈ, មិនត្រូវការការផ្ទៀងផ្ទាត់)។ ចំណុចបញ្ចប់៖ /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET /v1/news/*

ព័ត៌មានគណិតវិទ្យា៖ ព័ត៌មានគោលនយោបាយ/ភូមិសាស្ត្រនយោបាយ/គ្រីបតូដែលបានចាត់ថ្នាក់ទៅជាប្រភេទឥទ្ធិពល, បន្ថែមពីភាពភ័យខ្លាច & សេចក្តីលោភលន់ (សាធារណៈ, មិនត្រូវការការផ្ទៀងផ្ទាត់)។ ចំណុចបញ្ចប់៖ /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET /whales

ត្រឡប់ទិន្នន័យឯកភាពរបស់កាប៉ាត់វ៉ាល់៖ ការបំបែកវែង/ខ្លី, ការប៉ះពាល់សរុប, ទីតាំងទី 10 ខាងលើ (សម្រាប់អ្នកជំនាញតែប៉ុណ្ណោះ), និងចំនួនកាប៉ាត់វ៉ាល់។

តម្រូវឱ្យមាន៖ អ្នកជំនួញ អ្នកជំនាញ

GET /signals

ត្រឡប់លំហូរនៃសញ្ញាថ្មីៗបំផុត HIGH/MEDIUM ក្នុងចំណោមទ្រព្យសកម្មទាំងអស់ដែលត្រូវបានត្រួតពិនិត្យ។ មានប្រយោជន៍សម្រាប់ការស្កេនឱ្យមានឱកាស។

តម្រូវឱ្យមាន៖ អ្នកជំនាញ

GET /v1/strategies/*

កំណត់ត្រាដែលអាចអានបានដោយភ្លឺស្រាលសម្រាប់យុទ្ធសាស្ត្រជំនួញស្វ័យប្រវត្តិដែលដំណើរការលើសញ្ញា Smart Money — រួមទាំង deriv40 យុទ្ធសាស្ត្រការចម្លងជំនួញ SmartMoney (account=9)។ ចំណុចបញ្ចប់ទាំងអស់យក ?account=<id> ប៉ារ៉ាម៉ែត្រសំណួរ និងត្រឡប់ JSON។ មិនត្រូវការការផ្ទៀងផ្ទាត់ (កំណត់ត្រាសាធារណៈ)។

ចំណុចបញ្ចប់

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 — កំណត់ត្រាជំនួញបិទ៖ អារេ (ឬ {trades:[…]}) នៃ symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
GET /v1/strategies/active?account=9 — ទីតាំងបើកបច្ចុប្បន្ន៖ អារេ (ឬ {positions:[…]}) នៃ symbol, side/direction, entry_price, unrealized_pnl.
GET /v1/strategies/signals — ការបំបែកប្រភេទសញ្ញាដែលផ្គត់ផ្គង់យុទ្ធសាស្ត្រ (ចំនួន / ការឈ្នះ / អត្រាឈ្នះ / ប្រាក់ចំណេញជាមធ្យមក្នុងមួយប្រភេទសញ្ញា)។

ការសម្រេចចិត្តកាលពីមុនមិនបង្ហាញពីលទ្ធផលនាពេលអនាគតទេ។ តួលេខត្រូវបានបំពេញឡើងវិញលើរបបតែមួយប្រហែល 3 ខែបន្ថែមពីជំនួញផ្ទាល់ និងត្រូវបានបង្ហាញមុនពេលថ្លៃដែលបានកត់សម្គាល់។

GET /export

ទាញយកទិន្នន័យសញ្ញាប្រវត្តិជា CSV សម្រាប់ការធ្វើតេស្តឡើងវិញ។ ប៉ារ៉ាម៉ែត្រ៖ symbol, from (unix ts), to (unix ts)។

តម្រូវឱ្យមាន៖ អ្នកជំនាញ

GET /health

ការត្រួតពិនិត្យសុខភាពប្រព័ន្ធ។ ត្រឡប់ព័ត៌មានថ្មីៗសម្រាប់រោងចក្រនីមួយៗ និងស្ថានភាព API សរុប។ មិនត្រូវការការផ្ទៀងផ្ទាត់។

ការឆ្លើយតប JSON
{
 "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

តម្រូវឱ្យមាន៖ អ្នកជំនាញ

ចុះឈ្មោះ URL HTTPS ដើម្បីទទួលការជំរុញព្រឹត្តិការណ៍ដែលបានចុះហត្ថលេខជាពេលវេលាពិតនៅពេលសញ្ញាបាញ់លើទ្រព្យសកម្មដែលត្រូវបានត្រួតពិនិត្យរបស់អ្នក។ ការផ្ញើរមាន X-SmartMoney-Event header និងហត្ថលេខា HMAC-SHA256 នៅក្នុង X-SmartMoney-Signature, និងព្យាយាមឡើងវិញរហូតដល់ 3× ជាមួយការថយចុះ។

តួកាយសំណើ

វាល	ប្រភេទ	ការពិពណ៌នា
urlត្រូវការ	string	ចំណុចបញ្ចប់ HTTPS ដើម្បី POST ព្រឹត្តិការណ៍ទៅ (ត្រូវតែចាប់ផ្តើមជាមួយ `https://`)
eventsត្រូវការ	array	ឈ្មោះព្រឹត្តិការណ៍, ឧទាហរណ៍ `["HIGH","MEDIUM","VETO"]` ឬ `["*"]`
symbolsត្រូវការ	array	និមិត្តសញ្ញាដើម្បីត្រង, ឧទាហរណ៍ `["BTC","ETH"]` ឬ `["*"]`
secretត្រូវការ	string	អាថ៌កំបាំងចុះហត្ថលេខារបស់អ្នក, ≥ 16 តួអក្សរ (ត្រូវបានផ្ទុកជា hash)

ការផ្ទៀងផ្ទាត់ហត្ថលេខា

កូនសោ HMAC គឺជា hex digest SHA-256 នៃអាថ៌កំបាំងដែលបានចុះឈ្មោះរបស់អ្នក។ គណនា HMAC-SHA256 នៃតួកាយសំណើដើមជាមួយកូនសោនោះ ហើយប្រៀបធៀប (ពេលវេលាថេរ) ជាមួយ X-SmartMoney-SignatureSee 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.

Parameters

Parameter	Type	Description
symboloptional	string	Asset symbol (default `BTC`).
window_minutesoptional	int	Look-back window in minutes (default `240`, clamped to 5–1440).
price_bucketsoptional	int	Number of price buckets (default `50`, clamped to 5–100).

Example Response

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
}

Honest note: this endpoint reflects only what the live stream has captured. When a symbol is quiet or the stream just started, totals.count is 0, clusters is empty, and a note field explains why. It is a record of executed liquidations — not a prediction. For the projected "where are the stops" estimate, use the authenticated /liquidations endpoint.

GET /liquidations/onchain

Requires: Trader Pro

Executed on-chain DeFi lending liquidations captured directly from our own local BSC + Avalanche full nodes — independent of any trading bot. Covers Venus/Cream and Moolah on BSC, and AAVE V3/V2, Benqi, BankerJoe, Granary and Vinium on Avalanche. Pro tier additionally returns at_risk positions (bot-dependent, may be absent).

Parameters

Parameter	Type	Description
chainoptional	string	`bsc` or `avax`. Omit for all chains.
limitoptional	integer	Max rows (default 100, max 500). Newest-first.

Example Response

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

Requires: Trader Pro

គណនាកម្រិត stop-loss ឆ្លាតវៃដោយផ្អែកលើ heatmap liquidation បច្ចុប្បន្ន បន្ទះ volatility និងរចនាសម្ព័ន្ធទីផ្សារ។ ត្រឡប់ការណែនាំ 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: Below 1h structure. Best for scalps. },
 recommended: { price: 93800, note: Below major liq cluster at $94K. Standard swing stop. },
 wide: { price: 91200, note: Below 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

Requires: Trader Pro

កំណត់អត្តសញ្ញាណឱកាស arbitrage អត្រាកម្ចីឆ្លងផ្សារជាពេលវេលាពិត។ ត្រឡប់ឱកាសដែលបានចាត់ថ្នាក់ជាមួយនឹងផលចំណេញប្រចាំឆ្នាំប៉ាន់ស្មាន គូផ្សារដ៏ល្អបំផុត និងសកម្មភាព hedge ដែលត្រូវការដើម្បីចាប់យកការរីករាលដាល។

Parameters

Parameter	Type	Description
min_spreadoptional	float	អត្រាកម្ចីអប្បបរមាដែលត្រូវបញ្ចូល (ជាទសភាគ)។ លំនាំដើម៖ `0.01`
symboloptional	string	តម្រងទៅធាតុជាក់លាក់។ ទុកចោលដើម្បីស្កេនធាតុគាំទ្រទាំងអស់។

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

A no-key public endpoint returns the top 10 opportunities with a live cross-exchange screener, ideal for embedding or quick checks. It drops per-symbol spread history and heavy fields and is served from a 120-second cache. When no cross-exchange funding spreads exist in the freshness window it returns an empty 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: ការរីករាយទាប - ធានាថាថ្លៃសេវាមិនបំពេញចន្លោះអាប់បីត្រាជ។
    }
  ],
 scanned_symbols: 222,
 ts: 1783268753,
 public: True,
 limited: True
}

ឥតគិតថ្លៃ គ្មានកូដ API។ ឱកាសល្អបំផុត 10 ត្រូវបានកំណត់ និងផ្ទុកជាមុន (120 វិនាទី)។ ទំព័រស្ក្រីណឺរត្រចះត្រចង់៖ funding-arb.html.

GET /smart-money/flow

តម្រូវ៖ អ្នកជំនួញ អ្នកជំនាញ

សន្ទស្សន៍ដែលមានទម្ងន់គុណភាព សន្ទស្សន៍ទិសដៅអ្នកលក់ធំ ក្នុងមួយសញ្ញា ដែលបានដាក់ពិន្ទុ -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)។ មិនមែនជាការព្យាករតម្លៃ ឬសញ្ញាទិញ/លក់ទេ។
}

ផែនការអ្នកជំនួញ៖ សញ្ញាទាំង 12 ដែលមានព័ត៌មានអ្នករួមចំណែកត្រូវបានលាក់។ ផែនការអ្នកជំនាញ៖ សញ្ញាទាំងអស់ដែលមាន top_contributors។ ទម្ងន់កាបូបត្រូវបានចងនឹង [0.25,1.0]; PnL គឺជាតំណាងមិនទាន់បានដោយផ្ទាល់ពីរូបថតទីតាំងចុងក្រោយ។

GET /v1/whales/crowding

អាចប្រើបានដោយ៖ ឥតគិតថ្លៃ មិនតម្រូវឲ្យផ្ទៀងផ្ទាត់អត្តសញ្ញាណ - អនាមិកទទួលបានសញ្ញាទាំង 10 ដែលល្អបំផុត អ្នកជំនួញ+ ទទួលបានបញ្ជីពេញលេញ

បញ្ចូលគ្នា បរិបទទីតាំង និងការច្របូកច្របល់អ្នកលក់ធំ ក្នុងមួយសញ្ញា ដែលបានបញ្ចូលគ្នាក្នុង Hyperliquid + GMX v2 + Jupiter Perps។ ត្រឡប់មកវិញនូវចំនួនសរុប/សុទ្ធ ភាពចម្លែកទិសដៅ ចំនួនកាបូប និងកន្លែង ការផ្តុំទីតាំង (ចំណែកខាងលើ-3 + HHI) ហើយនិង ដោយជិតដល់ការលុបបំបាត់ ($ ចំនួនសរុបដែលស្ថិតនៅក្នុង 5% និង 10% នៃតម្លៃលុបបំបាត់ប៉ាន់ស្មាន បែងចែកវែង/ខ្លី)។ នេះគឺជា បរិបទ មិនមែនជាសញ្ញាទិសដៅទេ។ វាលដែលមិនអាចដកចេញបានគឺ null ហើយបង្ហាញជា — - ឧ. lev_wavg/crowding_index នៅពេលគ្មានទីតាំងដែលមានហិរញ្ញវត្ថុ។ ចម្ងាយលុបបំបាត់គឺជាប៉ាន់ស្មានអ៊ីសូឡេតអ៊ីសូឡេត (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), មិនមែន តម្លៃលុបបំបាត់ដែលបានរាយការណ៍ដោយកន្លែងផ្លាស់ប្តូរទេ។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
min_notionalជាជម្រើស	float	ចំនួនសរុបអប្បបរមា (USD) ដែលត្រូវការសម្រាប់សញ្ញាមួយដើម្បីបញ្ចូល។ លំនាំដើម៖ `1000000`.

ឧទាហរណ៍សំណើ

GET (គ្មានការផ្ទៀងផ្ទាត់)

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

ឧទាហរណ៍ការឆ្លើយតប

JSON

{
 ok: True, ts: 1783423500, min_notional: 1000000, n_symbols: 92,
 symbols: [
    {
 symbol: BTC,
 gross_usd: 2447900000.0, net_usd: -51000000.0, skew: -0.021,
 n_whales: 414, n_venues: 3,
 venues: {
 hl: { gross: 1900000000.0, net: -40000000.0, n_whales: 272 },
 gmx: { gross: 320000000.0, net: -6000000.0, n_whales: 59 },
 jupiter: { gross: 227900000.0, net: -5000000.0, n_whales: 83 }
      },
 conc_top3: 0.159, hhi: 0.011, lev_wavg: 19.1,
 liq_within_5pct: { long: 621700000.0, short: 665600000.0 },
 liq_within_10pct: { long: 840000000.0, short: 910000000.0 },
 crowding_index: 0.003
    }
  ],
 caveats: [ ចម្ងាយការលុបចោលគឺជាការប៉ាន់ស្មានដោយឡែក មិនមែនជាការរាយការណ៍ពីអត្ថិភាព។ ]
}

កំណត់សម្គាល់ស្មោះត្រង់៖ skew គឺ net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1)។ មានតែអត្ថិភាពដែលមានពិតប្រាកដប៉ុណ្ណោះដែលបង្ហាញក្នុង venues។ ទីតាំងដែលគ្មានការប្រើប្រាស់ត្រូវបានដកចេញពីក្របី liq ជំនួសឱ្យការសន្មត។ អ្នកហៅដែលមិនបានបញ្ចេញឈ្មោះទទួលបានសញ្ញាទាំង ១០ ដែលមានចំនួនធំជាងគេ (ជាមួយ gated: true); Trader+ ទទួលបានបញ្ជីពេញលេញ។

GET /v1/options/gex

អាចប្រើបានសម្រាប់៖ ឥតគិតថ្លៃ មិនត្រូវការការផ្ទៀងផ្ទាត់ភាពពិត (កំណត់អត្រាក្នុងមួយ IP)

អ្នកចែកចាយ ការប៉ះពាល់ហ្គាម៉ា (GEX) ការវិភាគសម្រាប់ BTC & ETH, គណនាតាមពេលវេលាពីខ្សែសង្វាក់ជម្រើស Deribit សាធារណៈ (គ្មានការផ្ទៀងផ្ទាត់)។ ត្រឡប់នូវការប៉ះពាល់ហ្គាម៉ាសុទ្ធរបស់អ្នកចែកចាយក្នុងមួយការវាយ (SpotGamma dealer-short convention), កម្រិត gamma-flip (ការវាយដែលការប៉ះពាល់ហ្គាម៉ាសុទ្ធសរុបកាត់សូន្យ), រចនាសម្ព័ន្ធ IV term (ATM implied vol តាមថ្ងៃដល់ការផុតកំណត់), និងការប៉ះពាល់ហ្គាម៉ាមុខ IV skew (25Δ-proxy risk reversal)។ របៀប 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 (coin-denominated OI)។ នៅពេលមានការបរាជ័យក្នុងការទាញយក ចំណុចបញ្ចប់ត្រឡប់ available: false ជាមួយបន្ទះទទេ — មិនដែលបង្កើត GEX ឡើង។ IV skew ប្រើការវាយប្រហែល ±10% សម្រាប់ 25Δ (25-delta ពិតប្រាកដត្រូវការដោះស្រាយ delta ក្នុងមួយការវាយ); គ្រប់គ្រាន់សម្រាប់ការបង្ហាញ ដែលបានឯកសារជាការប្រហែល។

GET /v1/liquidations/simulate

អន្តរកម្ម ការធ្វើតេស្តស្ត្រេសលើការរំលាយធនធានជាច្រើន. ដោយផ្អែកលើការផ្លាស់ប្តូរតម្លៃសន្មត់ វានឹងត្រឡប់មកវិញនូវតំណែងដែលប្រើហ្វីនែនស៊ីដែលនឹងត្រូវរំលាយ បរិមាណដែលបង្ខំដោយកម្រិតតម្លៃ/ភាគី/កន្លែងផ្លាស់ប្តូរ និងការអានជម្រៅនៃការរំលាយធនធានជាច្រើន។ ការផ្លាស់ប្តូរចុះក្រោមនឹងរំលាយ តំណែងវែង ដែលតម្លៃរំលាយស្ថិតនៅ/ខាងលើគោលដៅ; ការផ្លាស់ប្តូរឡើងលើនឹងរំលាយ តំណែងខ្លី ដែលតម្លៃរំលាយស្ថិតនៅ/ខាងក្រោមវា។ វិធីសាស្រ្តពីរដែលឯករាជ្យត្រូវបានបញ្ចូលគ្នា៖ តម្លៃរំលាយពិតប្រាកដពីតំណែងដែលត្រូវបានតាមដានរបស់ Hyperliquid whales' ពិត ហ្វីនែនស៊ី/ការចូល បូកជាមួយការចងក្រងស្ថិតិនៃក្រុម OI-band ក្នុងមួយកន្លែងផ្លាស់ប្តូរ (ហ្វីនែនស៊ីរបស់ហ្វូនត្រូវបានសន្និដ្ឋានពីការផ្តល់ហិរញ្ញប្បទាន)។ អ្វីៗទាំងអស់ត្រូវបានសម្គាល់យ៉ាងច្បាស់ estimated: true — វាមិនអាចដឹងពីហ្វីនែនស៊ីក្នុងមួយគណនី ការឆ្លងកាត់ ឬដាច់ដោយឡែក ហ្វីនែនស៊ីបន្ថែម ឬ ADL។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
សញ្ញាជំរើស	ខ្សែអក្សរ	សញ្ញាទ្រព្យសម្បត្តិ។ លំនាំដើម៖ `BTC`.
move_pctជំរើស	float	ការផ្លាស់ប្តូរតម្លៃសន្មត់ជាភាគរយ (អវិជ្ជមាន = ចុះក្រោម វិជ្ជមាន = ឡើងលើ)។ លំនាំដើម៖ `-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": "ប៉ាន់ស្មាន — មិនអាចដឹងពីហ្វីនែនស៊ីក្នុងមួយគណនី ការឆ្លងកាត់ ឬដាច់ដោយឡែក ហ្វីនែនស៊ីបន្ថែម ឬ ADL។" }
}

កំណត់សម្គាល់ស្មោះត្រង់៖ រាល់លេខដែលបានព្យាករត្រូវបានយកចេញពីការអាន DB ពិតប្រាកដ; គ្មានអ្វីត្រូវបានបង្កើតឡើងនៅពេលបរាជ័យ។ សញ្ញាដែលមិនត្រូវបានតាមដាន រូបថតដែលហួសសម័យ ឬតម្លៃដែលបាត់បង់នឹងត្រឡប់មកវិញ ok: true, empty: true ជាមួយនឹងសារជាភាសាអង់គ្លេសសាមញ្ញ មិនមែនជារបារក្លែងក្លាយ។ realized_context គឺជាគំរូដែលកំពុងរីកចម្រើនពីស្ទ្រីមនៃការរំលាយធនធានដែលបង្ខំដោយផ្ទាល់ ដែលត្រូវបានបង្ហាញជាតែបរិបទ — វាមិនដែលធ្វើឱ្យការព្យាករនេះ "ពិតប្រាកដ"។

GET /v1/wallet/{addr}/profile

អាចប្រើបានដោយ៖ ឥតគិតថ្លៃ មិនត្រូវការការផ្ទៀងផ្ទាត់ (កំណត់អត្រាក្នុងមួយ IP)

ការផ្លាស់ប្តូរឆ្លងកាត់កន្លែង ប្រវត្តិរូបរបស់កាបូប ដែលត្រូវបានសាងសង់ទាំងស្រុងពីរូបថតនៃតំណែងដែលត្រូវបានតាមដានរបស់ Hyperliquid whales។ សម្រាប់តំណែងដែលត្រូវបានតាមដានរបស់ Hyperliquid whale វានឹងត្រឡប់មកវិញនូវតំណែងបច្ចុប្បន្នដែលបើក ស៊េរីពេលវេលានៃ PnL ដែលមិនទាន់ពិតប្រាកដ/ការប៉ះពាល់/ចំនួនតំណែង ស៊េរីពេលវេលា, ពេលវេលាសកម្មភាព OPEN/CLOSE/FLIP ពេលវេលាសកម្មភាព (ត្រូវបានសាងសង់ឡើងវិញដោយការប្រៀបធៀបរូបថតជាប់ៗគ្នា) ស្លាក HL-leaderboard ដែលបានបកស្រាយ និងការសង្ខេបសៀវភៅបើក។ ទំព័រផ្ទាល់៖ wallet-profiler.html.

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
addrត្រូវការ	ខ្សែអក្សរ	អាសយដ្ឋានកាបូប (ផ្នែកផ្លូវ) ឧទាហរណ៍៖ `/v1/wallet/0x3bcae23e…/profile`.
daysជំរើស	ចំនួនគត់	បង្អួចពេលវេលាការរកមើលក្រោយសម្រាប់ស៊េរី និងពេលវេលាសកម្មភាព។ លំនាំដើម៖ `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 },
 អាទិភាព: [
      { កន្លែងធ្វើដេល: hyperliquid, សញ្ញា: ETH, ទិសដៅ: ខ្លី,
 ទំហំ: 1200.0, តម្លៃចូល: 1800.0, ប្រាក់ចំណេញ/ខាតមិនទាន់រកឃើញ: 34800.0,
 ហិរញ្ញវត្ថុ: 20.0, តម្លៃជាឌុល្លារ: 2160000.0 }
    ],
 ស៊េរី: [ { ពេលវេលា: 1783330000, ប្រាក់ចំណេញ/ខាតមិនទាន់រកឃើញ: 42000.0, ការប៉ះពាល់ជាឌុល្លារ: 18400000.0, អាទិភាព: 5 } ],
 បញ្ជីពេលវេលា: [ { ពេលវេលា: 1783400000, ព្រឹត្តិការណ៍: ប្តូរទិសដៅ, សញ្ញា: ETH,
 ទិសដៅ: ខ្លី, ពីទិសដៅ: វែង, តម្លៃជាឌុល្លារ: 2160000.0 } ],
 សង្ខេប: {
 អាទិភាពបើក: 5, ក្នុងប្រាក់ចំណេញ: 3, ក្នុងការខាតបង់: 2, វែង: 0, ខ្លី: 5,
 សរុបប្រាក់ចំណេញ/ខាតមិនទាន់រកឃើញ: -12000.0, សរុបការប៉ះពាល់ជាឌុល្លារ: 21000000.0, ហិរញ្ញវត្ថុចម្រុះ: 19.9,
 ចំនួនថ្ងៃក្នុងវិនាទី: 30, រូបថតខ្នាតក្នុងវិនាទី: 474,
 ប្រាក់ចំណេញ/ខាតដែលបានរកឃើញ: None, កំណត់សម្គាល់ប្រាក់ចំណេញ/ខាតដែលបានរកឃើញ: មិនអាចដកចេញ — គ្រាន់តែឃើញរូបថតខ្នាតបើក, មិនដែលឃើញការបំពេញបិទ។
    }
  }
}

កំណត់សម្គាល់ស្មោះត្រង់៖ អ្វីៗដែលបានបង្ហាញគឺ ពិត ពីទិន្នន័យរូបថតខ្នាត — pnl គឺជាការគណនាតម្លៃទីផ្សារមិនទាន់រកឃើញរបស់ HL ផ្ទាល់, value_usd គឺជាចំនួនបើកមិនទាន់រកឃើញ។ ប្រាក់ចំណេញ/ខាតដែលបានរកឃើញក្នុងគ្រប់ដំណើរការមិនអាចប្រើបាន (យើងគ្រាន់តែឃើញរូបថតខ្នាតបើក, មិនដែលឃើញការបំពេញបិទ) ហើយត្រូវបានបង្ហាញជា null / —; ព្រឹត្តិការណ៍បិទបញ្ជីពេលវេលាមិនមានការទាមទារប្រាក់ចំណេញ/ខាត។ អាសយដ្ឋានត្រឹមត្រូវប៉ុន្តែមិនត្រូវបានតាមដាននឹងត្រឡប់មកវិញ tracked: false ជាមួយនឹងកំណត់សម្គាល់; អាសយដ្ឋានមិនត្រឹមត្រូវនឹងត្រឡប់មកវិញ ok: false, error: "invalid_address" (HTTP 400)។ ស្លាកតារាងដឹកនាំ HL គឺជាឋានៈវិនាទីរបស់ HL ផ្ទាល់នៅពេលរកឃើញ, មិនត្រូវបានគណនាដោយយើង។

GET /flows

តម្រូវឱ្យមាន៖ Pro

ត្រឡប់ទិន្នន័យលំហូរដើមទុនឆ្លងធាតុដែលបង្ហាញគំរូការប្តូរទិសដៅរវាង BTC, ETH, និង SOL ក្នុងច្រើនវិនាទី។ មានប្រយោជន៍សម្រាប់កំណត់ថាតើធាតុណាកំពុងទទួលបានដើមទុន និងធាតុណាកំពុងត្រូវបានចែកចាយនៅពេលណាមួយ។

ឧទាហរណ៍ការឆ្លើយតប

JSON

{
 ពេលវេលា: 1710940821,
 លំហូរ: {
 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។ តម្លៃលំហូរគឺជាការបញ្ចូលសុទ្ធ (វិជ្ជមាន) ឬចេញសុទ្ធ (អវិជ្ជមាន) ក្នុងមួយវិនាទី។

GET /whale-events

តម្រូវឱ្យមាន៖ Trader Pro

ត្រឡប់ការផ្លាស់ប្តូរអាទិភាពដ៏សំខាន់របស់វាស់ — បើក, បិទ, និងប្តូរទិសដៅ — ដែលបានរកឃើញនៅក្នុងអាសយដ្ឋានដែលត្រូវបានតាមដាន និងលើខ្សែសង្វាក់ក្នុងវិនាទីរង់ចាំដែលបានបញ្ជាក់។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
សញ្ញាជាជម្រើស	ខ្សែអក្សរ	ត្រងតាមធាតុ។ ទុកចោលសម្រាប់ធាតុដែលត្រូវបានតាមដានទាំងអស់។
សារៈសំខាន់ជាជម្រើស	ខ្សែអក្សរ	ត្រងតាមសារៈសំខាន់ព្រឹត្តិការណ៍៖ `high`, `medium`, ឬ `all`។ លំនាំដើម៖ `all`
ម៉ោងជាជម្រើស	ចំនួនគត់	វិនាទីរង់ចាំជាម៉ោង។ លំនាំដើម៖ `24`

ឧទាហរណ៍ការឆ្លើយតប

JSON

{
 សញ្ញា: BTC,
 សង្ខេប: {
 ប្តូរទៅវែង: 3,
 ប្តូរទៅខ្លី: 1,
 បើកថ្មី: 7,
 បិទ: 2
  },
 ព្រឹត្តិការណ៍: [
    {
 ប្រភេទ: flip_long,
 ផ្ទាប់: 0xWhale...a4f2,
 ទិសដៅ: វែង,
 ទំហំ_usd: 4200000,
 ts: 1710938400
    }
  ]
}

ផែនការអ្នកជំនួញ៖ ត្រឡប់ summary វត្ថុតែប៉ុណ្ណោះ។ ផែនការប្រកាស៖ ពេញ events ហ្វីតជាមួយអត្តសញ្ញាណផ្ទាប់ ទំហំ និងពេលវេលា។

GET /regimes/history

តម្រូវឱ្យមាន៖ ប្រកាស

ត្រឡប់ទិន្នន័យប្រភេទរបបប្រវត្តិសាស្ត្រសម្រាប់ទ្រព្យសម្បត្តិដែលបានផ្តល់។ ប្រើវាដើម្បីសាកល្បងរបៀបដែលប្រភេទរបបជាក់លាក់បានធ្វើការប្រវត្តិសាស្ត្រ រយៈពេលដែលប្រភេទរបបធម្មតាមាន និងរបៀបដែលការផ្លាស់ប្តូររបបកើតឡើងតាមពេលវេលា។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
សញ្ញាជម្រើស	ខ្សែអក្សរ	សញ្ញាទ្រព្យសម្បត្តិ។ លំនាំដើម៖ `BTC`
របបជម្រើស	ខ្សែអក្សរ	តម្រងទៅប្រភេទរបបជាក់លាក់ ឧទាហរណ៍៖ `late_cycle_divergence`។ ទុកចោលសម្រាប់របបទាំងអស់។
ថ្ងៃជម្រើស	ចំនួនគត់	បង្អួចមើលថយក្រោយជាថ្ងៃ។ លំនាំដើម៖ `30`។ អតិបរមា៖ `365`

ឧទាហរណ៍ការឆ្លើយតប

JSON

{
 សញ្ញា: BTC,
 របបបច្ចុប្បន្ន: late_cycle_divergence,
 សង្ខេបរបប: {
 late_cycle_divergence: { ការកើតឡើង: 4, រយៈពេលជាមធ្យម_h: 38, ផលត្រឡប់ជាមធ្យម_pct: -2.1 },
 ការប្រមូល: { ការកើតឡើង: 6, រយៈពេលជាមធ្យម_h: 72, ផលត្រឡប់ជាមធ្យម_pct: 5.4 },
 ការបែកចេញ: { ការកើតឡើង: 3, រយៈពេលជាមធ្យម_h: 18, ផលត្រឡប់ជាមធ្យម_pct: 9.2 }
  },
 ការផ្លាស់ប្តូរ: [
    { ពី: ការប្រមូល, ទៅ: ការបែកចេញ, ts: 1710850000 },
    { ពី: ការបែកចេញ, ទៅ: late_cycle_divergence, ts: 1710915000 }
  ]
}

តម្រូវឱ្យមានផែនការប្រកាស។ ផ្សំជាមួយ /analysis ដើម្បីផ្ទៀងផ្ទាត់ការសន្មត់យុទ្ធសាស្ត្របើធៀបនឹងទិន្នន័យដំណើរការរបបប្រវត្តិសាស្ត្រ។

GET /exchange-health

អាចប្រើបានសម្រាប់៖ ឥតគិតថ្លៃ អ្នកជំនួញ ប្រកាស

ត្រឡប់ស្ថានភាពសុខភាពពេលវេលាពិតសម្រាប់ការផ្លាស់ប្តូរទាំងអស់ដែលត្រូវបានត្រួតពិនិត្យ រួមទាំងពេលវេលាយឺត អត្រាកំហុស និងសូចនាករអាយុទិន្នន័យ។ មិនតម្រូវឱ្យមានការផ្ទៀងផ្ទាត់ — ចំណុចបញ្ចប់ដែលអាចចូលប្រើបានសាធារណៈ។

ឧទាហរណ៍ការឆ្លើយតប

JSON

{
 ស្ថានភាពទូទៅ: ok,
 ts: 1710940821,
 ការផ្លាស់ប្តូរ: {
 bybit: { ស្ថានភាព: ok, ពេលវេលាយឺត_ms: 42, អត្រាកំហុស_1h: 0.0, អាយុទិន្នន័យចុងក្រោយ_s: 18 },
 binance: { ស្ថានភាព: ok, ពេលវេលាយឺត_ms: 38, អត្រាកំហុស_1h: 0.0, អាយុទិន្នន័យចុងក្រោយ_s: 22 },
 hyperliquid: { ស្ថានភាព: degraded, ពេលវេលាយឺត_ms: 310, អត្រាកំហុស_1h: 0.04, អាយុទិន្នន័យចុងក្រោយ_s: 95 },
 okx: { ស្ថានភាព: ok, ពេលវេលាយឺត_ms: 55, អត្រាកំហុស_1h: 0.0, អាយុទិន្នន័យចុងក្រោយ_s: 30 }
  }
}

GET /sentiment

តម្រូវឱ្យមាន៖ អ្នកជំនួញ ប្រកាស

ត្រឡប់សន្ទស្សន៍ភ័យខ្លាច និងលោភលន់ (0-100) ដែលគណនាពីអារម្មណ៍ដេរីវេ សកម្មភាពត្រីវាល ភាពចលាចល និងសញ្ញាសង្គម។ រួមបញ្ចូលការបំបែកសមាសភាគ និងប្រវត្តិ 24 ម៉ោងសម្រាប់ការវិភាគទំនោរ។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
សញ្ញាជម្រើស	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

តម្រូវ៖ អ្នកជំនញជំនួញ អ្នកជំនញជំនួញ (កំរិតខ្ពស់)

ត្រឡប់ការដំឡើងការរួមបញ្ចូល TradingView ដែលបានប្ដូរតាមបំណងរបស់អ្នក៖ URL របស់ webhook, សោសម្ងាត់សម្រាប់ការផ្ទៀងផ្ទាត់, និងសូចនាករ Pine Script ដែលអាចប្រើបានភ្លាមៗដែលភ្ជាប់ដោយផ្ទាល់ទៅនឹង Smart Money API។ ចម្លង-បិទ 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

អាចប្រើបានសម្រាប់៖ អ្នកជំនញជំនួញ អ្នកជំនញជំនួញ (កំរិតខ្ពស់)

ទទួលបានការជូនដំណឹងពី TradingView, ដំណើរការវាតាមរយៈ /confirm, ហើយត្រឡប់ការបញ្ជាក់។ TradingView មិនអាចផ្ញើក្បាលផ្ទាល់ខ្លួនបានទេ ដូច្នេះសូមផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវដោយដាក់ webhook របស់អ្នក secret នៅក្នុងរាងកាយ JSON (ចំណុចបញ្ចប់នេះមិនប្រើ X-API-Key ទេ)។ ការឆ្លើយតបរុំការបញ្ជាក់ហើយបន្ថែមកម្រិតកំពូល action នៃ CONFIRMED (ភាពជឿជាក់របស់ daemon 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

តម្រូវ៖ អ្នកជំនញជំនួញ អ្នកជំនញជំនួញ (កំរិតខ្ពស់)

ត្រឡប់ការកំណត់ប្ដូរតាមបំណងបច្ចុប្បន្នរបស់អ្នក រួមទាំងប៉ារ៉ាម៉ែត្រប្រតិបត្តិការលំនាំដើម, ទម្រង់ហានិភ័យ, បញ្ជីតាមដាន, និងចំណូលចិត្តនៃការជូនដំណឹង។

PUT /v1/preferences

ធ្វើបច្ចុប្បន្នភាពការកំណត់ប្ដូរតាមបំណងដោយផ្ញើរាងកាយ JSON ដែលមានផ្នែកណាមួយនៃវាលខាងក្រោម។ វាលដែលមិនត្រូវបានដាក់បញ្ចូលនឹងរក្សាតម្លៃបច្ចុប្បន្នរបស់វា។

វាលនៃការកំណត់ប្ដូរតាមបំណង

វាល	ប្រភេទ	ការពិពណ៌នា
default_trade_size_usd	float	ទំហំតំណែងលំនាំដើមជាដុល្លារ សម្រាប់ការគណនា Kelly និង smart-stop
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 ឧទាហរណ៍ `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": "HIGH"
    },
    {
 "symbol": "SOL",
 "confidence": "HIGH",
 "action": "CONFIRM",
 "regime": "breakout",
 "cascade_risk": "MEDIUM"
    }
  ]
}

ការផ្សព្វផ្សាយពេលវេលាពិត (ការផ្លាស់ប្តូរផ្ទាល់)

ផ្សព្វផ្សាយការផ្លាស់ប្តូរ DEX ≥ $500 ដែលត្រូវបានរកឃើញពេលវេលាពិតពីថ្នាំង BSC និង Avalanche របស់យើង។ មានការដឹកជញ្ជូនពីរប្រភេទ៖ ស្ទ្រីម Server-Sent Events (SSE) សាធារណៈសម្រាប់អតិថិជនឥតគិតថ្លៃ/កម្មវិធីរុករកប្រេស៊ឺ និងស្ទ្រីម WebSocket ពេលវេលាយឺតទាបសម្រាប់កម្រិតបង់ប្រាក់។ ព្រឹត្តិការណ៍ត្រូវបានផ្សព្វផ្សាយក្នុងរយៈពេលវិនាទីបន្ទាប់ពីបញ្ចូលក្នុងប្លុក។

ស្ទ្រីម SSE សាធារណៈ (ឥតគិតថ្លៃ)

អាចប្រើបានសម្រាប់៖ ឥតគិតថ្លៃ អ្នកជំនួញ ជំនាញ

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 (បង់ប្រាក់)

តម្រូវឱ្យមាន៖ អ្នកជំនួញ ជំនាញ

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

ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ (ផ្តល់អនុសាសន៍)៖ កុំដាក់សោរយូរអង្វែងរបស់អ្នកនៅក្នុង URL — វាត្រូវបានកត់ត្រាដោយប្រូកស៊ី និងរក្សាទុកក្នុងប្រវត្តិកម្មវិធីរុករក។ ផ្ទុយទៅវិញ POST សោរបស់អ្នកទៅ /v1/ws/ticket ដោយប្រើ X-API-Key header ដែលមានសុវត្ថិភាព បន្ទាប់មកបើកស៊ុកជាមួយនឹង ticket (មានសុពលភាពប្រហែល 60s ត្រូវបានប្រើប្រាស់ម្តង)។ អតិថិជនផ្នែកម៉ាស៊ីនបម្រើដែលអាចកំណត់ headers អាចឆ្លង X-API-Key ដោយផ្ទាល់នៅលើការចាប់ដៃ។ សោរកម្រិតឥតគិតថ្លៃទទួលបាន 402 payment_required ការឆ្លើយតប។ ក្របខ័ណ្ឌ hello ត្រូវបានផ្ញើនៅពេលតភ្ជាប់ជាមួយកម្រិតរបស់អ្នក និងកម្រិតផ្សព្វផ្សាយ។

JavaScript (កម្មវិធីរុករក)

// 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 របស់អ្នកនៅក្នុង URL WebSocket — ខ្សែសំណួរត្រូវបានកត់ត្រាដោយប្រូកស៊ី ឧបករណ៍រត់ល្បឿន និងរក្សាទុកក្នុងប្រវត្តិកម្មវិធីរុករក។ ផ្ទុយទៅវិញ ផ្លាស់ប្តូរសោរបស់អ្នកសម្រាប់សំបុត្ររយៈពេលខ្លី ប្រើម្តង ticket តាមរយៈ POST ផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវធម្មតា បន្ទាប់មកតភ្ជាប់ជាមួយសំបុត្រនោះ។

លំហូរ៖ POST ទៅ /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 វិនាទី. អតិថិជនដែលដំណើរការនៅលើសាកល្បងអាចកំណត់ក្បាលសំណើជំនួសអោយការបញ្ជូន X-API-Key ដោយផ្ទាល់លើការចាប់ដៃ WebSocket - មិនត្រូវការសំបុត្រទេ។

POST /v1/ws/ticket

តម្រូវ៖ អ្នកជំនួញ អ្នកជំនាញ

បង្កើតសំបុត្រប្រើម្តងសម្រាប់ការចាប់ដៃ WebSocket ដែលបានផ្ទៀងផ្ទាត់។ ផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវជាមួយ X-API-Key ក្បាលសំណើ (សោរបស់អ្នកមិនចេញពីក្បាលសំណើទេ)។ សំបុត្រដែលបានត្រឡប់អាចប្រើប្រាស់បានម្តងនៅលើ /v1/ws/live-swaps មុនពេលវាផុតកំណត់។

cURL

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

ឧទាហរណ៍ការឆ្លើយតប

JSON

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

ចំនុចឆ្លើយតប

ចំនុច	ប្រភេទ	ការពិពណ៌នា
ticket	string	សញ្ញាប័ត្រប្រើម្តងដើម្បីបន្ថែមជា `?ticket=` នៅលើ URL WebSocket។ ប្រើប្រាស់ម្តង បន្ទាប់មកអស់សុពលភាព។
expires_in	number	វិនាទីដល់ពេលសំបុត្រផុតកំណត់ (~60)។ បង្កើតសំបុត្រថ្មីសម្រាប់គោលបំណងប៉ុន្មាន។

ចំណាំ៖ វិធីសាកសួរផ្ទៀងផ្ទាត់ចាស់ ?key= ត្រូវបាន លែងទទួលយកទៀតហើយ នៅលើចំណុចបញ្ចប់ WebSocket ដោយសារហេតុផលសុវត្ថិភាព។ ប្រើសំបុត្រ (អតិថិជនកម្មវិធីរុករក) ឬ X-API-Key ក្បាលសំណើចាប់ដៃ (អតិថិជនដែលដំណើរការនៅលើសាកល្បង)។

រូបថត REST

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

ត្រឡប់នូវការផ្លាស់ប្តូរចុងក្រោយពីផ្ទាំងរំកិល។ មានប្រយោជន៍សម្រាប់ការគូរដំបូងនៅលើផ្ទាំងគ្រប់គ្រងមុនពេលការតភ្ជាប់ស្ទ្រីមបើក។ ក៏មាន៖ /v1/live-swaps/status សម្រាប់ស្ថិតិអ្នកផ្សព្វផ្សាយ។

គំរូព្រឹត្តិការណ៍

ចំនុច	ប្រភេទ	ការពិពណ៌នា
chain	string	`bsc` ឬ `avalanche`
dex	string	ឈ្មោះឧបករណ៍ដឹកជញ្ជូន (ឧទាហរណ៍ `pancakeswap_v2`, `traderjoe`) ឬ `unknown_dex`
swapper	string	អាសយដ្ឋាន 0x ពេញលេញនៃកាបូបដែលបានអនុវត្តការផ្លាស់ប្តូរ
swapper_short	string	ទម្រង់អក្សរកាត់សម្រាប់បង្ហាញ (ឧទាហរណ៍ `0xb300…028d`)
swapper_url	string	តំណផ្ទាល់ទៅកាន់អ្នកផ្លាស់ប្តូរនៅលើកម្មវិធីស្វែងរកប្លុកខ្សែសង្វាក់
tx_hash	string	ហាស់ប្រតិបត្តិការ
explorer_url	string	តំណផ្ទាល់ទៅកាន់ប្រតិបត្តិការនៅលើ BscScan / Snowtrace
token_in	string	សញ្ញាសម្គាល់នៃធានាដែលបានលក់ (ឧទាហរណ៍ `USDT`)
token_out	string	សញ្ញាសម្គាល់នៃធានាដែលបានទិញ
amount_usd	number	តម្លៃ USD នៃការផ្លាស់ប្តូរ (អប្បបរមា៖ $500)
pair	string	ស្លាកគូដែលបានរៀបចំ (ឧទាហរណ៍ `USDT → USDC`)
block	number	លេខប្លុកដែលការផ្លាស់ប្តូរត្រូវបានគេយករ៉ែ
timestamp	number	វិនាទីយុគសម័យ Unix
significance	string	`low` / `medium` / `high` / `critical` ផ្អែកលើទំហំ USD
seq	number	លេខលំដាប់ផ្សព្វផ្សាយដែលមានលក្ខណៈឯកតា - ប្រើសម្រាប់ការរកឃើញគម្លាត

POST /alerts/conditions

តម្រូវ៖ អ្នកជំនាញ

បង្កើតច្បាប់ព្រមានផ្ទាល់ខ្លួនដែលដំណើរការនៅពេលដែលរង្វាស់ដែលបានបញ្ជាក់កាត់ព្រំដែល។ ការព្រមានត្រូវបានផ្ញើតាមវេបហុក អ៊ីមែល ឬផ្លូវជូនដំណឹងនៅលើផ្ទាំងគ្រប់គ្រងអាស្រ័យលើចំណូលចិត្តរបស់អ្នក។

GET /v1/alerts/conditions

ត្រឡប់បញ្ជីនៃលក្ខខណ្ឌព្រមានដែលបានកំណត់រចនាសម្ព័ន្ធរបស់អ្នកជាមួយនឹងលេខសម្គាល់ និងស្ថានភាពបច្ចុប្បន្នរបស់វា។

DELETE /v1/alerts/conditions/{id}

យកចេញជាអចិន្ត្រៃយ៍នូវលក្ខខណ្ឌព្រមានតាមលេខសម្គាល់របស់វា។

GET /v1/alerts/history

ត្រឡប់ព្រឹត្តិការណ៍ដំណើរការព្រមានថ្មីៗជាមួយនឹងពេលវេលា លក្ខខណ្ឌដែលត្រូវគ្នា និងតម្លៃរង្វាស់នៅពេលដំណើរការ។

បង្កើតព្រមាន - តួសំណើ

ចំនុច	ប្រភេទ	ការពិពណ៌នា
namerequired	string	ស្លាកអានបានដោយមនុស្សសម្រាប់ការជូនដំណឹងនេះ (អតិបរមា ៦៤ តួអក្សរ)
metricត្រូវការ	string	ម៉ែត្រដើម្បីតាមដាន។ សូមមើលតារាងម៉ែត្រដែលមានខាងក្រោម។
symbolជាជម្រើស	string	បរិបទអេស៊ីត។ ត្រូវការសម្រាប់ម៉ែត្រដែលមានវិសាលភាពសញ្ញាដូចជា `funding_rate`.
operatorត្រូវការ	string	ប្រមាណវិធីប្រៀបធៀប៖ `gt`, `lt`, `eq`, `crosses_above`, `crosses_below`
thresholdត្រូវការ	float	តម្លៃលេខដើម្បីប្រៀបធៀបម៉ែត្រ
deliveryជាជម្រើស	string	ឆានែលចែកចាយ ឧទាហរណ៍ `telegram` (លំនាំដើម) ឬ `webhook`
cooldown_minutesជាជម្រើស	integer	នាទីអប្បបរមារវាងការបញ្ចូនឡើងវិញ (លំនាំដើម ៦០)

បញ្ជីម៉ែត្រ និងប្រមាណវិធីដែលមានសុពលភាពត្រូវបានត្រឡប់ដោយ GET /v1/alerts/conditions ជា available_metrics និង 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 — តួយ៉ាងខ្លួន

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

GET /kelly

ត្រូវការ៖ Pro

ត្រឡប់ការណែនាំអំពីទំហំទីតាំង Kelly Criterion ដែលបានកែតម្រូវទៅនឹងអត្ថបទសញ្ញាប្រវត្តិសាស្ត្រសម្រាប់សញ្ញា កម្រិតទំនុកចិត្ត និងទិសដៅ។ កំណត់ទំហំទីតាំងដោយផ្អែកលើអត្រាឈ្នះជាក់ស្តែងដើម្បីជៀសវាងការប្រើហិបហោងច្រើនពេក។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
symbolត្រូវការ	string	សញ្ញាអេស៊ីត៖ `BTC`, `ETH`, ឬ `SOL`
confidenceជាជម្រើស	string	កម្រិតទំនុកចិត្តសញ្ញាដើម្បីគំរូ៖ `HIGH`, `MEDIUM`, ឬ `LOW`. លំនាំដើម៖ `HIGH`
directionជាជម្រើស	string	ទិសដៅពាណិជ្ជកម្ម៖ `long` ឬ `short`. លំនាំដើម៖ `long`
account_sizeជាជម្រើស	float	ទំហំគណនីជាដុល្លារសម្រាប់ការគណនា `suggested_size_usd`. លំនាំដើម៖ `10000`

ឧទាហរណ៍ការឆ្លើយតប

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 ត្រូវបានណែនាំសម្រាប់ការធ្វើពាណិជ្ជកម្មផ្ទាល់ដើម្បីគិតពីកំហុសក្នុងការប៉ាន់ប្រមាណ។"
}

ផែនការ Pro ត្រូវបានទាមទារ។ ការគណនាត្រូវបានផ្អែកលើគំរូប្រវត្តិសាស្ត្ររយៈពេល 90 ថ្ងៃដែលត្រូវគ្នានឹងសញ្ញាដែលបានស្នើសុំ កម្រិតទំនុកចិត្ត និងប៉ារ៉ាម៉ែត្រទិសដៅ។

GET /performance

អាចប្រើបានចំពោះ៖ ឥតគិតថ្លៃ អ្នកជំនួញ 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

អាចប្រើបានចំពោះ៖ ឥតគិតថ្លៃ អ្នកជំនួញ 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": "ការហៅផ្ទៀងផ្ទាត់ដាច់ដោយឡែក លទ្ធផលដោះស្រាយក្នុង 24h",
 "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 វត្ថុគឺជាតួលេខតែមួយគត់ដែលបានប្រមូលលើទិន្នន័យដែលអ្នកពិន្ទុមិនដែលឃើញពីមុន — សូមមើលវាកើនឡើងតាមពេលវេលា។ សូមមើល calibration.html សម្រាប់វិធីសាស្ត្រពេញលេញនិងព្រំដែនក្នុងគំរូ / ការធ្វើតេស្តទុកជាមុន។

GET /v1/signals/performance

អាចប្រើបានចំពោះ៖ ឥតគិតថ្លៃ អ្នកជំនួញ Pro មិនត្រូវការការផ្ទៀងផ្ទាត់

ការតាមដានលទ្ធផលសញ្ញានៅទូទាំងពេលវេលាដោះស្រាយច្រើន (4h, 12h, 24h, 72h)។ ត្រឡប់អត្រាចំណុចក្នុងមួយពេលវេលា ចំនួនសញ្ញាសរុប និងការបំបែកតាមប្រភេទសញ្ញា។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
daysជម្រើស	integer	បង្អួចមើលថយក្រោយជាថ្ងៃ។ លំនាំដើម៖ `30`
signal_typeជម្រើស	string	ត្រងតាមប្រភេទ ឧទាហរណ៍ `smart_money_confirm` ឬ `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 }
  },
 ប្រភេទបំបែក: {
 smart_money_confirm: { ចំនួន: 35, hit_rate_24h: 0.61 },
 regime_flip: { ចំនួន: 13, hit_rate_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 មិនត្រូវការការផ្ទៀងផ្ទាត់

លទ្ធផលដែលបានដោះស្រាយសម្រាប់សញ្ញាតែមួយតាមអត្តសញ្ញាណលេខរបស់វា។ ត្រឡប់ជាចំណុច/ខាននៅជួរពេលវេលាដោះស្រាយនីមួយៗ (4h, 12h, 24h, 72h) រួមជាមួយតម្លៃនៅពេលសញ្ញា និងនៅពេលដោះស្រាយ។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
idrequired	integer	លេខសម្គាល់សញ្ញា (ផ្នែកផ្លូវ) ឧទាហរណ៍ `/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 }
  }
}

មូលដ្ឋានហៅដាច់ដោយឡែក។ អត្រាឈ្នះត្រូវបានគណនាក្នុងមួយការហៅបញ្ជាក់ដាច់ដោយឡែក (មួយក្នុងមួយសញ្ញាក្នុងរយៈពេល ៥ នាទី) មិនមែនក្នុងមួយការបុក API គ្រប់ពេលទេ — វាបង្ការការហើមឡើងរបស់ N ពីបណ្តាញដែលពិនិត្យឡើងវិញដដែលៗ។ តួលេខទាំងនេះគឺនៅក្នុងគំរូលើរយៈពេលលំនាំដើម ៣០ ថ្ងៃ; ការព្រមានដូចគ្នានឹង /v1/stats អនុវត្ត។

Shadow Gate

តម្រូវឱ្យមាន៖ ឥតគិតថ្លៃ អ្នកជំនួញ Pro

កំណត់ត្រាសំរេចចិត្តផ្ទាល់ខ្លួនដែលមិនអាចប្តូរបាន និងបន្ថែមតែប៉ុណ្ណោះ។ ដាក់ស្នើសំរេចចិត្តជំនួញរបស់អ្នកមុន ឬក្រោយពេលអនុវត្តវា; ប្រព័ន្ធគណនាពិន្ទុបញ្ជាក់ទៅនឹងយន្តការ Smart Money ហើយបន្ថែមជួរអចិន្ត្រៃយ៍។ ប្រើវាដើម្បីសាងសង់កំណត់ត្រាដែលមានស្ថានីយ៍ពេលវេលាដែលស្មោះត្រង់នៃរបៀបដែលសញ្ញា API ស្របគ្នានឹងការបញ្ចូលរបស់អ្នក — ឯករាជ្យទាំងស្រុងពីស្តុកអត្រាឈ្នះសាកល។ កម្រិតឥតគិតថ្លៃ និងអ្នកជំនួញមានវាលភស្តុតាងដកចេញ; Pro ផ្តល់ការបំបែកពេញលេញ។ ការពន្យារពេលកម្រិតអនុវត្តលើទិន្នន័យកម្រិតឥតគិតថ្លៃ។

POST /v1/shadow-gate/decisions

ដាក់ស្នើសំរេចចិត្តមួយ។ មិនផ្លាស់ប្តូរលើ Idempotency-Key ក្បាលសំណើ — ការដាក់ស្នើសោរដដែលនឹងត្រឡប់ជួរដែលមានស្រាប់ដោយមិនបង្កើតច្បាប់ចម្លង។ ប្រព័ន្ធនឹងហៅយន្តការបញ្ជាក់ភ្លាមៗ ហើយបន្ថែមលទ្ធផលជាជួរកំណត់ត្រាដែលមិនអាចប្តូរបាន។

តួសំណើ

វាល	ប្រភេទ	ការពិពណ៌នា
symbolrequired	string	សញ្ញាទ្រព្យសម្បត្តិ ឧទាហរណ៍ `BTC`
siderequired	string	ទិសដៅជំនួញ៖ `long` or `short`
strategy_idoptional	string	ស្លាកយុទ្ធសាស្ត្រដែលកំណត់ដោយអ្នកហៅ (អតិបរមា ៦៤ តួអក្សរ)។ រក្សាទុកដូចដែលមានសម្រាប់ការដាក់ជាក្រុម និងការត្រង។

ឧទាហរណ៍សំណើ

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,
 "resolved": false
}

កំណត់សម្គាល់កម្រិត។ ការឆ្លើយតបឥតគិតថ្លៃ និងអ្នកជំនួញមិនរាប់បញ្ចូល factors / adjustments វាលភស្តុតាង។ Pro ត្រឡប់ការបំបែកបញ្ជាក់ពេញលេញ។ ការពន្យារពេលកម្រិតអនុវត្តលើឥតគិតថ្លៃ — ជួរត្រូវបានសរសេរភ្លាមៗ ប៉ុន្តែពិន្ទុបញ្ជាក់អាចឆ្លុះបញ្ចាំងទិន្នន័យដែលបានរក្សាទុករហូតដល់ ៦០ វិនាទីចាស់។

GET /v1/shadow-gate/decisions

រាយការណ៍សំរេចចិត្ត shadow-gate របស់អ្នកផ្ទាល់ខ្លួន ថ្មីបំផុតមកដំបូង។ មានដែនកំណត់ម្ចាស់ — មានតែសំរេចចិត្តដែលបានដាក់ស្នើដោយសោ API របស់អ្នកប៉ុណ្ណោះដែលត្រូវបានត្រឡប់។

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
limitoptional	integer	ចំនួនជួរអតិបរមាដើម្បីត្រឡប់។ លំនាំដើម៖ `50`, អតិបរមា៖ `200`
cursoroptional	string	សោរៀងទំព័រដែលមិនច្បាស់លាស់ពី `next_cursor` វាលនៃការឆ្លើយតបមុន។ ទុកចោលសម្រាប់ទំព័រដំបូង។

ឧទាហរណ៍ការឆ្លើយតប

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": ខ្លី, ការសំរេចចិត្ត: SKIP, ភាពជឿជាក់: LOW, រួម: -0.12, ទំហំគុណ: 0.0, ts: 1710937000, បានដោះស្រាយ: True }
  ],
 ចំនួន: 2,
 ចង្អុលបន្ទាប់: None
}

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

ការសំរេចចិត្តតែមួយតាមលេខសម្គាល់ រួមទាំងភស្តុតាងបញ្ជាក់ពេញលេញសម្រាប់កម្រិត Pro។ ចម្លើយនៃកម្រិត Free និង Trader មាន factors និង adjustments បានដកចេញ។ ត្រឡប់ 403 ប្រសិនបើការសំរេចចិត្តជារបស់កូនសោ API ផ្សេង។

ឧទាហរណ៍ចម្លើយ (Pro)

JSON

{
 id: 318,
 សញ្ញា: BTC,
 ផ្នែក: វែង,
 លេខសម្គាល់យុទ្ធសាស្ត្រ: ema_crossover,
 ការសំរេចចិត្ត: CONFIRM,
 ភាពជឿជាក់: HIGH,
 រួម: 0.74,
 ទំហំគុណ: 1.5,
 កត្តា: {
 ដេរីវេ: { ពិន្ទុ: 0.81, ទម្ងន់: 0.40, បានគុណដោយទម្ងន់: 0.324 },
 onchain: { ពិន្ទុ: 0.68, ទម្ងន់: 0.35, បានគុណដោយទម្ងន់: 0.238 },
 whale: { ពិន្ទុ: 0.73, ទម្ងន់: 0.25, បានគុណដោយទម្ងន់: 0.183 }
  },
 ts: 1710940821,
 បានដោះស្រាយ: False,
 លទ្ធផល: None
}

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

ដោះស្រាយលទ្ធផលនៃការសំរេចចិត្តដោយដៃ។ ហៅវាបន្ទាប់ពីបិទអន្តរកម្មដើម្បីកត់ត្រាលទ្ធផលចុងក្រោយទៅលើជួរចំណាំ។ នៅពេលដែលបានដោះស្រាយ ជួរនេះមិនអាចផ្លាស់ប្តូរបានទៀតទេ។

តម្លៃសំណើ

វាល	ប្រភេទ	ការពិពណ៌នា
លទ្ធផលចាំបាច់	ខ្សែអក្សរ	លទ្ធផលអន្តរកម្ម៖ `win` ឬ `loss`
តម្លៃចេញជាជម្រើស	លេខទសភាគ	តម្លៃចេញសម្រាប់អន្តរកម្ម។ ត្រូវបានរក្សាទុកសម្រាប់យោង។ ប្រើដើម្បីគណនា P&L % ប្រសិនបើបានផ្តល់។
pnl_pctជាជម្រើស	លេខទសភាគ	P&L ដែលបានទទួលជាភាគរយនៃទំហំតំណែង ឧទាហរណ៍ `3.5` ឬ `-1.2`

ឧទាហរណ៍ចម្លើយ

JSON

{
 id: 318,
 បានដោះស្រាយ: True,
 លទ្ធផល: ឈ្នះ,
 តម្លៃចេញ: 65800.0,
 pnl_pct: 4.1,
 បានដោះស្រាយនៅ: 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()

# នៅក្នុងរង្វិលជុំ trading របស់អ្នក៖
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
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

# ទាញយកទិន្នន័យ whale
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

បន្ថែមការបញ្ជាក់ Smart Money ទៅក្នុងយុទ្ធសាស្ត្រ Freqtrade ណាមួយដោយការបដិសេធ confirm_trade_entry វិធីសាស្រ្ត។

Python — យុទ្ធសាស្ត្រ Freqtrade

នាំចូល requests
ពី freqtrade.strategy នាំចូល IStrategy

ថ្នាក់ យុទ្ធសាស្ត្រ SmartMoney(IStrategy):
  SM_API_KEY = "sm_your_key"
  SM_BASE = "https://api.smartmoneyapi.com/v1"

 អនុវត្ត បញ្ជាក់ការចូលធ្វើពាណិជ្ជកម្ម(ខ្លួនឯង, គូ, ប្រភេទលំដាប់,
                         ចំនួន, អត្រា, ពេលវេលានៃការបង្ខំ,
                         ពេលវេលាបច្ចុប្បន្ន, ស្លាកចូល, **kwargs):
    សញ្ញា = គូ។បំបែក("/")[0]
 បើ សញ្ញា មិននៅក្នុង ["BTC", "ETH", "SOL"]:
 ត្រឡប់ពិត # រំលងការពិនិត្យសម្រាប់អ្វីដែលមិនគាំទ្រ
 ព្យាយាម:
      r = requests.ទទួល(
        f"{self.SM_BASE}/confirm",
        params={"symbol": សញ្ញា, "direction": "long"},
        headers={"X-API-Key": self.SM_API_KEY},
        timeout=3
      ).json()
 ត្រឡប់ r.ទទួល("confidence") នៅក្នុង ["HIGH", "MEDIUM"]
 លើកលែង:
 ត្រឡប់ពិត # បរាជ័យក្នុងការបើកនៅពេលមានកំហុស API

CCXT + Smart Money

Python — CCXT

នាំចូល ccxt, requests

ការផ្លាស់ប្តូរ = ccxt.bybit({
 "apiKey": "YOUR_BYBIT_KEY",
 "secret": "YOUR_BYBIT_SECRET"
})

SM_KEY = "sm_your_key"

អនុវត្ត ពាណិជ្ជកម្មឆ្លាត(សញ្ញា, ផ្នែក, ចំនួន):
 # ពិនិត្យការបញ្ជាក់ជាមុនសិន
  conf = requests.ទទួល(
 "https://api.smartmoneyapi.com/v1/confirm",
    params={"symbol": សញ្ញា, "direction": ផ្នែក},
    headers={"X-API-Key": SM_KEY}
  ).json()

 បើ conf["confidence"] មិននៅក្នុង ["HIGH", "MEDIUM"]:
 បោះពុម្ព(f"រំលង {symbol} {side} — មិនមានជំនឿទុកចិត្តគ្រប់គ្រាន់។")
 ត្រឡប់ទទេ

  adj_amount = ចំនួន * conf["size_mult"]
  លំដាប់ = ការផ្លាស់ប្តូរ។បង្កើតលំដាប់ទីផ្សារ(
    f"{symbol}/USDT", ផ្នែក, adj_amount
  )
 បោះពុម្ព(f"លំដាប់បានដាក់: {adj_amount} {symbol} {side}")
 ត្រឡប់ លំដាប់

ត្រូវការជំនួយ?

ពិនិត្យ ទំព័រស្ថានភាព API សម្រាប់ព័ត៌មានសុខភាពពេលវេលាពិត ឬប្រើ ទម្រង់ទំនាក់ទំនងរបស់យើង.