ອ້າງອີງ API

Smart Money API

API ລະດັບມືອາຊີບທີ່ລວບລວມຂໍ້ມູນອະນຸພັນ, ຕົວຊີ້ວັດບລັອກເຊີນ, ແລະກິດຈະກຳກະເສດຂອງກະເສດປາເມກາເປັນຄະແນນຄວາມໝັ້ນໃຈດຽວສຳລັບບັອກການຊື້ຂາຍຂອງທ່ານ.

ລຸ້ນ API ປັດຈຸບັນ: v1. URL ພື້ນຖານ: https://api.smartmoneyapi.com/v1

ຫຼັກການອອກແບບ

ສີ່ແນວຄິດທີ່ກຳນົດທຸກໆ endpoint ແລະທຸກໆຄະແນນທີ່ API ນີ້ສົ່ງຄືນ. ພວກມັນຍັງເປັນຂອບເຂດທີ່ຊື່ສັດຂອງສິ່ງທີ່ມັນສັນຍາ — ແລະບໍ່ສັນຍາ — ຈະເຮັດ.

ໃສ່ຍຸດທະສາດກ່ອນ, ບໍ່ແມ່ນສັນຍານກ່ອນ. ນີ້ບໍ່ແມ່ນຟີດສັນຍານຊື້/ຂາຍ. ທ່ານນຳເອົາຍຸດທະສາດແລະຈຸດເຂົ້າ; API ຈະບອກທ່ານວ່າໂຄງສ້າງຕະຫຼາດອ້ອມຂ້າງ — ຕຳແໜ່ງອະນຸພັນ, ການສະໜອງທຶນ, ດລອຽເປີດ, ການປິດບັນຊີ, ກະແສບລັອກເຊີນ, ແລະຄວາມເຫັນດີຂອງປາເມກາ — ຕົກລົງກັບການຊື້ຂາຍທີ່ທ່ານຕ້ອງການຈະເຮັດຫຼືບໍ່.

ຄະແນນຄວາມໝັ້ນໃຈ, ບໍ່ແມ່ນການຄາດເດົາສອງຄ່າ. ທຸກຄຳຕອບມີລະດັບ confidence (ສູງ / ກາງ / ຕ່ຳ) ແລະ composite ຈາກ -1.0 ຫາ +1.0. ບໍ່ມີການຮັບປະກັນແລະບໍ່ມີການເອີ້ນຂໍ້ມູນຈາກ oracle — ທ່ານຈະໄດ້ຮັບການອ່ານທີ່ຖືກປັບຕາມຄວາມເຫັນດີ, ພ້ອມດ້ວຍເຫດຜົນຂອງມັນ, ເພື່ອທີ່ທ່ານຈະສາມາດປັບຂະໜາດໃຫ້ເຫມາະສົມກັບຄວາມເຊື່ອໝັ້ນ.

ສະໜັບສະໜູນການຕັດສິນໃຈ, ບໍ່ແມ່ນຄຳແນະນຳການດຳເນີນການ. API ຈະສົ່ງຄຳແນະນຳ CONFIRM / REDUCE / SKIP ແລະຕົວຄູນຂະໜາດສຳລັບ ຕັດສິນໃຈ ຕັດສິນໃຈຂອງທ່ານເພື່ອດຳເນີນການ. ມັນບໍ່ເຄີຍວາງຄຳສັ່ງ, ແລະບໍ່ມີຫຍັງໃນນີ້ເປັນຄຳແນະນຳດ້ານການເງິນ. ທ່ານຍັງຮັບຜິດຊອບຕໍ່ຄວາມສ່ຽງ, ການກຳນົດຂະໜາດ, ແລະການດຳເນີນການ.

ຕົວຊີ້ວັດທີ່ມີຊີວິດ, ບໍ່ແມ່ນການຮັບປະກັນທີ່ຕັດສິນແລ້ວ. ອັດຕາຊະນະ, ສະຖິຕິລະບົບ, ແລະຕົວເລກຄວາມຖືກຕ້ອງຖືກຄິດໄລ່ຈາກຕົວຢ່າງແລ່ນໄປ ແລະ ເຄື່ອນໄຫວໄປຕາມການເຄື່ອນໄຫວຂອງຕະຫຼາດ. ພວກເຮົາເຜີຍແຜ່ມັນຢ່າງຊື່ສັດ, ລວມທັງເມື່ອມັນບໍ່ດີ. ພິຈາລະນາທຸກຕົວຊີ້ວັດເປັນການສັງເກດປັດຈຸບັນ, ບໍ່ແມ່ນສັນຍາກ່ຽວກັບອະນາຄົດ.

API ນີ້ສຳລັບໃຜ

API ນີ້ຖືກສ້າງຂຶ້ນສຳລັບ ນັກພັດທະນາ bot, algo, ແລະ AI-agent ດ້ານ crypto ຜູ້ທີ່ມີສັນຍານ long/short ຢູ່ແລ້ວ — ຈາກຍຸດທະສາດ TA, ແບບຈຳລອງ ML, ຂະບວນການ Freqtrade, ການແຈ້ງເຕືອນ TradingView, ຫຼື ເຄື່ອງມື LLM — ແລະ ຕ້ອງການການຕັດສິນໃຈ CONFIRM / REDUCE / SKIP ກ່ອນທີ່ຈະລົງທຶນ.

ວົງຈອນທົ່ວໄປ: ຍຸດທະສາດຂອງທ່ານສົ່ງ "go long BTC" → ທ່ານເອີ້ນ GET /v1/confirm?symbol=BTC&direction=long → ທ່ານຢືນຢັນ, ຫຼຸດຜ່ອນ, ຫຼື ຂ້າມຈຸດເຂົ້າ ແລະ ປັບຂະໜາດຕາມ size_mult. ການເອີ້ນຄັ້ງດຽວ, ຕອບຮັບ JSON ຄວາມໄວຕ່ຳຄັ້ງດຽວ, ບໍ່ມີໂຄງສ້າງເສີມ.

ມັນ ບໍ່ແມ່ນ ເຄື່ອງສ້າງສັນຍານດ່ຽວ, ຜະລິດຕະພັນແຜນຜັງ, ຫຼື ສະຖານທີ່ດຳເນີນການ. ຖ້າທ່ານບໍ່ມີສັນຍານຂອງຕົວເອງເພື່ອກັນ, ເລີ່ມຈາກ ໜ້າປະສົບການ ເພື່ອເບິ່ງວ່າຄະແນນໄດ້ປະພຶດຕົວແນວໃດກ່ອນທີ່ຈະເຊື່ອມຕໍ່ມັນກັບ bot ສົດ.

ການເຂົ້າເຖິງ

1 — ລົງທະບຽນ. ສ້າງບັນຊີຟຣີທີ່ signup (ອີເມວ/ລະຫັດຜ່ານ ຫຼື Google). ບໍ່ຕ້ອງການບັດເຄຣດິດສຳລັບລະດັບຟຣີ.

2 — ເປີດແຜງຄວບຄຸມຂອງທ່ານ. ແຜງຄວບຄຸມ ຂອງທ່ານ ສະແດງຄີ API, ແຜນປັດຈຸບັນ, ແລະ ການນຳໃຊ້ສົດທຽບກັບໂຄຕາວັນຂອງທ່ານ.

3 — ຄັດລອກຄີ API ຂອງທ່ານ. ຄີເລີ່ມຕົ້ນດ້ວຍ sm_. ສົ່ງມັນເປັນ X-API-Key ຫົວຂໍ້ໃນທຸກຄຳຮ້ອງ (ເບິ່ງ ການຢືນຢັນຕົວຕົນ). ອັບເກຣດໄດ້ທຸກເວລາໃນ ໜ້າລາຄາ ເພື່ອຍົກລະດັບຂອບເຂດ ແລະ ປົດລັອກສັນຍາລັກ ແລະ ຈຸດສິ້ນສຸດເພີ່ມເຕີມ.

ຂໍ້ກຳນົດ, SDK & ປື້ມອາຫານ

ທຸກຢ່າງທີ່ທ່ານຕ້ອງການເພື່ອປະສານງານໄວວາ, ບໍ່ວ່າທ່ານຈະຂຽນລະຫັດເອງ ຫຼື ມອບໃຫ້ແອັດຈອນຂຽນລະຫັດ.

ຊັບພະຍາກອນ	ມັນແມ່ນຫຍັງ
ປື້ມອາຫານ	ສູດກ໋ອບປີ້ສຳລັບການປະສານງານທົ່ວໄປ - ຢືນຢັນກ່ອນເຂົ້າ, ກັນສັນຍານ Freqtrade, ຂະໜາດໂດຍຕົວຄູນ, ຈັດການ 402/429, ແລະ ເຊື່ອມຕໍ່ກັບແອັດຈອນຂຽນລະຫັດ.
ຂໍ້ກຳນົດ OpenAPI	ຄຳອະທິບາຍ OpenAPI ທີ່ເຄື່ອງຈັດການໄດ້. ນຳເຂົ້າ Postman/Insomnia, ສ້າງລູກຄ້າ, ຫຼື ສົ່ງໃຫ້ LLM. ຢູ່ `github.com/tashiardit/smartmoneyapi-docs`.
ລູກຄ້າ Python	ຫໍສະໝຸດລູກຄ້າ Python ທາງການຢູ່ `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	ບົດສະຫຼຸບ API ແບບຂໍ້ຄວາມງ່າຍທີ່ເໝາະສຳລັບ LLM. ຊີ້ Claude, Codex, ຫຼື Cursor ໄປທີ່ນັ້ນ (ເບິ່ງ ແອັດຈອນຂຽນລະຫັດ).

ເລີ່ມຕົ້ນໄວໃນ 2 ນາທີ

ຂັ້ນຕອນທີ 1 — URL ພື້ນຖານ. ທຸກໆຈຸດສິ້ນສຸດຢູ່ໃຕ້:

URL ພື້ນຖານ
https://api.smartmoneyapi.com

ຂັ້ນຕອນທີ 2 — ເອົາກະແຈ API ຂອງທ່ານ. ລົງທະບຽນຟຣີ (ບໍ່ຕ້ອງການບັດເຄຣດິດ) ແລະ ກ໋ອບປີ້ກະແຈຂອງທ່ານຈາກ ແຜງຄວບຄຸມ. ສົ່ງມັນເປັນ X-API-Key ຫົວຂໍ້ໃນທຸກໆຄຳຮ້ອງຂໍ.

ຂັ້ນຕອນທີ 3 — ການເອີ້ນຄັ້ງທຳອິດຂອງທ່ານ. ວາງນີ້ເຂົ້າໃນ terminal ຂອງທ່ານ ແລະ ແທນທີ່ 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 header.

HTTP Header
X-API-Key: sm_your_api_key_here

ກະແຈ API ຂອງທ່ານສາມາດເຂົ້າເຖິງໄດ້ຈາກ ແດຊບອດ ຫຼັງຈາກລົງທະບຽນ. ຮັກສາກະແຈຂອງທ່ານເປັນຄວາມລັບ — ຢ່າເປີດເຜີຍມັນໃນລະຫັດດ້ານລູກຄ້າຫຼືສາງສາທາລະນະ.

ການຢືນຢັນ WebSocket ແຕກຕ່າງກັນ. ຢ່າເອົາກະແຈຂອງທ່ານໃສ່ໃນ URL WebSocket. ສະຕີມເວລາຈິງໃຊ້ ປີ້: POST ກະແຈຂອງທ່ານໄປຫາ /v1/ws/ticket ພ້ອມກັບ X-API-Key header, ຈາກນັ້ນເຊື່ອມຕໍ່ດ້ວຍປີ້ທີ່ກັບຄືນມາ. ເບິ່ງ ການຢືນຢັນ WebSocket (ປີ້).

Google Sign-In (Firebase Auth)

ຜູ້ໃຊ້ສາມາດຢືນຢັນຕົວຕົນໂດຍໃຊ້ບັນຊີ Google ຜ່ານ Firebase Authentication. ຫຼັງຈາກເຂົ້າສູ່ລະບົບ Google ສຳເລັດໃນລູກຄ້າ, ແລກປ່ຽນໂທເຄັນ ID Firebase ເພື່ອເຊື່ອມຕໍ່ກັບຊຸດ API. ລະບົບຈະປະສານການຢືນຢັນຕົວຕົນ Google ຂອງທ່ານໂດຍອັດຕະໂນມັດກັບລະບົບກະແຈ API.

ມີໃຫ້ສຳລັບ: Free Trader Pro

POST /auth/google

ຕົວຂອງການຮ້ອງຂໍ

ຟີວ	ປະເພດ	ຄຳອະທິບາຍ
id_tokenຕ້ອງການ	string	ໂທເຄັນ ID Firebase ທີ່ໄດ້ຮັບຫຼັງຈາກເຂົ້າສູ່ລະບົບ Google ໃນລູກຄ້າ

ຕົວຢ່າງການຕອບຮັບ

JSON

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

ຂໍ້ມູນໂປຣໄຟລ໌ຜູ້ໃຊ້ — ອີເມວ, ແຜນ, ປະຫວັດການໃຊ້ງານ, ຄວາມມັກ — ຖືກເກັບຮັກສາໄວ້ໃນ Firestore ແລະເຊື່ອມຕໍ່ກັບບັນຊີ Google ຂອງທ່ານ. ການສົ່ງອອກຂໍ້ມູນທັງໝົດຫຼືການລົບບັນຊີສາມາດຮ້ອງຂໍໄດ້ທຸກເວລາຜ່ານການຕັ້ງຄ່າຄວາມເປັນສ່ວນຕົວໃນແດຊບອດ.

ຈຳກັດອັດຕາ

ແຜນ	ການເອີ້ນ/ມື້	ຈຳກັດການລະເບີດ	ການຊັກຊ້າຂໍ້ມູນ
Free	50	2/min	60 ວິນາທີ
Trader	1,000	20/min	ເວລາຈິງ
Pro	5,000	60/min	ເວລາຈິງ
ວິສາຫະກິດ	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	unauthorized	ຂາດຫຼື API key ບໍ່ຖືກຕ້ອງ. ກວດສອບ `X-API-Key` header ມີຢູ່ ແລະ ຖືກຕ້ອງ.
402	payment_required	ຈຸດສິ້ນສຸດ ຫຼື ສັນຍາລັກຕ້ອງການແຜນທີ່ສູງກວ່າທີ່ກຸນແຈຂອງທ່ານມີ (ຕົວຢ່າງ: ກຸນແຈຟຣີເອີ້ນໃຊ້ WebSocket firehose). ອັບເກຣດ ຫຼື ກັບໄປໃຊ້ຈຸດສິ້ນສຸດສາທາລະນະ.
429	rate_limit_exceeded	ເຖິງຂີດຈຳກັດປະຈຳວັນ ຫຼື ການລະເບີດ. ຖອຍກັບ ແລະ ລອງໃໝ່ຫຼັງຈາກ `X-RateLimit-Reset`; ຢ່າພະຍາຍາມເຮັດຊ້ຳໆ.

ທຸກຂໍ້ຜິດພາດຈະສົ່ງຄ່າກັບຮູບແບບດຽວກັນ:

JSON
{
 "error": "rate_limit_exceeded",
 "message": "ເຖິງຂີດຈຳກັດ 50 ຄັ້ງຕໍ່ວັນ. ຈະຣີເຊັດໃນເວລາ 00:00 UTC.",
 "status": 429
}

ສຳລັບລາຍຊື່ລະຫັດສະຖານະທັງໝົດ (400 / 403 / 500 / 503 ແລະ ອື່ນໆ), ເບິ່ງ ລະຫັດຂໍ້ຜິດພາດ. ການລວມຕົວທີ່ເຂັ້ມແຂງຈະຖືກ 5xx ແລະ 429 ເປັນຊົ່ວຄາວ (ລອງໃໝ່ດ້ວຍ backoff) ແລະ 401/402/403 ເປັນສິ້ນສຸດ (ແກ້ໄຂກຸນແຈ ຫຼື ແຜນ).

ວິທີປະຕິບັດດ້ານຄວາມປອດໄພທີ່ດີທີ່ສຸດ

ສົ່ງກຸນແຈໃນ header, ບໍ່ແມ່ນ URL. ຈົ່ງສົ່ງ X-API-Key ເປັນ HTTP header ສະເໝີ. ກຸນແຈໃນ query strings (?key=) ຈະຖືກບັນທຶກໂດຍ proxies, load balancers, ແລະ ປະຫວັດບຣາວເຊີ — ການ ?key= auth ແບບເກົ່າບໍ່ຖືກຍອມຮັບໃນຈຸດສິ້ນສຸດ WebSocket ເພາະເຫດຜົນນີ້ໂດຍກົງ.

ເກັບກຸນແຈໄວ້ທາງເຊີບເວີ. ຢ່າໃສ່ API key ໃນ 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 convention) ເພື່ອເບິ່ງພາບລວມທີ່ກະຊິບ, ແລ້ວເບິ່ງຂໍ້ກຳນົດ OpenAPI ເພື່ອຮູບແບບການຮ້ອງຂໍ/ຕອບຮັບທີ່ແນ່ນອນ. ຄຳສັ່ງເສັ້ນດຽວທີ່ເຮັດວຽກໄດ້ດີ:

ຄຳສັ່ງ

# ວາງໃສ່ Claude Code / Cursor / Codex
ອ່ານ https://smartmoneyapi.com/llms.txt ແລະ ຂໍ້ກຳນົດ OpenAPI ທີ່
github.com/tashiardit/smartmoneyapi-docs, ແລ້ວເພີ່ມການກວດສອບກ່ອນການຊື້ຂາຍ
ໃຫ້ bot ຂອງຂ້ອຍທີ່ເອີ້ນໃຊ້ GET /v1/confirm ແລະ ຂ້າມຂໍ້ມູນ
ຍົກເວັ້ນເມື່ອ action ແມ່ນ CONFIRM.

ເບິ່ງ ປຶ້ມອາຫານ ສຳລັບສູດການໃຊ້ງານຕົວແທນການຂຽນໂຄດທີ່ເຮັດໄດ້ແລ້ວ.

ຈຸດສິ້ນສຸດ

GET /confirm

ຈຸດສິ້ນສຸດຫຼັກ. ສົ່ງຄ່າຄະແນນຄວາມໝັ້ນໃຈປະສົມ ແລະ ຄຳແນະນຳການດຳເນີນການສຳລັບທິດທາງການຊື້ຂາຍທີ່ກຳນົດ. ໃຊ້ສິ່ງນີ້ກ່ອນຈະເຂົ້າຕຳແໜ່ງໃດໆ.

ຂອບເຂດການຄຸ້ມຄອງ, ເວົ້າແບບງ່າຍໆ. /confirm ປະຈຸບັນໃຫ້ຄະແນນ BTC, ETH ແລະ SOL — ສັນຍາລັກທີ່ມີປະຫວັດການແກ້ໄຂພຽງພໍທີ່ຈະຢືນຢັນໄດ້ຢ່າງຊື່ສຽງ. ຕົວກວດສອບອະນຸພັນແຍກຕ່າງຫາກ ຕິດຕາມປະມານ 519 ຕະຫຼາດອະນຸພັນ ສຳລັບຂໍ້ມູນການສະໜອງທຶນ, OI ແລະ ການປິດບັນຊີ, ແລະ ການຕິດຕາມປາກົດປະມານ 600+ ກະເປົາເງິນ. Pro ຈະປົດລັອກຕົວກວດສອບເຕັມຮູບແບບ, ການສົ່ງອອກ ແລະ ຂອບເຂດຕະຫຼາດທີ່ກວ້າງຂຶ້ນ; /confirm ການສະໜັບສະໜູນສັນຍາລັກຈະຂະຫຍາຍໄປທຸກໆຕະຫຼາດທີ່ມີປະຫວັດຜົນປະສົບຄວາມສຳເລັດທີ່ໜ້າເຊື່ອຖື.

ພາຣາມີເຕີ

ພາຣາມີເຕີ	ປະເພດ	ຄຳອະທິບາຍ
symbolຕ້ອງການ	string	ສັນຍາລັກຊັບສິນ. ໜຶ່ງໃນ: `BTC`, `ETH`, `SOL` (Trader+)
directionຕ້ອງການ	string	ທິດທາງການຊື້ຂາຍ: `long` ຫຼື `short`
sourceບໍ່ຈຳເປັນ	string	ປ້າຍສຳລັບແຫຼ່ງສັນຍານຂອງທ່ານ (ຖືກບັນທຶກເພື່ອວິເຄາະ). ສູງສຸດ 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,
 ປັດໄຈ: {
 ອະນຸພັນ: { ຄະແນນ: 0.81, ນ້ຳໜັກ: 0.40, ຖືກຄູນນ້ຳໜັກ: 0.324 },
 onchain: { ຄະແນນ: 0.68, ນ້ຳໜັກ: 0.35, ຖືກຄູນນ້ຳໜັກ: 0.238, ແຫຼ່ງຂໍ້ມູນ: coinmetrics, ມີຢູ່: True },
 whale: { ຄະແນນ: 0.73, ນ້ຳໜັກ: 0.25, ປັດໄຈຄວາມລ້າສະໄຫມ: 1.0, ຖືກຄູນນ້ຳໜັກ: 0.183 }
  },
 ການປັບຕົວ: { ຄວາມເຫັນດີຮ່ວມ: 0.0, ແນວໂນ້ມ: 0.0, ຂ່າວແລະເສດຖະກິດ: 0.0 },
 ນ້ຳໜັກ: { ອະນຸພັນ: 0.40, onchain: 0.35, whale_intel: 0.25 },
 ການຄຸ້ມຄອງ: { ອະນຸພັນ: True, whale: True, onchain: True },
 ເຫດຜົນ: [
 ອັດຕາການຊຳລະບັງຄັບໃນທຸກສະຖານທີ່ເປັນບວກ,
 LSR ສະໜັບສະໜູນການຊື້ຍາວ: 1.42,
 ວາລະ: 67% ການຕົກລົງເຫັນດີການຊື້ຍາວ,
 MVRV ສູງກວ່າ 1.0 — ສະຖານະພາບບວກຈາກ on-chain
  ]
}

ເປີດເຜີຍຕາມການອອກແບບ. ທຸກຄຳຕອບປະກອບດ້ວຍ factors object ສະແດງໃຫ້ເຫັນແຕ່ລະຂາ ຄະແນນ × ນ້ຳໜັກ = ຜົນການຄູນນ້ຳໜັກ ສ່ວນຮ່ວມ, ແລະ adjustments object ສຳລັບການປັບຕົວຫຼັງການກັ່ນຕອງ, ແລະ weights ທີ່ໃຊ້, ແລະ coverage map. ຂາ on-chain ໃຊ້ ຂໍ້ມູນ Coin Metrics ຟຣີທີ່ແທ້ຈິງ (MVRV / ການໄຫຼຂອງແລກປ່ຽນ / ທີ່ຢູ່ທີ່ເຄື່ອນໄຫວ) ເມື່ອບໍ່ມີກະແຈ Glassnode ຖືກຕັ້ງ. ນີ້ແມ່ນການປະສົມປະສານຫຼາຍປັດໄຈ ການລວມຕົວ ຄະແນນ — ການສະໜັບສະໜູນການຕັດສິນໃຈ, ບໍ່ແມ່ນອັດຕາຊະນະທີ່ຮັບປະກັນ.

ສັນຍາລັກທີ່ບໍ່ຖືກຕິດຕາມແມ່ນຊື່ສັດ. ສັນຍາລັກນອກຈາກຈັກກະວານອະນຸພັນ/ວາລະທີ່ຖືກຕິດຕາມຈະສົ່ງຄ່າ "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" ພ້ອມກັບ "unsupported":true — ບໍ່ເຄີຍປອມແປງ LOW.

ຟີວຂໍ້ມູນຄຳຕອບ

ຟີວ	ປະເພດ	ຄຳອະທິບາຍ
ts	integer	ເວລາ Unix ຂອງການຄຳນວນ
symbol	string	ສັນຍາລັກຊັບສິນ (BTC/ETH/SOL)
direction	string	ທິດທາງທີ່ຮ້ອງຂໍ (ຍາວ/ສັ້ນ)
composite	float	ຄະແນນການລວມຕົວຈາກ -1.0 (ຕໍ່ຕ້ານຢ່າງແຮງ) ເຖິງ +1.0 (ຢືນຢັນຢ່າງແຮງ). ບໍ່ແມ່ນອັດຕາຊະນະ.
base_composite	float	ການລວມຕົວກ່ອນທີ່ຈະປັບຕົວຫຼັງການກັ່ນຕອງ
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	ຄະແນນຍ່ອຍອະນຸພັນ (-1 ເຖິງ 1)
onchain_score	float	ຄະແນນຍ່ອຍ on-chain (-1 ເຖິງ 1)
whale_score	float	ຄະແນນຍ່ອຍຄວາມເຫັນດີຮ່ວມຂອງວາລະ (-1 ເຖິງ 1)
x_score	float	ຄະແນນຍ່ອຍ X/ຄວາມຮູ້ສຶກສັງຄົມ (-1 ເຖິງ 1); 0 ເມື່ອບໍ່ໃຊ້
factors	object	ການແຍກຕາມຂາ: `score × weight = weighted` ສຳລັບອະນຸພັນ / onchain / whale / x_sentiment (onchain ລວມມີ `source`)
adjustments	object	ການປັບຕົວຫຼັງການກັ່ນຕອງ (ຄວາມເຫັນດີຮ່ວມ, ແນວໂນ້ມ, rsi_1h, ຂ່າວແລະເສດຖະກິດ, ແຮງຈູງໃຈ, ເວລາຂອງມື້, ການສະຫຼາຍລົງ)
weights	object	ຊຸດນ້ຳໜັກທີ່ໃຊ້ຈິງສຳລັບການປະເມີນນີ້
coverage	object	`{derivatives, whale, onchain}` — ຂາໃດທີ່ມີຂໍ້ມູນຈິງ
reasons	array	ຂໍ້ຄວາມອະທິບາຍຄະແນນທີ່ເຂົ້າໃຈໄດ້ງ່າຍ

GET /snapshot

ສົ່ງຄ່າ snapshot ຕະຫຼາດເຕັມລວມທັງຄະແນນຍ່ອຍ, ຕົວຊີ້ວັດດິບ, ແລະຄ່າຕົວຊີ້ວັດສຳລັບສັນຍາລັກທີ່ລະບຸ. ເປັນປະໂຫຍດສຳລັບ dashboard ແລະການບັນທຶກ.

ຕ້ອງການ: ຜູ້ຊື້ຂາຍ Pro

GET /onchain

ສົ່ງຄືນຂໍ້ມູນດ້ານ on-chain ດິບ: MVRV, SOPR, ກະແສເງິນສົດຈາກການຊື້ຂາຍ, ອັດຕາສ່ວນມູນຄ່າຕະຫຼາດທີ່ຄິດໄລ່, ແລະການຈັດປະເພດຕຳແໜ່ງວົງຈອນ.

ຮຽກຮ້ອງ: ຜູ້ຊື້ຂາຍ Pro

GET /v1/derivatives/*

ເຄື່ອງມືສະແກນຕະຫຼາດ derivatives ຂ້າມກັບສັນຍານ 500+ ຊະນິດ: ແผນຜັງອັດຕາດອກເບ້ຍ, ການຈັດອັນດັບດຸນສິນຄ້າຄົງຄັງ, ແລະການຕັດສິນເຫັນອັດຕາສ່ວນຊື້ຍາວ/ຂາຍສັ້ນ. 10 ແຖວທຳອິດແມ່ນສາທາລະນະ; ເຄື່ອງມືສະແກນເຕັມຮູບແມ່ນຕ້ອງການຜູ້ຊື້ຂາຍ ຫຼື Pro. ຈຸດສິ້ນສຸດ: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET /v1/options/*

ຂໍ້ມູນວິເຄາະ options BTC & ETH ຈາກ Deribit (ສາທາລະນະ, ບໍ່ຕ້ອງການການຢືນຢັນ): ອັດຕາສ່ວນ put/call, ຈຸດທີ່ເຈັບປວດສຸດຂີດ, ແລະດຸນສິນຄ້າຄົງຄັງແຕ່ລະລາຄາເປົ້າໝາຍ. ຈຸດສິ້ນສຸດ: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

ຂໍ້ມູນກະແສເງິນສົດປະຈຳວັນຂອງ ETF BTC & ETH ແບບ spot ແລະການແບ່ງຍ່ອຍແຕ່ລະກອງທຶນ (ສາທາລະນະ). ຈຸດສິ້ນສຸດ: /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 ຕຳແໜ່ງສູງສຸດ (ສຳລັບ Pro ເທົ່ານັ້ນ), ແລະຈຳນວນກະເງິນ.

ຮຽກຮ້ອງ: ຜູ້ຊື້ຂາຍ Pro

GET /signals

ສົ່ງຄືນສະຕີມຂໍ້ມູນສັນຍານ HIGH/MEDIUM ລ່າສຸດຈາກທຸກໆຊັບສິນທີ່ຖືກຕິດຕາມ. ເປັນປະໂຫຍດສຳລັບການສະແກນໂອກາດ.

ຮຽກຮ້ອງ: Pro

GET /v1/strategies/*

ບັນທຶກຜົນງານທີ່ເປີດເຜີຍ, ອ່ານໄດ້ຢ່າງດຽວສຳລັບຍຸດທະສາດການຊື້ຂາຍອັດຕະໂນມັດທີ່ດຳເນີນການເທິງພື້ນຖານສັນຍານ Smart Money — ລວມທັງ deriv40 ຍຸດທະສາດ SmartMoney Copytrade (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).

ຮຽກຮ້ອງ: 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

ລົງທະບຽນ URL HTTPS ເພື່ອຮັບການສົ່ງສັນຍານເຫດການໃນເວລາຈິງເມື່ອມີສັນຍານເກີດຂຶ້ນໃນຊັບສິນທີ່ທ່ານກວດສອບ. ການສົ່ງຈະພາໄປພ້ອມກັບ X-SmartMoney-Event header ແລະ ລະຫັດ HMAC-SHA256 ໃນ X-SmartMoney-Signature, ແລະ ຈະລອງສົ່ງຄືນໄດ້ເຖິງ 3 ຄັ້ງ ພ້ອມກັບ backoff.

Request Body

Field	Type	Description
urlrequired	string	ຈຸດສິ້ນສຸດ HTTPS ທີ່ຈະສົ່ງເຫດການໄປຫາ (ຕ້ອງເລີ່ມຕົ້ນດ້ວຍ `https://`)
eventsrequired	array	ຊື່ເຫດການ, ຕົວຢ່າງ `["HIGH","MEDIUM","VETO"]` ຫຼື `["*"]`
symbolsrequired	array	ສັນຍາລັກທີ່ຈະກັ່ນຕອງ, ຕົວຢ່າງ `["BTC","ETH"]` ຫຼື `["*"]`
secretrequired	string	ລະຫັດລັບການເຊັນຂອງທ່ານ, ≥ 16 ຕົວອັກສອນ (ເກັບໄວ້ໃນຮູບແບບ hashed)

ການກວດສອບລະຫັດ

ກະແຈ HMAC ແມ່ນຜົນລວມຂອງ SHA-256 hex ຂອງລະຫັດທີ່ລົງທະບຽນໄວ້. ຄຳນວນ HMAC-SHA256 ຂອງ request body ດ້ວຍກະແຈນັ້ນ ແລະ ປຽບທຽບ (ໃນເວລາຄົງທີ່) ກັບ X-SmartMoney-Signatureເບິ່ງ ຄູ່ມືການປະຕິບັດ Webhook.

ຄວາມສະຫຼາດ

GET /analysis

ຕ້ອງການ: Pro

ສົ່ງຄືນການຈຳແນກລະບົບຕະຫຼາດທີ່ໃຊ້ AI ພ້ອມການກວດພົບຂໍ້ຂັດແຍ້ງຂອງສັນຍານ. ວິເຄາະຄວາມສອດຄ່ອງຂອງສັນຍານຂ້າມ, ຈຳແນກຄວາມແຕກຕ່າງລະຫວ່າງອະນຸພັນ, ຂໍ້ມູນບັນຊີລາຍການ, ແລະຂໍ້ມູນຈາກວານ, ແລະສ້າງບົດສະຫຼຸບທີ່ເປັນພາສາທຳມະດາພ້ອມກັບປັດໄຈຄວາມສ່ຽງທີ່ມີທິດທາງເບິ່ງໄປຂ້າງຫນ້າແລະຄຳແນະນຳທີ່ມີເວລາກຳນົດ.

ພາລາມິເຕີ

ພາລາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
symbolຕ້ອງການ	string	ສັນຍາລັກຊັບສິນ: `BTC`, `ETH`, ຫຼື `SOL`

ຕົວຢ່າງການຕອບຮັບ

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "regime": "late_cycle_divergence",
 "regime_label": "Late Cycle — Signal Divergence",
 "summary": "BTC ຢູ່ໃນຊ່ວງທີ່ສຸດທ້າຍຂອງວົງຈອນຂຶ້ນທີ່ມີຄວາມເຂັ້ມແຂງຂອງບັນຊີລາຍການຂັດແຍ້ງກັບການຂະຫຍາຍຕົວຂອງອະນຸພັນ. ວານກຳລັງຫຼຸດການເປີດເຜີຍໃນຂະນະທີ່ LSR ຂອງຜູ້ຊົມໃຊ້ທົ່ວໄປກຳລັງເພີ່ມຂຶ້ນ.",
 "signal_conflicts": [
 ຄະແນນປາການຂອງວາລ໌ເປັນດ້ານລົງ ໃນຂະນະທີ່ຄະແນນອອນເຊນເປັນດ້ານຂຶ້ນ,
 ອັດຕາທຶນຢູ່ລະດັບສູງສຸດໃນ 3 ເດືອນ — ມີຄວາມສ່ຽງທີ່ຈະຖືກບີບຂາຍ
  ],
 ປັດໄຈຄວາມສ່ຽງ: [ອັດຕາທຶນສູງ, ຄວາມແຕກຕ່າງຂອງ OI, ການຫຼຸດລົງຂອງວາລ໌],
 ຄຳແນະນຳ: ຫຼຸດການຖືຂາຍຍາວ, ເຂັ້ມງວດຈຸດຢຸດຂາຍ. ຫຼີກລ່ຽງການຖືຂາຍຍາວໃໝ່ເກີນລາຄາປັດຈຸບັນ.,
 ໄລຍະເວລາ: 4h–12h
}

ຕ້ອງໃຊ້ແຜນ Pro. ຈຸດສິ້ນສຸດນີ້ໃຊ້ 3 ຄຳຮ້ອງຂໍ API ຕໍ່ຄຳຮ້ອງຂໍເນື່ອງຈາກຄ່າໃຊ້ຈ່າຍໃນການປະມວນຜົນ AI.

GET /liquidations

ຕ້ອງການ: Trader Pro

ສົ່ງຄືນ ມຸມມອງສອງຢ່າງທີ່ເສີມກັນ: (1) ຄາດຄະເນຈາກ leverage levels — ການປະເມີນຂອງ ບ່ອນທີ່ ກຸ່ມການລົງໂທດຕັ້ງຢູ່; ແລະ (2) ເປັນ realized_heatmap — ການ ບັງຄັບລົງໂທດທີ່ຖືກປະຕິບັດຕົວຈິງ ຄວາມເຂັ້ມຂຸ້ນຂອງການລົງໂທດບັງຄັບ (ລາຄາ × ເວລາ), ລວບລວມແບບສົດຈາກຊ່ອງທາງ WebSocket ຂອງຕະຫຼາດສາທາລະນະ: Binance, OKX, Bybit, Bitget, BitMEX. ແผນຜັງຄວາມຮ້ອນຈະສະແດງເມື່ອສະຕີມມີຂໍ້ມູນສຳລັບສັນຍາລັກນັ້ນ (ຈະບໍ່ສະແດງໃນຕະຫຼາດທີ່ສະຫງົບຫຼາຍ ຫຼື ຫຼັງຈາກເລີ່ມຕົ້ນໃໝ່).

ພາຣາມິເຕີ

ພາຣາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
ສັນຍາລັກທາງເລືອກ	ສະຕຣິງ	ສັນຍາລັກຊັບສິນ (ຄ່າເລີ່ມຕົ້ນ `BTC`). ແຜນທີ່ຄວາມຮ້ອນທີ່ແທ້ຈິງກວມເອົາສັນຍາລັກ perp ທີ່ມີການຊື້ຂາຍຢ່າງຕັ້ງໜ້າ.

ຕົວຢ່າງການຕອບຮັບ

JSON

{
 "symbol": "BTC",
 "cascade_risk": "HIGH",
 "nearest_long_liq_pct": -3.2,
 "nearest_short_liq_pct": 4.1,
 // ການລະລາຍທີ່ຖືກປະຕິບັດແທ້ຈິງ — ສົ່ງຕໍ່ກັນຕົວຈິງຈາກ 5 ຕະຫຼາດ
 "realized_heatmap": {
 "window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
 "clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
 "by_side": { "long": 6100000.0, "short": 2400000.0 },
 "totals": { "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
  }
}

ແຜນຜູ້ຊື້ຂາຍ: cascade_risk, ໄລຍະທາງໃກ້ທີ່ສຸດ, ແລະ ຈຳນວນທີ່ຖືກລະລາຍທີ່ແທ້ຈິງ/ແບ່ງຕາມດ້ານ. ແຜນ Pro: ການຄາດຄະເນເຕັມຮູບແບບ levels ບວກກັບທັງໝົດ realized_heatmap (ຕາຕະລາງ, ກຸ່ມຕາມລາຄາ, ຈຳນວນຕາມຕະຫຼາດ). ການຄາດຄະເນຕອບຄຳຖາມ "ຢຸດຢູ່ໃສ"; ແຜນທີ່ຄວາມຮ້ອນທີ່ແທ້ຈິງສະແດງ "ສິ່ງທີ່ຖືກລະລາຍແທ້ຈິງ."

GET /liquidations/heatmap

ມີສຳຫຼັບ: ຟຣີ ບໍ່ຕ້ອງການກວດສອບຕົວຕົນ (ຈຳກັດອັດຕາຕໍ່ IP)

ສາທາລະນະ ແຜນທີ່ຄວາມຮ້ອນການລະລາຍລະດັບລາຄາ. ສົ່ງຄືນຕາຕະລາງແບບ Coinglass ຂອງລາຄາ × ເວລາ ການລະລາຍທີ່ຖືກປະຕິບັດແທ້ຈິງ ການລະລາຍບັງຄັບ, ຖືກຈັດເຂົ້າກຸ່ມຕາມລາຄາທີ່ແຕ່ລະການລະລາຍເກີດຂຶ້ນ — ລວບລວມຕົວຈິງຈາກການສົ່ງຂໍ້ມູນ WebSocket ສາທາລະນະຂອງຕະຫຼາດ: Binance, OKX, Bybit, Bitget, BitMEX. ອາເລ clusters ແມ່ນຜົນຜະລິດທີ່ໃຊ້ໄດ້ຈິງ: ກຸ່ມລາຄາທີ່ຈັດອັນດັບຕາມມູນຄ່າທີ່ຖືກລະລາຍ, ແຕ່ລະອັນມີປ້າຍດ້ານທີ່ເປັນເຈົ້າການ. ຂໍ້ມູນຂຶ້ນກັບການສົ່ງຕົວຈິງ — ສັນຍາລັກທີ່ງຽບຫຼາຍ ຫຼື ປະຕູທາງທີ່ພຽງແຕ່ເລີ່ມຕົ້ນໃໝ່ຈະສົ່ງຄືນໂຄງສ້າງຫວ່າງທີ່ຖືກຕ້ອງພ້ອມກັບ note. ລະດັບທີ່ສະແດງແມ່ນມີແຕ່ການລະລາຍທີ່ແທ້ຈິງ, ບໍ່ເຄີຍເປັນການຄາດຄະເນ.

ພາຣາມິເຕີ

ພາຣາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
symboloptional	string	ສັນຍາລັກຊັບສິນ (ຄ່າເລີ່ມຕົ້ນ `BTC`).
window_minutesoptional	int	ຊ່ວງເວລາກັບຄືນໃນນາທີ (ຄ່າເລີ່ມຕົ້ນ `240`, ຈຳກັດຢູ່ 5–1440).
price_bucketsoptional	int	ຈຳນວນຖັງລາຄາ (ຄ່າເລີ່ມຕົ້ນ `50`, ຈຳກັດຢູ່ 5–100).

ຕົວຢ່າງຕອບກັບ

JSON

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

ບັນທຶກຄວາມຈິງ: ຈຸດສຸດທ້າຍນີ້ສະທ້ອນໃຫ້ເຫັນສິ່ງທີ່ການສົ່ງສັນຍານສົດຈັດການໄວ້. ເມື່ອສັນຍາລັກງຽບຫຼືການສົ່ງສັນຍານຫາກໍ່ເລີ່ມຕົ້ນ, totals.count is 0, clusters is empty, ແລະ note ຟິວອະທິບາຍເຫດຜົນ. ມັນເປັນບັນທຶກຂອງການລົບລ້າງທີ່ດຳເນີນໄປ — ບໍ່ແມ່ນການຄາດເດົາ. ສຳລັບການປະເມີນ "ຢຸດຢູ່ໃສ" ທີ່ຄາດໄວ້, ໃຊ້ /liquidations ຈຸດສຸດທ້າຍ.

GET /liquidations/onchain

ຕ້ອງການ: Trader Pro

Executed ການລົບລ້າງໃນລະບົບ DeFi ທີ່ດຳເນີນໄປແລ້ວ ຈັບກຸມໂດຍກົງຈາກ BSC + Avalanche full nodes — ເປັນອິດສະຫຼະຈາກ bot ການຊື້ຂາຍໃດໆ. ກວມເອົາ Venus/Cream ແລະ Moolah ໃນ BSC, ແລະ AAVE V3/V2, Benqi, BankerJoe, Granary ແລະ Vinium ໃນ Avalanche. ລະດັບ Pro ຍັງສົ່ງຄືນ at_risk ຕຳແໜ່ງ (ຂຶ້ນກັບ 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, repay_usd_known: 148230.55 } },
 nodes: { bsc: { reachable: True, head_block: 89173010, events_total: 61 } }
  }
}

GET /smart-stop

ຕ້ອງການ: Trader Pro

ຄຳນວນລະດັບ stop-loss ທີ່ສະຫຼາດຂຶ້ນກັບ heatmap ການລິກວິດ, ແຖບຄວາມປ່ຽນແປງ, ແລະໂຄງສ້າງຕະຫຼາດ. ສົ່ງຄຳແນະນຳກ່ຽວກັບ stop ແລະຄຳແນະນຳການກຳໄລທີ່ປັບຕາມລາຄາເຂົ້າແລະຄວາມທົນທານຄວາມສ່ຽງຂອງທ່ານ.

ພາຣາມິເຕີ

ພາຣາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
symbolrequired	string	ສັນຍາລັກຊັບສິນ: `BTC`, `ETH`, ຫຼື `SOL`
directionrequired	string	ທິດທາງຕຳແໜ່ງ: `long` ຫຼື `short`
entry_priceoptional	float	ລາຄາເຂົ້າຂອງທ່ານ. ຄ່າເລີ່ມຕົ້ນແມ່ນລາຄາຕະຫຼາດປະຈຸບັນຖ້າບໍ່ລະບຸ.
risk_pctoptional	float	ຄວາມສ່ຽງສູງສຸດທີ່ຍອມຮັບໄດ້ເປັນ % ຂອງບັນຊີ. ຄ່າເລີ່ມຕົ້ນ: `2.0`

ຕົວຢ່າງການຕອບແທນ

JSON

{
 symbol: BTC,
 direction: long,
 entry_price: 96420,
 stops: {
 tight: { price: 95100, note: ຕໍ່າກວ່າໂຄງສ້າງ 1h. ເໝາະສຳລັບ scalps. },
 recommended: { price: 93800, note: ຕໍ່າກວ່າກຸ່ມ liq ຫຼັກທີ່ $94K. ມາດຕະຖານ swing stop. },
 wide: { price: 91200, note: ຕໍ່າກວ່າເຂດຄວາມຕ້ອງການ 4h. ຕຳແໜ່ງການຊື້ຂາຍ stop. }
  },
 avoid_zones: [
    { low: 94200, high: 94800, reason: ກຸ່ມການລົງໂທດທີ່ໜາແໜ້ນ — ຄວາມສ່ຽງ slippage ສູງ }
  ],
 take_profit_suggestions: [
    { tp1: 98500, tp2: 101000, tp3: 104200 }
  ]
}

ແຜນການຂອງຜູ້ຊື້ຂາຍ: ສົ່ງຄືນແຕ່ recommended stop ເທົ່ານັ້ນ. ແຜນ Pro: ທັງສາມຊັ້ນ stop, avoid_zones, ແລະ ຄຳແນະນຳ take-profit ເຕັມຮູບແບບ.

GET /funding-arb

ຮຽກຮ້ອງ: Trader Pro

ກວດພົບໂອກາດ arbitrage ອັດຕາດອງເງິນຂ້າມຕະຫຼາດໃນເວລາຈິງ. ສົ່ງຄືນໂອກາດທີ່ຈັດອັນດັບພ້ອມດອກເບ້ຍປະມານຕໍ່ປີ, ຄູ່ຕະຫຼາດທີ່ເໝາະສົມ, ແລະ ການປະຕິບັດ hedge ທີ່ຕ້ອງການເພື່ອຈັບ spread.

ພາຣາມິເຕີ

ພາຣາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
min_spreadoptional	float	ອັດຕາດອງເງິນ spread ຕ່ຳສຸດທີ່ຈະລວມ (ເປັນທິດສະດີ). ຄ່າເລີ່ມຕົ້ນ: `0.01`
symboloptional	string	ກັ່ນຕອງເປັນຊັບສະເພາະ. ປ່ອຍໄວ້ເປົ່າເພື່ອສະແກນທຸກຊັບສະເພາະທີ່ຮອງຮັບ.

ຕົວຢ່າງການຕອບຮັບ

JSON

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

ແຜນການຂອງຜູ້ຊື້ຂາຍ: ໂອກາດອັນດັບ 1 ດຽວ, ບໍ່ມີຂໍ້ມູນ spread ປະຫວັດສາດ. ແຜນ Pro: ທຸກໂອກາດປະຈຸບັນພ້ອມປະຫວັດສາດ spread 24h ຕໍ່ຄູ່ຕະຫຼາດ.

ຮຸ່ນສາທາລະນະຟຣີ No auth

ຈຸດສິ້ນສຸດສາທາລະນະທີ່ບໍ່ຕ້ອງໃຊ້ກະແຈສົ່ງຄືນໂອກາດອັນດັບ 10 ອັນດັບດ້ວຍຕົວກວດສອບຂ້າມຕະຫຼາດແບບສົດ, ເໝາະສຳລັບການຝັງຫຼືການກວດສອບໄວ. ມັນຈະບໍ່ລວມປະຫວັດສາດ spread ຕໍ່ຊັບສະເພາະ ແລະ ຂໍ້ມູນທີ່ຫນັກ, ແລະ ຖືກໃຫ້ບໍລິການຈາກ cache 120 ວິນາທີ. ເມື່ອບໍ່ມີ spread ດອງເງິນຂ້າມຕະຫຼາດໃນຊ່ອງເວລາສົດມັນຈະສົ່ງຄືນ opportunities array ທີ່ວ່າງ note — ບໍ່ມີຂໍ້ມູນທີ່ຖືກປອມແປງ.

GET (no auth)

GET /v1/derivatives/funding-arb

JSON

{
 "opportunities": [
    {
 symbol: OGN,
 spread_pct: 0.297667,
 annualized_apr: 325.95,
 long_exchange: bybit,
 short_exchange: hyperliquid,
 estimated_profit_per_10k: 29.77,
 risk_notes: ສະເປດຕ່ຳ — ໃຫ້ແນ່ໃຈວ່າຄ່າທຳນຽມບໍ່ກິນກຳໄລທີ່ໄດ້ຈາກ arbitrage.
    }
  ],
 scanned_symbols: 222,
 ts: 1783268753,
 public: True,
 limited: True
}

ຟຣີ, ບໍ່ຕ້ອງໃຊ້ API key. ໂອກາດທີ່ດີທີ່ສຸດ 10 ອັນດັບເທົ່ານັ້ນ, ຈຳກັດ ແລະ ເກັບໄວ້ (120 ວິນາທີ). ໜ້າຈໍສະແກນຕົວຈິງ: funding-arb.html.

GET /smart-money/flow

ຕ້ອງການ: Trader Pro

ດັດຊະນີທິດທາງ ຂອງວາລີທີ່ຖືກນຳໜັກດ້ວຍຄຸນນະພາບ ຕໍ່ສັນຍາລັກ, ຖືກຄະນິດສອບ -100 (ເງິນຂອງວາລີເລືອກ short) ໄປຫາ +100 (ເລືອກ long). ສ້າງຈາກກະເປົາເງິນວາລີ Hyperliquid ຫຼາຍພັນບັນຊີ — ແຕ່ລະອັນຖືກນຳໜັກດ້ວຍອັດຕາຊະນະປະຫວັດສາດ ແລະ PnL ຂອງມັນເອງ ແລະ ຖືກຫຼຸດລົງຕາມຄວາມທັນສະໄໝ. ນີ້ແມ່ນ ດັດຊະນີການຈັດຕັ້ງຕຳ່ຫວ່າງ, ບໍ່ແມ່ນສັນຍານຊື້/ຂາຍ ຫຼື ການຄາດຄະເນລາຄາ. ສັນຍາລັກທີ່ມີກະເປົາເງິນສົ່ງເຂົ້ານ້ອຍຖືກຕິດປ້າຍ thin ແລະ ຖືກຄະນິດສອບຢ່າງຊື່ສຽງ. ໜ້າຕົວຈິງ: smart-money-flow.html.

ພາຣາມິເຕີ

ພາຣາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
symboloptional	string	ສັນຍາລັກດຽວ (ຕົວຢ່າງ `BTC`). ຍົກເວັ້ນເພື່ອໃຫ້ໄດ້ຮັບສັນຍາລັກທັງໝົດທີ່ຖືກຕິດຕາມ ຈັດອັນດັບຕາມ \|score\|.
window_hoursoptional	int	ຊ່ອງເວລາຄະນິດສອບ, ຖືກຈຳກັດເຖິງ `1..168`. ຄ່າເລີ່ມຕົ້ນ `24`.

ຕົວຢ່າງຕອບກັບ

JSON

{
 symbols: [
    {
 symbol: SPX,
 score: -90.93,
 direction: strong_short,
 n_wallets: 26,
 long_usd: 184200.0, short_usd: 2410000.0,
 quality_weighted: True,
 sample_quality: rich,
 top_contributors: [ { wallet: 0x31ca…974b, direction: short, value_usd: 5338.25, weight: 0.4948 } ]
    }
  ],
 window_hours: 24,
 quality_weighted: True,
 ts: 1783270000,
 note: ດັດຊະນີທິດທາງວາລີທີ່ຖືກນຳໜັກດ້ວຍຄຸນນະພາບ (-100..+100). ບໍ່ແມ່ນການຄາດຄະເນລາຄາ ຫຼື ສັນຍານຊື້/ຂາຍ.
}

ແຜນ Trader: ສັນຍາລັກ 12 ອັນດັບເທິງສຸດ, ບໍ່ເປີດເຜີຍລາຍລະອຽດຜູ້ສົ່ງເຂົ້າ. ແຜນ Pro: ສັນຍາລັກທັງໝົດພ້ອມກັບ top_contributors. ນ້ຳໜັກກະເປົາເງິນຖືກຈຳກັດເຖິງ [0.25,1.0]; PnL ແມ່ນຕົວແທນທີ່ຍັງບໍ່ທັນໄດ້ຮັບຈາກການຖ່າຍທອດຕຳ່ຫວ່າງຫຼ້າສຸດ.

GET /v1/whales/crowding

ມີໃຫ້ສຳລັບ: Free ບໍ່ຕ້ອງການກວດສອບຕົວຕົນ — ຜູ້ໃຊ້ທີ່ບໍ່ລະບຸຊື່ຈະໄດ້ຮັບສັນຍາລັກ 10 ອັນດັບເທິງສຸດ, Trader+ ຈະໄດ້ຮັບລາຍຊື່ເຕັມ.

ການຈັດຕັ້ງຕຳ່ຫວ່າງ ຂອງວາລີ ແລະ ບົດບາດການແອອັດ ຕໍ່ສັນຍາລັກ, ລວມກັນທົ່ວ Hyperliquid + GMX v2 + Jupiter Perps. ສົ່ງຄືນມູນຄ່າທີ່ບໍ່ມີຕົວຕົນ/ສຸດທິ, ຄວາມເຄື່ອງທິດທາງ, ຈຳນວນກະເປົາເງິນ ແລະ ສະຖານທີ່, ຄວາມເຂັ້ມຂົ້ນຂອງຕຳ່ຫວ່າງ (ສ່ວນຮ່ວມຂອງ 3 ອັນດັບເທິງສຸດ + HHI), ອັດຕາສ່ວນການໃຊ້ເງິນກູ້ສະເລ່ຍທີ່ຖືກນຳໜັກ, ແລະ ກຸ່ມຄວາມໃກ້ຊິດກັບການລົງໂທດ (ມູນຄ່າທີ່ບໍ່ມີຕົວຕົນຢູ່ໃນໄລຍະ 5% ແລະ 10% ຂອງລາຄາລົງໂທດທີ່ຄາດຄະເນ, ແບ່ງ long/short). ນີ້ແມ່ນ ບົດບາດບໍລິບົດ, ບໍ່ແມ່ນສັນຍານທິດທາງ. ຟິວທີ່ບໍ່ສາມາດຫາມາໄດ້ຈະ null ແລະ ສະແດງເປັນ — — ຕົວຢ່າງ lev_wavg/crowding_index ເມື່ອບໍ່ມີຕຳ່ຫວ່າງໃດໆທີ່ມີການໃຊ້ເງິນກູ້. ໄລຍະຫ່າງການລົງໂທດແມ່ນການຄາດຄະເນຂອງເງິນຄົງທີ່ທີ່ແຍກຕົວ (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), ບໍ່ແມ່ນ ລາຄາລົງໂທດທີ່ຖືກລາຍງານໂດຍບໍລິສັດ.

ພາຣາມິເຕີ

ພາຣາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
min_notionaloptional	float	ມູນຄ່າທີ່ບໍ່ມີຕົວຕົນລວມຕ່ຳສຸດ (USD) ສຳລັບສັນຍາລັກທີ່ຈະຖືກລວມເຂົ້າ. ຄ່າເລີ່ມຕົ້ນ: `1000000`.

ຕົວຢ່າງຄຳຂໍ

GET (no auth)

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: [ ລະດັບການລົງໂທດແມ່ນການຄາດຄະເນແບບແຍກຕ່ຳ (isolated-margin), ບໍ່ແມ່ນຂໍ້ມູນຈາກຕະຫຼາດ. ]
}

ຫມາຍເຫດສຳຄັນ: skew is net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). ມີແຕ່ຕະຫຼາດທີ່ມີການລົງທຶນຈິງເທົ່ານັ້ນຈະຖືກສະແດງໃນ venues. ຕຳແໜ່ງທີ່ບໍ່ມີ leverage ຈະບໍ່ຖືກນັບໃນກຸ່ມ liq ແທນທີ່ຈະຖືວ່າເປັນຕົວເລກສະເລ່ຍ. ຜູ້ໃຊ້ທີ່ບໍ່ລົງທະບຽນຈະໄດ້ຮັບສັນຍາລັກ 10 ອັນດັບຕົ້ນໂດຍ gross (ພ້ອມກັບ gated: true); ຜູ້ໃຊ້ Trader+ ຈະໄດ້ຮັບລາຍຊື່ເຕັມ.

GET /v1/options/gex

ສາມາດໃຊ້ໄດ້ໂດຍ: Free ບໍ່ຕ້ອງການກວດສອບຕົວຕົນ (ຈຳກັດຄວາມໄວຕໍ່ IP)

Dealer gamma exposure (GEX) ການວິເຄາະສຳລັບ BTC & ETH, ຄຳນວນແບບ real-time ຈາກລະບົບ options ສາທາລະນະຂອງ Deribit (ບໍ່ຕ້ອງການກວດສອບ). ສົ່ງຄ່າ GEX ສຸດທິຂອງ dealer ຕໍ່ແຕ່ລະລາຄາ strike (ແບບ SpotGamma dealer-short), ລະດັບ gamma-flip (ລາຄາ strike ທີ່ຄ່າ GEX ສຸດທິລວມແລ້ວເທົ່າສູນ), ໂຄງສ້າງ IV term structure (ຄ່າ implied vol ATM ແບ່ງຕາມວັນກຳນົດໝົດອາຍຸ), ແລະຄ່າ IV skew (25Δ-proxy risk reversal). ລະບົບ GEX ຈະຢູ່ໃນສະຖານະ positive (dealers long gamma → ກົດຫມັ້ນຄ່າຄວາມມວນສານ) ຫຼື negative (ຂະຫຍາຍຄ່າຄວາມມວນສານ). ເຮັດວຽກເປັນອິດສະຫຼະ — ຄຳນວນໃໝ່ທຸກຄັ້ງທີ່ມີການເອີ້ນໃຊ້, ບໍ່ຂຶ້ນກັບຖານຂໍ້ມູນ.

ພາຣາມິເຕີ

Parameter	ປະເພດ	ຄຳອະທິບາຍ
ສັນຍາລັກທາງເລືອກ	ສະຕຣິງ	`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 },
    { ຈຸດຕັດສິນ: 65000, ຍອດເງິນສະສົມສຸດທິ: 4800000.0 }
  ],
 ໂຄງສ້າງໄລຍະເວລາ: [
    { ວັນໝົດອາຍຸ: 8JUL26, ຈຳນວນວັນຄົງເຫຼືອ: 0.76, ຄ່າ IV ລະດັບ ATM: 62.1 },
    { ວັນໝົດອາຍຸ: 27MAR26, ຈຳນວນວັນຄົງເຫຼືອ: 14.2, ຄ່າ IV ລະດັບ ATM: 58.4 }
  ],
 ຄ່າເຄິ່ງຄ້າງ: {
 ວັນໝົດອາຍຸ: 8JUL26, ຈຳນວນວັນຄົງເຫຼືອ: 0.76,
 ຄ່າ IV ດ້ານ Put: 69.69, ຄ່າ IV ລະດັບ ATM: 62.1, ຄ່າ IV ດ້ານ Call: 55.34,
 ການປ່ຽນທິດທາງຄວາມສ່ຽງ: 14.35, ອະຄະຕິ: ຄວາມຢ້ານກົວດ້ານລົງ
  }
}

ຫມາຍເຫດຊື່ສັດ: ຕົວຄູນສັນຍາ Deribit ແມ່ນ 1 (ຍອດເງິນສະສົມທີ່ຄິດໄລ່ເປັນສະກຸນເງິນດິຈິຕອນ). ໃນກໍລະນີທີ່ດຶງຂໍ້ມູນລົ້ມເຫຼວ, endpoint ຈະສົ່ງຄືນ available: false ກະດານຫວ່າງ — ບໍ່ມີການສ້າງ GEX ຂຶ້ນມາ. ຄ່າເຄິ່ງຄ້າງ IV ໃຊ້ຈຸດຕັດສິນຄົງທີ່ ±10% ເປັນຕົວແທນຂອງ 25Δ (ຄ່າ 25-delta ທີ່ແທ້ຈິງຕ້ອງໄດ້ຄຳນວນ delta ຕໍ່ຈຸດຕັດສິນ); ເໝາະສົມສຳລັບການສະແດງຜົນ, ມີການລາຍງານເປັນຄ່າປະມານ.

GET /v1/liquidations/simulate

ມີໃຫ້ສຳລັບ: ບໍ່ເສຍຄ່າ ບໍ່ຕ້ອງການກວດສອບຕົວຕົນ (ຈຳກັດອັດຕາການເຂົ້າເຖິງຕໍ່ IP)

ແບບປະສານກັນໄດ້ ການທົດສອບຄວາມຕ້ານທານຂອງການລະບາດຂອງການຊຳລະ. ຕາມການເຄື່ອນຍ້າຍລາຄາສົມມຸດຕິຖານ, ຈະສົ່ງຄືນຕຳແໜ່ງທີ່ໃຊ້ leverage ທີ່ຄາດວ່າຈະຖືກຊຳລະ, ປະລິມານທີ່ຖືກບັງຄັບໂດຍລະດັບລາຄາ / ດ້ານ / ຕະຫຼາດ, ແລະການອ່ານຄວາມເລິກຂອງການລະບາດ. ການເຄື່ອນຍ້າຍລົງຈະຊຳລະ ຕຳແໜ່ງ long ທີ່ມີລາຄາຊຳລະຢູ່ໃນ/ເທິງເປົ້າໝາຍ; ການເຄື່ອນຍ້າຍຂຶ້ນຈະຊຳລະ ຕຳແໜ່ງ short ທີ່ມີລາຄາຊຳລະຢູ່ໃນ/ຕໍ່າກວ່າເປົ້າໝາຍ. ມີສອງວິທີທີ່ເປັນອິດສະລະທີ່ຖືກລວມກັນ: ລາຄາຊຳລະທີ່ແນ່ນອນຈາກປາກົດ Hyperliquid whales' ຈິງ leverage/ຈຸດເຂົ້າ, ບວກກັບກຸ່ມ OI-band ທາງສະຖິຕິຕໍ່ຕະຫຼາດ (leverage ຂອງຝູງຊົນທີ່ຄາດເດົາຈາກການສະໜອງເງິນ). ທຸກຢ່າງຖືກລາຍລະອຽດຢ່າງຊັດເຈນ estimated: true — ມັນບໍ່ສາມາດຮູ້ margin ຕໍ່ບັນຊີ, cross vs isolated, margin ທີ່ເພີ່ມ, ຫຼື 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": "Estimated — cannot know per-account margin, cross vs isolated, add-margin, or ADL." }
}

ຫມາຍເຫດທີ່ຊື່ສັດ: ຕົວເລກທີ່ຄາດຄະເນທັງໝົດແມ່ນໄດ້ມາຈາກການອ່ານຖານຂໍ້ມູນຈິງ; ບໍ່ມີສິ່ງໃດຖືກປອມແປງໃນກໍລະນີລົ້ມເຫລວ. ສັນຍາລັກທີ່ບໍ່ຖືກຕິດຕາມ, ພາບຖ່າຍທີ່ລ້າຫຼືລາຄາທີ່ຂາດຫາຍຈະກັບຄືນມາ ok: true, empty: true ພ້ອມຂໍ້ຄວາມທີ່ເຂົ້າໃຈງ່າຍ, ບໍ່ແມ່ນແຖບປອມ. realized_context ແມ່ນຕົວຢ່າງທີ່ຍັງອ່ອນໄວຈາກການລະບາຍແຮງບັງຄັບຕະຫຼອດເວລາ, ສະແດງເປັນບໍລິບົດເທົ່ານັ້ນ — ມັນບໍ່ເຄີຍເຮັດໃຫ້ການຄາດຄະເນ "ເປັນຈິງ".

GET /v1/wallet/{addr}/profile

ມີສຳຫຼວດສຳລັບ: ຟຣີ ບໍ່ຕ້ອງການກວດສອບຕົວຕົນ (ຈຳກັດຕໍ່ IP)

ເປັນຂໍ້ມູນກ່ຽວກັບກະເປົາ ຂໍ້ມູນກ່ຽວກັບກະເປົາ ສ້າງຂຶ້ນທັງໝົດຈາກພາບຖ່າຍຕຳແໜ່ງຂອງວາລັດທີ່ຖືກຕິດຕາມໃນເວລາຈິງ. ສຳຫຼວດສຳລັບວາລັດ Hyperliquid ທີ່ຖືກຕິດຕາມ, ຈະກັບຄືນຕຳແໜ່ງທີ່ເປີດຢູ່ໃນປະຈຸບັນ, ຊຸດເວລາຂອງຜົນກຳໄລທີ່ບໍ່ໄດ້ຮັບການຮັບຮອງ / ການສົ່ງເສີມ / ຈຳນວນຕຳແໜ່ງ ຊຸດເວລາ, ເປັນກິດຈະກຳ OPEN/CLOSE/FLIP ເວລາເກີດກິດຈະກຳ (ສ້າງຂຶ້ນໂດຍການປຽບທຽບພາບຖ່າຍຕໍ່ເນື່ອງ), ປ້າຍຊື່ຈາກຕາຕະລາງນຳ Hyperliquid, ແລະບົດສະຫຼຸບສັງລວມປຶ້ມເປີດ. ໜ້າສະແດງໃນເວລາຈິງ: wallet-profiler.html.

ພາລາມິເຕີ

ພາລາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
addrຕ້ອງການ	string	ທີ່ຢູ່ກະເປົາ (ສ່ວນຂອງເສັ້ນທາງ), ຕົວຢ່າງ `/v1/wallet/0x3bcae23e…/profile`.
daysທາງເລືອກ	integer	ວິນໂດສຳຫຼວດກັບຄືນສຳລັບຊຸດເວລາ & ເວລາເກີດກິດຈະກຳ. ຄ່າເລີ່ມຕົ້ນ: `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, ທິດທາງ: short,
 ຂະໜາດ: 1200.0, ລາຄາເຂົ້າ: 1800.0, ກຳໄລທີ່ຍັງບໍ່ໄດ້ຮັບ: 34800.0,
 ອຳນາດການຄ້າ: 20.0, ມູນຄ່າ(USD): 2160000.0 }
    ],
 ຊຸດ: [ { ວັນທີ: 1783330000, ກຳໄລທີ່ຍັງບໍ່ໄດ້ຮັບ: 42000.0, ການສົ່ງເສີມ(USD): 18400000.0, ຕຳແໜ່ງ: 5 } ],
 ເວລາເກີດຂຶ້ນ: [ { ວັນທີ: 1783400000, ເຫດການ: flip, ສັນຍາລັກ: ETH,
 ທິດທາງ: short, ຈາກທິດທາງ: long, ມູນຄ່າ(USD): 2160000.0 } ],
 ສະຫຼຸບ: {
 ຕຳແໜ່ງທີ່ເປີດຢູ່: 5, ຢູ່ໃນກຳໄລ: 3, ຢູ່ໃນການສູນເສຍ: 2, longs: 0, shorts: 5,
 ກຳໄລທີ່ຍັງບໍ່ໄດ້ຮັບທັງໝົດ: -12000.0, ການສົ່ງເສີມທັງໝົດ(USD): 21000000.0, ອຳນາດການຄ້າປະສົມ: 19.9,
 ວິນໃດ້(ມື້): 30, ຮູບພາບໃນວິນໃດ້: 474,
 ກຳໄລທີ່ໄດ້ຮັບແລ້ວ: None, ໝາຍເຫດກຳໄລທີ່ໄດ້ຮັບແລ້ວ: ບໍ່ສາມາດຄຳນວນໄດ້ — ເຫັນແຕ່ຮູບພາບເປີດ, ບໍ່ເຫັນການປິດທຸລະກຳ.
    }
  }
}

ໝາຍເຫດຊື່ສັດ: ທຸກຢ່າງທີ່ສະແດງແມ່ນ ຈິງ ມາຈາກຂໍ້ມູນຮູບພາບ — pnl ແມ່ນເຄື່ອງໝາຍຕະຫຼາດທີ່ຍັງບໍ່ໄດ້ຮັບຂອງ HL ເອງ, value_usd ແມ່ນມູນຄ່າເປີດທີ່ບໍ່ແມ່ນການປິດ. ກຳໄລ/ການສູນເສຍທີ່ໄດ້ຮັບແລ້ວຕໍ່ການຊື້-ຂາຍຄົບຮອບບໍ່ມີ (ພວກເຮົາເຫັນແຕ່ຮູບພາບເປີດ, ບໍ່ເຫັນການປິດທຸລະກຳ) ແລະ ສະແດງເປັນ null / —; ເຫດການ CLOSE ໃນເວລາເກີດຂຶ້ນບໍ່ມີການອ້າງອີງກຳໄລ/ການສູນເສຍ. ທີ່ຢູ່ທີ່ຖືກຕ້ອງແຕ່ບໍ່ຖືກຕິດຕາມຈະສົ່ງຄືນ tracked: false ພ້ອມໝາຍເຫດ; ທີ່ຢູ່ບໍ່ຖືກຕ້ອງຈະສົ່ງຄືນ ok: false, error: "invalid_address" (HTTP 400). ປ້າຍ HL-leaderboard ແມ່ນການຢືນຢູ່ໃນຫນ້າຕ່າງຂອງ 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

ສົ່ງຄືນການປ່ຽນແປງຕຳແໜ່ງປາກົດຂອງວານ — ການເປີດ, ການປິດ, ແລະ ການປ່ຽນທິດທາງ — ທີ່ຖືກກວດພົບໃນບັນຊີກະເປົາເງິນ ແລະ ທີ່ຢູ່ on-chain ທີ່ຖືກຕິດຕາມໃນຊ່ອງເວລາກັບຄືນໄປຫນ້າທີ່ລະບຸໄວ້.

ພາຣາມິເຕີ

ພາຣາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
symboloptional	string	ກັກກັນຕາມຊັບສິນ. ປ່ອຍໃຫ້ຫວ່າງເພື່ອຊັບສິນທີ່ຖືກຕິດຕາມທັງໝົດ.
significanceoptional	string	ກັກກັນຕາມຄວາມສຳຄັນຂອງເຫດການ: `high`, `medium`, ຫຼື `all`. ຄ່າເລີ່ມຕົ້ນ: `all`
hoursoptional	integer	ຊ່ອງເວລາກັບຄືນໄປຫນ້າເປັນຊົ່ວໂມງ. ຄ່າເລີ່ມຕົ້ນ: `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
    }
  ]
}

ແຜນການຊື້ຂາຍ: ສົ່ງຄືນ summary object ພຽງຢ່າງດຽວ. ແຜນ Pro: ເຕັມ events feed ພ້ອມກັບຕົວຊີ້ບອກກະເປົາ, ຂະໜາດ, ແລະເວລາ.

GET /regimes/history

ຮຽກຮ້ອງ: Pro

ສົ່ງຄືນຂໍ້ມູນການຈັດປະເພດ regime ໃນອະດີດສຳລັບຊັບສິນທີ່ກຳນົດ. ໃຊ້ສຳລັບທົດສອບກັບຄວາມສຳເລັດຂອງ regime ສະເພາະໃນອະດີດ, ໄລຍະເວລາໂດຍສະເລ່ຍຂອງແຕ່ລະ regime, ແລະການປ່ຽນແປງ regime ໃນເວລາຜ່ານມາ.

ພາລາມິເຕີ

ພາລາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
symboloptional	string	ສັນຍາລັກຊັບສິນ. ຄ່າເລີ່ມຕົ້ນ: `BTC`
regimeoptional	string	ກັ່ນຕອງໃຫ້ເຫຼືອແຕ່ regime ສະເພາະ, ຕົວຢ່າງ `late_cycle_divergence`. ຖ້າບໍ່ກຳນົດຈະເປັນທຸກ regime.
daysoptional	integer	ວິນໂດຍຈຳນວນວັນທີ່ຈະກັບໄປດຶງຂໍ້ມູນ. ຄ່າເລີ່ມຕົ້ນ: `30`. ສູງສຸດ: `365`

ຕົວຢ່າງຕອບກັບ

JSON

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

ຕ້ອງໃຊ້ແຜນ Pro. ນຳໃຊ້ຮ່ວມກັບ /analysis ເພື່ອຢືນຢັນສົມມຸດຕິຖານຍຸດທະສາດກັບຂໍ້ມູນປະສິດທິພາບ regime ໃນອະດີດ.

GET /exchange-health

ມີໃຫ້ສຳລັບ: Free Trader Pro

ສົ່ງຄືນສະຖານະສຸຂະພາບຕາມເວລາຈິງຂອງທຸກແລກຊັງທີ່ຖືກຕິດຕາມ ລວມທັງ latency ຕໍ່ແລກຊັງ, ອັດຕາຜິດພາດ, ແລະຕົວຊີ້ບອກຄວາມລ້າຂອງຂໍ້ມູນ. ບໍ່ຕ້ອງການການຢືນຢັນຕົວຕົນ — endpoint ເຂົ້າເຖິງໄດ້ສາທາລະນະ.

ຕົວຢ່າງຕອບກັບ

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

ຮຽກຮ້ອງ: Trader Pro

ສົ່ງຄືນດັດຊະນີ Fear & Greed (0-100) ຕາມເວລາຈິງທີ່ຄິດໄລ່ຈາກຄວາມຮູ້ສຶກ derivatives, ກິດຈະກຳ whale, ຄວາມປ່ຽນແປງລະດັບສູງ, ແລະສັນຍານສັງຄົມ. ລວມທັງສ່ວນປະກອບຍ່ອຍ ແລະປະຫວັດ 24 ຊົ່ວໂມງສຳລັບການວິເຄາະແນວໂນ້ມ.

ພາລາມິເຕີ

ພາລາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
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 ດຽວພ້ອມການແບ່ງສ່ວນອົງປະກອບ.

ການລວມຕົວ

GET /tradingview/setup

ຮຽກຮ້ອງ: Trader Pro

ສົ່ງຄືນການຕັ້ງຄ່າການລວມຕົວ 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

ມີສຳລັບ: Trader Pro

ຮັບການແຈ້ງເຕືອນຈາກ TradingView, ດຳເນີນການຜ່ານ /confirm, ແລະ ສົ່ງຄືນການຢືນຢັນ. TradingView ບໍ່ສາມາດສົ່ງຫົວຂໍ້ກຳນົດເອງໄດ້, ດັ່ງນັ້ນໃຫ້ຢືນຢັນຕົວຕົນໂດຍການລວມ webhook ຂອງທ່ານ secret ໃນສ່ວນ body JSON (endpoint ນີ້ບໍ່ໃຊ້ 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

ຮຽກຮ້ອງ: Trader Pro

ສົ່ງຄືນການຕັ້ງຄ່າການປັບແຕ່ງສ່ວນຕົວປະຈຸບັນຂອງທ່ານ ລວມທັງພາລາມິເຕີການຊື້ຂາຍເລີ່ມຕົ້ນ, ໂປຣໄຟລໄຊຄວາມສ່ຽງ, ລາຍການຕິດຕາມ, ແລະ ການຕັ້ງຄ່າການແຈ້ງເຕືອນ.

PUT /v1/preferences

ອັບເດດການຕັ້ງຄ່າໂດຍການສົ່ງ JSON body ທີ່ມີສ່ວນໃດໆຂອງຊ່ອງຂ້າງລຸ່ມນີ້. ຊ່ອງທີ່ບໍ່ໄດ້ລະບຸຈະຮັກສາຄ່າປະຈຸບັນ.

ຊ່ອງຂໍ້ມູນການຕັ້ງຄ່າ

ຊ່ອງ	ປະເພດ	ຄຳອະທິບາຍ
default_trade_size_usd	float	ຂະໜາດຕຳແໜ່ງເລີ່ມຕົ້ນໃນ USD ສຳລັບການຄຳນວນ Kelly ແລະ ຈຸດຢຸດສະຫຼາດ
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 — ຕົວຢ່າງ Body

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

GET /watchlist

ຮຽກຮ້ອງ: ຜູ້ຊື້ຂາຍ ມືອາຊີບ

ສົ່ງຄືນສະຖານະຢືນຢັນແລະຕົວຊີ້ວັດຄວາມສ່ຽງທີ່ສໍາຄັນສໍາລັບທຸກໆສັນຍາລັກໃນ 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"
    }
  ]
}

ການສົ່ງຕໍ່ເວລາຈິງ (Live Swaps)

ສົ່ງຕໍ່ DEX swaps ≥ $500 ທີ່ຕັດພົບໃນເວລາຈິງຈາກ node BSC ແລະ Avalanche ຂອງພວກເຮົາເອງ. ມີສອງຊ່ອງທາງ: ຊ່ອງທາງ Server-Sent Events (SSE) ສາທາລະນະສໍາລັບລູກຄ້າຟຣີ/ບຣາວເຊີ, ແລະຊ່ອງທາງ WebSocket firehose ຄວາມແຮງຕໍ່າສໍາລັບລະດັບຈ່າຍເງິນ. ການປະກາດເຫດການຈະຖືກອອກອາກາດພາຍໃນບໍ່ເທົ່າໃດວິນາທີຫຼັງຈາກຖືກລວມເຂົ້າໃນ block.

ຊ່ອງທາງ 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=…

ການຢືນຢັນຕົວຕົນ (ແນະນໍາ): ບໍ່ເຄີຍໃສ່ກະແຈ API ທີ່ມີອາຍຸຍາວໃນ URL — ຄໍາຖາມຈະຖືກບັນທຶກໂດຍ proxy, load balancer, ແລະບັນທຶກໃນປະຫວັດບຣາວເຊີ. ແທນທີ່ຈະ, ແລກປ່ຽນກະແຈຂອງທ່ານເພື່ອໃຫ້ໄດ້ຮັບ /v1/ws/ticket ໃຊ້ header ທີ່ປອດໄພ X-API-Key , ຈາກນັ້ນເປີດ socket ດ້ວຍ ticket (ມີອາຍຸ ~60s, ໃຊ້ໄດ້ຄັ້ງດຽວ). ລູກຄ້າຝ່າຍເຊີບເວີທີ່ສາມາດຕັ້ງ header ອາດຈະສົ່ງ 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. ເປີດ socket ດ້ວຍຕົວເລກທີ່ໃຊ້ໄດ້ຄັ້ງດຽວ
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 — ຄໍາຖາມຈະຖືກບັນທຶກໂດຍ proxy, load balancer, ແລະບັນທຶກໃນປະຫວັດບຣາວເຊີ. ແທນທີ່ຈະ, ແລກປ່ຽນກະແຈຂອງທ່ານເພື່ອໃຫ້ໄດ້ຮັບຕົວເລກທີ່ມີອາຍຸສັ້ນ, ໃຊ້ໄດ້ຄັ້ງດຽວ 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 single-use and expires in ~60 seconds. Server-side clients that can set request headers may instead pass X-API-Key directly on the WebSocket handshake — no ticket needed.

POST /v1/ws/ticket

Requires: 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

Requires: Pro

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

GET /v1/alerts/conditions

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

DELETE /v1/alerts/conditions/{id}

Permanently removes an alert condition by its ID.

GET /v1/alerts/history

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

Create Alert — Request Body

Field	Type	Description
namerequired	string	ປ້າຍຊື່ທີ່ອ່ານໄດ້ງ່າຍສຳລັບການແຈ້ງເຕືອນນີ້ (ສູງສຸດ 64 ຕົວອັກສອນ)
metricrequired	string	ຕົວຊີ້ວັດທີ່ຈະຕິດຕາມ. ເບິ່ງຕາຕະລາງຕົວຊີ້ວັດທີ່ມີຢູ່ຂ້າງລຸ່ມ.
symboloptional	string	ບໍລິບົດຂອງຊັບສິນ. ຈຳເປັນສຳລັບຕົວຊີ້ວັດທີ່ກຳນົດໂດຍສັນຍາລັກເຊັ່ນ `funding_rate`.
operatorrequired	string	ຕົວປຽບທຽບ: `gt`, `lt`, `eq`, `crosses_above`, `crosses_below`
thresholdrequired	float	ຄ່າຕົວເລກທີ່ຈະໃຊ້ປຽບທຽບກັບຕົວຊີ້ວັດ
deliveryoptional	string	ຊ່ອງທາງການສົ່ງ, ຕົວຢ່າງ `telegram` (ຄ່າເລີ່ມຕົ້ນ) ຫຼື `webhook`
cooldown_minutesoptional	integer	ຈຳນວນນາທີຕໍ່າສຸດລະຫວ່າງການເຕືອນຄືນ (ຄ່າເລີ່ມຕົ້ນ 60)

ລາຍຊື່ຕົວຊີ້ວັດແລະຕົວປຽບທຽບທີ່ຖືກຕ້ອງຈະຖືກສົ່ງຄືນໂດຍ GET /v1/alerts/conditions as available_metrics and available_operators.

Available Metrics

Metric	Description
funding_rate	ອັດຕາການສະໜັບສະໜູນປະຈຸບັນສຳລັບສັນຍາລັກ (ເປັນທະສິດ)
global_lsr	ອັດຕາສ່ວນຍາວ/ສັ້ນທົ່ວໂລກສຳລັບສັນຍາລັກ
long_pct	ສ່ວນຮ້ອຍຂອງບັນຊີທີ່ຖືຕຳແໜ່ງຍາວສຳລັບສັນຍາລັກ
top_trader_lsr	ອັດຕາສ່ວນຍາວ/ສັ້ນຂອງຜູ້ຊື້ຂາຍຊັ້ນສູງສຳລັບສັນຍາລັກ
taker_ratio	ອັດຕາສ່ວນການຊື້/ຂາຍຂອງຜູ້ຊື້ຂາຍສຳລັບສັນຍາລັກ
mvrv	ອັດຕາສ່ວນມູນຄ່າຕະຫຼາດຕໍ່ມູນຄ່າຈິງ (BTC/ETH)
sopr	ອັດຕາສ່ວນຜົນກຳໄລຂອງຜົນຜະລິດທີ່ໃຊ້ໄປ (BTC/ETH)
exchange_net_flow	ສັນຍານການໄຫຼຂອງສະກຸນເງິນເຂົ້າ-ອອກບໍລິສັດ
accumulation	ສັນຍານການສະສົມສະກຸນເງິນໃນລະບົບລະຫວ່າງ
whale_long_pct	ສ່ວນຮ້ອຍຂອງກະເປົາເງິນຂະຫນາດໃຫຍ່ທີ່ຖືຕຳແໜ່ງຍາວສຳລັບສັນຍາລັກ
whale_n_wallets	ຈຳນວນກະເປົາເງິນຂະຫນາດໃຫຍ່ທີ່ມີຕຳແໜ່ງໃນສັນຍາລັກ
composite_long	ຄະແນນປະສົມສຳລັບສັນຍາລັກທີ່ຖາມໃນທິດທາງຍາວ
composite_short	ຄະແນນປະສົມສຳລັບສັນຍາລັກທີ່ຖາມໃນທິດທາງສັ້ນ
funding_spread	ການກະຈາຍການສະໜັບສະໜູນຂ້າມສະຖານທີ່ສຳລັບສັນຍາລັກ

POST — Example Body

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

GET /kelly

Requires: Pro

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	ສັນຍາລັກຊັບສິນ: `BTC`, `ETH`, or `SOL`
confidenceoptional	string	ລະດັບຄວາມໝັ້ນໃຈຂອງສັນຍານທີ່ຈະໃຊ້ໃນການສ້າງແບບຈຳລອງ: `HIGH`, `MEDIUM`, or `LOW`. Default: `HIGH`
directionoptional	string	ທິດທາງການຊື້ຂາຍ: `long` or `short`. Default: `long`
account_sizeoptional	float	ຂະໜາດບັນຊີເປັນ USD ສຳລັບການຄຳນວນ `suggested_size_usd`. Default: `10000`

Example Response

JSON

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

ຕ້ອງໃຊ້ແຜນ Pro. ການຄຳນວນແມ່ນອີງໃສ່ຕົວຢ່າງປະຫວັດສາດ 90 ວັນທີ່ກົງກັບສັນຍາລັກ, ຄວາມໝັ້ນໃຈ, ແລະພາລາມິເຕີທິດທາງທີ່ຮ້ອງຂໍ.

GET /performance

ມີສຳລັບ: Free Trader Pro

ສົ່ງຄືນສະຖິຕິຄວາມຖືກຕ້ອງທາງປະຫວັດສາດຂອງສັນຍານທີ່ອອກໂດຍ API, ແບ່ງຕາມລະດັບຄວາມໝັ້ນໃຈ. ເປັນປະໂຫຍດໃນການເຂົ້າໃຈຄວາມນ້ຳເຊື່ອຖືຂອງສັນຍານກ່ອນທີ່ຈະລົງທຶນ.

ພາລາມິເຕີ

ພາລາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
symboloptional	string	ກັ່ນຕອງຕາມຊັບສິນ. ຍົກເວັ້ນເພື່ອສະຖິຕິລວມທັງໝົດຂອງທຸກສັນຍາລັກ.
daysoptional	integer	ວິນໂດຍກັບຄືນໄປບ່ອນເປັນວັນ. ຄ່າເລີ່ມຕົ້ນ: `30`

ຕົວຢ່າງການຕອບຮັບ

JSON

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

ສະຖິຕິ & ສັນຍານ

GET /v1/stats

ມີສຳລັບ: Free Trader Pro ບໍ່ຕ້ອງການການຢືນຢັນຕົວຕົນ

ສະຖິຕິຜົນງານທີ່ຊື່ສັດທົ່ທັງເວັບໄຊທ໌ມາຈາກ smart_money_confirm ຜົນໄດ້ຮັບການເອີ້ນທີ່ແຕກຕ່າງ. ສົ່ງຄືນອັດຕາຊະນະທີ່ລະດັບຄວາມໝັ້ນໃຈ HIGH ແລະ MEDIUM, ຄວາມຖືກຕ້ອງລວມ, ປັດໄຈກຳໄລ, ແລະການແບ່ງຕາມສັນຍາລັກ. ຕົວເລກທັງໝົດແມ່ນໃນຕົວຢ່າງໃນຊ່ອງວິນໂດການຄະແນນ; ປຶກສາ calibration.html ເພື່ອບໍລິບົດແລະວິທີການ forward-holdout.

ຕົວຢ່າງການຕອບຮັບ

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

ຂໍ້ຄວນລະວັງໃນຕົວຢ່າງ. ຕົວເລກທັງໝົດໃນການຕອບຮັບນີ້ຖືກຄຳນວນຈາກໄລຍະເວລາດຽວກັນທີ່ໃຊ້ໃນການປັບ scorer. ວັດຖຸ forward_holdout ແມ່ນຕົວເລກດຽວທີ່ຖືກສະສົມຈາກຂໍ້ມູນທີ່ scorer ບໍ່ເຄີຍເຫັນ — ເບິ່ງມັນເຕີບໃຫຍ່ເມື່ອເວລາຜ່ານໄປ. ເບິ່ງ calibration.html ເພື່ອວິທີການເຕັມທີ່ແລະຂອບເຂດ in-sample / forward-test.

GET /v1/signals/performance

ມີສຳລັບ: Free Trader Pro ບໍ່ຕ້ອງການການຢືນຢັນຕົວຕົນ

ການຕິດຕາມຜົນໄດ້ຮັບຂອງສັນຍານທົ່ວຫຼາຍຊ່ອງວິນໂດການແກ້ໄຂ (4h, 12h, 24h, 72h). ສົ່ງຄືນອັດຕາການຕີຕໍ່ຊ່ອງວິນໂດ, ຈຳນວນສັນຍານທັງໝົດ, ແລະການແບ່ງຕາມປະເພດສັນຍານ.

ພາລາມິເຕີ

ພາລາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
daysoptional	integer	ວິນໂດຍກັບຄືນໄປບ່ອນເປັນວັນ. ຄ່າເລີ່ມຕົ້ນ: `30`
signal_typeoptional	string	ກັ່ນຕອງຕາມປະເພດ, ຕົວຢ່າງ `smart_money_confirm` or `regime_flip`. ຍົກເວັ້ນເພື່ອທຸກປະເພດ.
symboloptional	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 ບໍ່ຕ້ອງການກວດສອບຕົວຕົນ

ຜົນໄດ້ຮັບທີ່ແກ້ໄຂແລ້ວສຳຫຼັບສັນຍານດຽວໂດຍໃຊ້ ID ຕົວເລກຂອງມັນ. ສົ່ງຄືນຜົນການຕີ/ຜິດພາດໃນແຕ່ລະຂອບເຂດແກ້ໄຂ (4h, 12h, 24h, 72h) ພ້ອມດ້ວຍລາຄາໃນເວລາສັນຍານແລະໃນເວລາແກ້ໄຂ.

ພາຣາມິເຕີ

ພາຣາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
idຈຳເປັນ	integer	Signal ID (ສ່ວນຂອງ path), ຕົວຢ່າງ `/v1/signals/1042/outcome`

ຕົວຢ່າງການຕອບຮັບ

JSON

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

GET /v1/confirm-winrate

ຕ້ອງການ: Free Trader Pro

ການແບກແຍກອັດຕາຊະນະຂອງສັນຍານຢືນຢັນສຳຫຼັບກະແຈ API ຂອງຜູ້ໃຊ້ເອງ. ສົ່ງຄືນອັດຕາຊະນະໃນແຕ່ລະລະດັບຄວາມໝັ້ນໃຈ, ປັດໄຈຜົນກຳໄລ, ແລະຕົວເລກຕໍ່ສັນຍາລັກ. ຕ້ອງການ X-API-Key header.

ຕົວຢ່າງການຮ້ອງຂໍ

cURL

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

ຕົວຢ່າງການຕອບຮັບ

JSON

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

ຕາມພື້ນຖານການເອີ້ນທີ່ແຕກຕ່າງ. ອັດຕາຊະນະຖືກຄິດໄລ່ຕໍ່ການເອີ້ນຢືນຢັນທີ່ແຕກຕ່າງ (ໜຶ່ງຕໍ່ສັນຍາລັກຕໍ່ຊ່ອງເວລາ 5 ນາທີ), ບໍ່ແມ່ນຕໍ່ການເຂົ້າເຖິງ API ທຸກຄັ້ງ — ສິ່ງນີ້ປ້ອງກັນບໍ່ໃຫ້ມີການເພີ່ມຂຶ້ນຂອງ N ຈາກ bot ທີ່ສົ່ງຄຳຮ້ອງຊ້ຳບໍ່ຢຸດ. ຕົວເລກທັງໝົດແມ່ນຢູ່ໃນຕົວຢ່າງໃນຊ່ອງເວລາເລີ່ມຕົ້ນ 30 ວັນ; ຂໍ້ຄວນລະວັງດຽວກັນກັບ /v1/stats ນຳໃຊ້.

Shadow Gate

ຮຽກຮ້ອງ: ຟຣີ Trader Pro

ບັນທຶກການຕັດສິນໃຈສ່ວນຕົວທີ່ບໍ່ສາມາດປ່ຽນແປງໄດ້, ເພີ່ມເຂົ້າໄດ້ຢ່າງດຽວ. ສົ່ງການຕັດສິນໃຈການຊື້ຂາຍຂອງທ່ານກ່ອນ ຫຼື ຫຼັງຈາກດຳເນີນການ; ລະບົບຈະຄິດໄລ່ຄະແນນຢືນຢັນຕາມເຄື່ອງຈັກ Smart Money ແລະ ເພີ່ມເຂົ້າເປັນແຖວຖາວອນ. ໃຊ້ມັນເພື່ອສ້າງບັນທຶກການຊື້ຂາຍທີ່ມີການບັນທຶກເວລາທີ່ຊື່ສັດຂອງວ່າເຄື່ອງໝາຍຂອງ API ກົງກັບຈຸດເຂົ້າຂອງທ່ານໄດ້ດີປານໃດ — ເປັນອິດສະລະຈາກອັດຕາຊະນະທົ່ວໂລກ. ຄຳຕອບຊັ້ນຟຣີ ແລະ Trader ຈະບໍ່ມີຂໍ້ມູນຫຼັກຖານ; ຊັ້ນ Pro ຈະສົ່ງຄຳຕອບແບບເຕັມ. ຂໍ້ມູນຊັ້ນຟຣີຈະມີການລັອກເວລາ.

POST /v1/shadow-gate/decisions

ສົ່ງການຕັດສິນໃຈ. ບໍ່ສ້າງສຳເນົາຊ້ຳຫາກໃຊ້ Idempotency-Key ຫົວຂໍ້ຄຳຮ້ອງດຽວກັນ — ການສົ່ງລະຫັດດຽວກັນຊ້ຳຈະໄດ້ຮັບແຖວທີ່ມີຢູ່ແລ້ວໂດຍບໍ່ສ້າງສຳເນົາ. ລະບົບຈະເອີ້ນໃຊ້ເຄື່ອງຈັກຢືນຢັນທັນທີ ແລະ ເພີ່ມຜົນໄດ້ຮັບເຂົ້າເປັນແຖວຖາວອນໃນບັນທຶກ.

Request Body

Field	Type	Description
symbolrequired	string	ສັນຍາລັກຊັບສິນ, ຕົວຢ່າງ `BTC`
siderequired	string	ທິດທາງການຊື້ຂາຍ: `long` or `short`
strategy_idoptional	string	ປ້າຍກຳນົດຍຸດທະສາດທີ່ຜູ້ເອີ້ນກຳນົດ (ສູງສຸດ 64 ຕົວອັກສອນ). ຈະເກັບໄວ້ຕາມທີ່ເປັນເພື່ອໃຊ້ໃນການຈັດກຸ່ມ ແລະ ການກັ່ນຕອງ.

Example Request

cURL

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

Example Response

JSON

{
 "id": 318,
 "symbol": "BTC",
 "side": "long",
 "strategy_id": "ema_crossover",
 "decision": "CONFIRM",
 "confidence": "HIGH",
 "composite": 0.74,
 "size_mult": 1.5,
 ts: 1710940821,
 ຮັບແກ້ໄຂ: false
}

ບັນທຶກຊັ້ນ. ການຕອບສະໜອງຟຣີ ແລະ ຜູ້ຊື້ຂາຍຈະບໍ່ລວມຟິວ factors / adjustments ຂໍ້ມູນຫຼັກຖານ. Pro ຈະສົ່ງຄຳຢືນຢັນທີ່ສົມບູນຄືນ. ການລັດເຊີຂອງຊັ້ນຈະນຳໃຊ້ກັບຟຣີ — ແຖວຈະຖືກຂຽນທັນທີ ແຕ່ຄະແນນຢືນຢັນອາດຈະສະທ້ອນຂໍ້ມູນທີ່ຖືກເກັບໄວ້ທີ່ອາດຈະເກົ່າເຖິງ 60 ວິນາທີ.

GET /v1/shadow-gate/decisions

ລາຍການຕັດສິນໃຈ shadow-gate ຂອງທ່ານ, ເລືອກເອົາລາຍການໃໝ່ກ່ອນ. ກຳນົດໂດຍເຈົ້າຂອງ — ມີພຽງແຕ່ການຕັດສິນໃຈທີ່ສົ່ງໂດຍ API key ຂອງທ່ານເທົ່ານັ້ນທີ່ຈະຖືກສົ່ງຄືນ.

ພາລາມິເຕີ

ພາລາມິເຕີ	ປະເພດ	ຄຳອະທິບາຍ
limitທາງເລືອກ	integer	ຈຳນວນແຖວສູງສຸດທີ່ຈະສົ່ງຄືນ. ຄ່າເລີ່ມຕົ້ນ: `50`, ສູງສຸດ: `200`
cursorທາງເລືອກ	string	Cursor ການເລືອກຫນ້າທີ່ບໍ່ຊັດເຈນຈາກການຕອບຮັບກ່ອນໜ້າ `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, size_mult: 0.0, ts: 1710937000, ແກ້ໄຂແລ້ວ: True }
  ],
 ນັບ: 2,
 next_cursor: None
}

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

ການຕັດສິນໃຈດຽວຕາມ ID, ລວມທັງຫຼັກຖານຢືນຢັນທັງໝົດສຳລັບຊັ້ນ Pro. ຄຳຕອບຂອງຊັ້ນ Free ແລະ Trader ຈະມີ 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

ແກ້ໄຂຜົນໄດ້ຮັບຂອງການຕັດສິນໃຈດ້ວຍຕົນເອງ. ເອີ້ນໃຊ້ຫຼັງຈາກປິດການຊື້ຂາຍເພື່ອບັນທຶກຜົນໄດ້ຮັບສຸດທ້າຍຕໍ່ບັນຊີລາຍການ. ເມື່ອແກ້ໄຂແລ້ວ, ບັນຊີລາຍການຈະບໍ່ສາມາດປ່ຽນແປງໄດ້ອີກ.

ຂໍ້ຄວາມຮ້ອງຂໍ

ຟີລ໌	ປະເພດ	ຄຳອະທິບາຍ
outcomerequired	string	ຜົນໄດ້ຮັບຂອງການຊື້ຂາຍ: `win` ຫຼື `loss`
exit_priceoptional	float	ລາຄາອອກສຳລັບການຊື້ຂາຍ. ເກັບຮັກສາໄວ້ເປັນຂໍ້ມູນອ້າງອີງ; ໃຊ້ເພື່ອຄຳນວນ P&L % ຖ້າມີການລະບຸ.
pnl_pctoptional	float	ຜົນກຳໄລຫຼືຂາຍສູນເປັນເປີເຊັນຂອງຂະໜາດຕຳແໜ່ງ, ຕົວຢ່າງ `3.5` ຫຼື `-1.2`

ຕົວຢ່າງການຕອບຮັບ

JSON

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

ຄວາມບໍ່ປ່ຽນແປງ. ແຖວບັນຊີເງິນແມ່ນເພີ່ມເຂົ້າໄດ້ເທົ່ານັ້ນ. ເມື່ອມີການສົ່ງການຕັດສິນໃຈ, ມັນຈະບໍ່ສາມາດລຶບໄດ້, ແລະ ເມື່ອແກ້ໄຂແລ້ວກໍຈະບໍ່ສາມາດແກ້ໄຂຄືນໄດ້. ນີ້ເຮັດໃຫ້ການບັນທຶກຜົນງານທີ່ທ່ານສ້າງຂຶ້ນເປັນສິ່ງທີ່ຊື່ສັດ ແລະ ບໍ່ສາມາດປອມແປງໄດ້.

ລະຫັດຜິດພາດ

ສະຖານະ	ລະຫັດ	ຄຳອະທິບາຍ
400	invalid_params	ຂໍ້ມູນຄຳຖາມບໍ່ຖືກຕ້ອງ ຫຼື ຂາດຫາຍ
401	unauthorized	ຂາດ API key ຫຼື API key ບໍ່ຖືກຕ້ອງ
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()

# ໃນວົງຈອນການຊື້ຂາຍຂອງທ່ານ:
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 (!res.ok) throw new Error(`API error: ${res.status}`);
 return res..json();
}

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

cURL

Shell

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

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

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

ການປະສົມປະສານ Freqtrade

ເພີ່ມການຢືນຢັນ Smart Money ໃສ່ຍຸດທະສາດ Freqtrade ໃດກໍ່ຕາມໂດຍການທົດແທນ confirm_trade_entry ວິທີການ.

Python — ຍຸດທະສາດ Freqtrade

ນຳເຂົ້າ requests
ຈາກ freqtrade.strategy ນຳເຂົ້າ IStrategy

ຊັ້ນ SmartMoneyStrategy(IStrategy):
  SM_API_KEY = "sm_your_key"
  SM_BASE = "https://api.smartmoneyapi.com/v1"

 def confirm_trade_entry(self, pair, order_type,
                         amount, rate, time_in_force,
                         current_time, entry_tag, **kwargs):
    symbol = pair.split("/")[0]
 if symbol not in ["BTC", "ETH", "SOL"]:
 return True # ຂ້າມການກວດສອບສຳລັບທີ່ບໍ່ຮອງຮັບ
 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

CCXT + Smart Money

Python — CCXT

ນຳເຂົ້າ ccxt, requests

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

SM_KEY = "sm_your_key"

def smart_trade(symbol, side, amount):
 # ກວດສອບການຢືນຢັນກ່ອນ
  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"ຂ້າມ {symbol} {side} — ຄວາມໝັ້ນໃຈບໍ່ພຽງພໍ.")
 return None

  adj_amount = amount * conf["size_mult"]
  order = exchange.create_market_order(
    f"{symbol}/USDT", side, adj_amount
  )
 print(f"ສັ່ງຊື້ຂາຍສຳເລັດ: {adj_amount} {symbol} {side}")
 return order

ຕ້ອງການຄວາມຊ່ວຍເຫຼືອ?

ກວດສອບ ໜ້າສະຖານະ API ເພື່ອຂໍ້ມູນສຸຂະພາບໃນເວລາຈິງ, ຫຼືໃຊ້ ແບບຟອມຕິດຕໍ່.