API রেফারেন্স

Smart Money API

একটি প্রফেশনাল-গ্রেড ইন্টেলিজেন্স API যা ডেরিভেটিভস ডেটা, অন-চেইন মেট্রিক্স এবং হোয়েল ওয়ালেট অ্যাক্টিভিটি একত্রিত করে আপনার ট্রেডিং বটের জন্য একটি সিঙ্গেল কনফিডেন্স স্কোর প্রদান করে।

বর্তমান API ভার্সন: v1. বেস URL: https://api.smartmoneyapi.com/v1

ডিজাইন প্রিন্সিপালস

চারটি ধারণা এই API-এর প্রতিটি এন্ডপয়েন্ট এবং প্রতিটি স্কোরকে গঠন করে। এগুলি এটির সৎ সীমানাও নির্দেশ করে — এটি কী করে এবং কী করে না।

স্ট্র্যাটেজি-ফার্স্ট, সিগন্যাল-ফার্স্ট নয়। এটি একটি কিনুন/বিক্রয় সিগন্যাল ফিড নয়। আপনি স্ট্র্যাটেজি এবং এন্ট্রি নিয়ে আসুন; API আপনাকে বলে দেবে পার্শ্ববর্তী মার্কেট স্ট্রাকচার — ডেরিভেটিভস পজিশনিং, ফান্ডিং, ওপেন ইন্টারেস্ট, লিকুইডেশনস, অন-চেইন ফ্লো এবং হোয়েল কনসেনসাস — আপনার ইচ্ছাকৃত ট্রেডের সাথে একমত কিনা।

কনফিডেন্স-স্কোরড, বাইনারি প্রেডিকশন নয়। প্রতিটি উত্তর একটি গ্রেডেড confidence (HIGH / MEDIUM / LOW) এবং একটি composite -1.0 থেকে +1.0 পর্যন্ত স্কোর বহন করে। কোন গ্যারান্টি বা ওরাকল কল নেই — আপনি একটি ক্যালিব্রেটেড রিড পাবেন একমতের উপর, এর পিছনের কারণ সহ, যাতে আপনি কনভিকশনের অনুপাতে সাইজ করতে পারেন।

ডিসিশন সাপোর্ট, এক্সিকিউশন অ্যাডভাইস নয়। API একটি CONFIRM / REDUCE / SKIP রিকমেন্ডেশন এবং একটি সাইজ মাল্টিপ্লায়ার রিটার্ন করে আপনার লজিক একশনে নেওয়ার জন্য। এটি অর্ডার প্লেস করে না, এবং এখানে কিছুই ফাইনান্সিয়াল অ্যাডভাইস নয়। আপনি রিস্ক, সাইজিং এবং এক্সিকিউশনের জন্য দায়িত্ব বহন করেন।

লিভিং মেট্রিক্স, ফিক্সড গ্যারান্টি নয়। উইন রেট, রেজিম স্ট্যাটিস্টিক্স এবং অ্যাকুরেসি ফিগারগুলি একটি রোলিং স্যাম্পল থেকে গণনা করা হয় এবং মার্কেট চলার সাথে সাথে পরিবর্তন হয়। আমরা সেগুলি সৎভাবে প্রকাশ করি, এমনকি যখন সেগুলি মাঝারি হয়। প্রতিটি মেট্রিককে একটি বর্তমান অবজারভেশন হিসাবে বিবেচনা করুন, ভবিষ্যতের জন্য কোন প্রতিশ্রুতি নয়।

এই API কার জন্য

এই API তৈরি করা হয়েছে ক্রিপ্টো বট, অ্যালগো এবং AI-এজেন্ট ডেভেলপারদের জন্য যাদের ইতিমধ্যেই একটি লং/শর্ট সিগন্যাল আছে — একটি TA স্ট্র্যাটেজি, একটি ML মডেল, একটি Freqtrade পাইপলাইন, একটি TradingView অ্যালার্ট বা একটি LLM এজেন্ট থেকে — এবং ক্যাপিটাল কমিট করার আগে একটি দ্রুত, প্রি-ট্রেড CONFIRM / REDUCE / SKIP ডিসিশন চায়।

একটি সাধারণ লুপ: আপনার স্ট্র্যাটেজি ফায়ার করে "BTC লং যাও" → আপনি কল করেন GET /v1/confirm?symbol=BTC&direction=long → আপনি এন্ট্রি কনফার্ম, রিডিউস বা স্কিপ করেন এবং সাইজ স্কেল করেন size_multদ্বারা। একটি কল, সিঙ্গেল লো-লেটেন্সি JSON রেস্পন্স, কোন অতিরিক্ত ইনফ্রাস্ট্রাকচার।

এটি নয় একটি স্ট্যান্ডালোন সিগন্যাল জেনারেটর, একটি চার্টিং প্রোডাক্ট বা একটি এক্সিকিউশন ভেন্যু। যদি আপনার নিজের কোন সিগন্যাল না থাকে গেট করার জন্য, শুরু করুন পারফরম্যান্স পেজ দিয়ে এটি একটি লাইভ বটে ওয়্যার করার আগে দেখুন স্কোর কীভাবে আচরণ করেছে।

অ্যাক্সেস পাওয়া

1 — সাইন আপ করুন। একটি ফ্রি অ্যাকাউন্ট তৈরি করুন signup (ইমেল/পাসওয়ার্ড বা Google)। ফ্রি টিয়ারের জন্য কোন ক্রেডিট কার্ড প্রয়োজন নেই।

2 — আপনার ড্যাশবোর্ড খুলুন। আপনার ড্যাশবোর্ড আপনার API কী, বর্তমান প্ল্যান এবং ডেইলি কোটা বিরুদ্ধে লাইভ ইউজেজ দেখায়।

3 — আপনার API কী কপি করুন। কীগুলি প্রিফিক্স করা হয় sm_। এটি পাস করুন X-API-Key হেডার হিসেবে প্রতিটি রিকোয়েস্টে (দেখুন অথেন্টিকেশন)। যেকোনো সময় আপগ্রেড করুন মূল্য নির্ধারণ পৃষ্ঠা সীমা বৃদ্ধি এবং আরও সিম্বল এবং এন্ডপয়েন্ট আনলক করতে।

স্পেস, এসডিকে এবং কুকবুক

আপনার দ্রুত ইন্টিগ্রেট করার জন্য যা কিছু প্রয়োজন, আপনি নিজে কোড লিখুন বা একটি কোডিং এজেন্টকে দিন।

রিসোর্সএটা কি
কুকবুকসবচেয়ে সাধারণ ইন্টিগ্রেশনের জন্য কপি-পেস্ট রেসিপি — এন্ট্রির আগে নিশ্চিত করুন, একটি Freqtrade সিগন্যাল গেট করুন, মাল্টিপ্লায়ার দ্বারা সাইজ করুন, 402/429 হ্যান্ডেল করুন এবং এটি একটি কোডিং এজেন্টে ওয়্যার করুন।
OpenAPI স্পেসপ্রতিটি এন্ডপয়েন্টের মেশিন-পাঠযোগ্য OpenAPI সংজ্ঞা। Postman/Insomnia-তে ইম্পোর্ট করুন, ক্লায়েন্ট জেনারেট করুন বা একটি LLM-এ ফিড করুন। এ github.com/tashiardit/smartmoneyapi-docs.
পাইথন ক্লায়েন্টঅফিসিয়াল পাইথন ক্লায়েন্ট লাইব্রেরি এ github.com/tashiardit/smartmoneyapi-python.
/llms.txtAPI-এর একটি LLM-বান্ধব প্লেইন-টেক্সট সারাংশ। Claude, Codex, বা Cursor-কে এটি দেখান (দেখুন কোডিং এজেন্টস).

২ মিনিটে কুইকস্টার্ট

ধাপ ১ — বেস URL। প্রতিটি এন্ডপয়েন্ট এখানে অবস্থিত:

বেস URL
https://api.smartmoneyapi.com

ধাপ ২ — আপনার API কী পান। বিনামূল্যে সাইন আপ করুন (ক্রেডিট কার্ডের প্রয়োজন নেই) এবং আপনার কী কপি করুন ড্যাশবোর্ডথেকে। প্রতিটি রিকোয়েস্টে এটি X-API-Key হেডার হিসেবে পাস করুন।

ধাপ ৩ — আপনার প্রথম কল। এটি আপনার টার্মিনালে পেস্ট করুন এবং প্রতিস্থাপন করুন 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": ["Funding rate positive across all venues", "Whales: 67% long consensus"]
}

কখন confidence হয় HIGH বা MEDIUM এবং action হয় CONFIRM, আপনার পজিশনের আকার স্কেল করুন size_mult. এটি সম্পূর্ণ ইন্টিগ্রেশন লুপ। দেখুন রেসপন্স ফিল্ডস সম্পূর্ণ ফিল্ড রেফারেন্সের জন্য।

অথেন্টিকেশন

সকল রিকোয়েস্টে একটি API কী প্রয়োজন যা X-API-Key HTTP হেডার হিসেবে পাস করতে হবে।

HTTP হেডার
X-API-Key: sm_your_api_key_here

আপনার API কী পাওয়া যাবে ড্যাশবোর্ড এ সাইন আপ করার পর। আপনার কী গোপন রাখুন — ক্লায়েন্ট-সাইড কোড বা পাবলিক রিপোজিটরিতে এটি এক্সপোজ করবেন না।

ওয়েবসকেট অথেন্টিকেশন ভিন্ন। কখনও আপনার কী ওয়েবসকেট URL-এ রাখবেন না। রিয়েল-টাইম স্ট্রিমগুলি স্বল্পস্থায়ী, একক-ব্যবহারের টিকেটব্যবহার করে: আপনার কী POST করুন /v1/ws/ticket এই X-API-Key হেডার সহ, তারপর ফেরত দেওয়া টিকেট দিয়ে কানেক্ট করুন। দেখুন ওয়েবসকেট অথেন্টিকেশন (টিকেট).

গুগল সাইন-ইন (ফায়ারবেস অথেন্টিকেশন)

ব্যবহারকারীরা ফায়ারবেস অথেন্টিকেশনের মাধ্যমে তাদের গুগল অ্যাকাউন্ট ব্যবহার করে অথেন্টিকেট করতে পারেন। ক্লায়েন্টে সফল গুগল সাইন-ইনের পর, ফায়ারবেস ID টোকেনকে একটি লিঙ্কড API সেশনের জন্য বিনিময় করুন। সিস্টেমটি স্বয়ংক্রিয়ভাবে আপনার গুগল আইডেন্টিটি API কী সিস্টেমের সাথে সিঙ্ক করে।

উপলব্ধ: ফ্রি ট্রেডার প্রো
POST /auth/google

রিকোয়েস্ট বডি

ফিল্ডটাইপবিবরণ
id_tokenপ্রয়োজনীয়স্ট্রিংক্লায়েন্টে Google সাইন-ইন করার পর প্রাপ্ত Firebase ID টোকেন

উদাহরণ প্রতিক্রিয়া

JSON
{
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": ট্রেডার,
সিঙ্ক করা: true
}
ব্যবহারকারী প্রোফাইল ডেটা — ইমেল, প্ল্যান, ব্যবহারের ইতিহাস, পছন্দসমূহ — Firestore-এ সংরক্ষিত এবং আপনার Google অ্যাকাউন্টের সাথে লিঙ্ক করা। সম্পূর্ণ ডেটা এক্সপোর্ট বা অ্যাকাউন্ট মুছে ফেলার অনুরোধ যেকোনো সময় ড্যাশবোর্ডের Privacy Settings থেকে করা যেতে পারে।

রেট লিমিট

প্ল্যানকল/দিনবার্ষিক সীমাডেটা বিলম্ব
ফ্রি502/মিনিট60 সেকেন্ড
ট্রেডার1,00020/মিনিটরিয়েল-টাইম
প্রো5,000৬০/মিনিটরিয়েল-টাইম
এন্টারপ্রাইজ100,000৪০০/মিনিটরিয়েল-টাইম

প্রতিটি প্রতিক্রিয়ায় রেট লিমিট হেডার অন্তর্ভুক্ত থাকে: 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 ফায়ারহোস কল করা)। আপগ্রেড করুন বা একটি পাবলিক এন্ডপয়েন্টে ফিরে যান।
429রেট_লিমিট_অতিক্রান্তদৈনিক বা বার্স্ট লিমিট পৌঁছেছে। ব্যাক অফ করুন এবং পরে আবার চেষ্টা করুন X-RateLimit-Reset; হ্যামার করবেন না।

প্রতিটি ত্রুটি একই ফর্ম্যাটে রিটার্ন করে:

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

সম্পূর্ণ স্ট্যাটাস কোডের তালিকার জন্য (400 / 403 / 500 / 503 এবং আরও), দেখুন ত্রুটি কোডসমূহ। একটি শক্তিশালী ইন্টিগ্রেশন 5xx এবং 429 কে ট্রানজিয়েন্ট (ব্যাকঅফ সহ রিট্রাই) এবং 401/402/403 কে টার্মিনাল (কী বা প্ল্যান ঠিক করুন) হিসাবে বিবেচনা করে।

সুরক্ষা সেরা অনুশীলন

কী URL এর পরিবর্তে হেডারে পাঠান। সর্বদা পাস করুন X-API-Key একটি HTTP হেডার হিসাবে। কোয়েরি স্ট্রিংয়ে কীগুলি (?key=) প্রক্সি, লোড ব্যালেন্সার এবং ব্রাউজার হিস্ট্রি দ্বারা লগ করা হয় — লিগ্যাসি ?key= অথ WebSocket এন্ডপয়েন্টে এই কারণে আর গ্রহণ করা হয় না।

কীগুলি সার্ভার-সাইডে রাখুন। কখনই ক্লায়েন্ট-সাইড JavaScript, মোবাইল অ্যাপ বান্ডিল বা পাবলিক রিপোজিটরিতে API কী এম্বেড করবেন না। এটিকে একটি এনভায়রনমেন্ট ভেরিয়েবল বা সিক্রেট ম্যানেজার থেকে লোড করুন। যদি একটি কী লিক হয়, এটি রোটেট করুন।

পর্যায়ক্রমে কীগুলি রোটেট করুন। আপনার কী পুনরায় জেনারেট করুন ড্যাশবোর্ড একটি সময়সূচীতে এবং অবিলম্বে যদি আপনি এক্সপোজার সন্দেহ করেন। পুরানো কীটি নতুন কী ইস্যু হওয়ার মুহূর্তে কাজ করা বন্ধ করে দেয়।

ব্রাউজার সকেটের জন্য টিকিট ব্যবহার করুন। ব্রাউজার থেকে রিয়েল-টাইম স্ট্রিমের জন্য, আপনার কীকে একটি একক-ব্যবহারের টিকিটের জন্য বিনিময় করুন — দেখুন WebSocket অথেন্টিকেশন (টিকিট).

কোডিং এজেন্ট / LLM এর সাথে ব্যবহার

Claude Code, Codex, Cursor, বা কোনো LLM কোডিং এজেন্ট নিয়ে কাজ করছেন? আপনি এজেন্টকে একবারে এই API সঠিকভাবে সংযোগ করার জন্য প্রয়োজনীয় সব কিছু দিতে পারেন। দুটি মেশিন-পাঠযোগ্য রেফারেন্স প্রকাশিত হয়েছে:

রিসোর্সURL
LLM সারাংশhttps://smartmoneyapi.com/llms.txt
OpenAPI স্পেকgithub.com/tashiardit/smartmoneyapi-docs

আপনার এজেন্টকে নির্দেশ করুন /llms.txt ফাইল (the llms.txt convention) একটি সংক্ষিপ্ত ওভারভিউের জন্য, তারপর OpenAPI স্পেকটি সঠিক রিকোয়েস্ট/রেস্পন্স ফর্ম্যাটের জন্য। একটি এক-লাইন প্রম্পট যা ভাল কাজ করে:

প্রম্পট
# Claude Code / Cursor / Codex এ পেস্ট করুন
Read https://smartmoneyapi.com/llms.txt and the OpenAPI spec at
github.com/tashiardit/smartmoneyapi-docs, then add a pre-trade
check to my bot that calls GET /v1/confirm and skips entries
unless action is CONFIRM.

দেখুন কুকবুক একটি কাজ করা কোডিং-এজেন্ট রেসিপির জন্য।

এন্ডপয়েন্টসমূহ

GET  /confirm

কোর এন্ডপয়েন্ট। একটি প্রদত্ত ট্রেড দিকের জন্য একটি যৌথ আত্মবিশ্বাস স্কোর এবং অ্যাকশন সুপারিশ রিটার্ন করে। কোনো পজিশনে প্রবেশ করার আগে এটি কল করুন।

কভারেজ, সহজ ভাষায়। /confirm বর্তমানে স্কোর করে BTC, ETH এবং SOL — এমন সিম্বল যেগুলির যথেষ্ট রেজলভড হিস্ট্রি রয়েছে সৎভাবে কনফার্ম করার জন্য। ডেরিভেটিভস স্ক্রিনার আলাদাভাবে মনিটর করে ~519 ডেরিভেটিভস মার্কেট ফান্ডিং, OI এবং লিকুইডেশন ডেটার জন্য, এবং হোয়েল ট্র্যাকিং 600+ ওয়ালেট কভার করে। প্রো সম্পূর্ণ স্ক্রিনার, এক্সপোর্ট এবং বিস্তৃত মার্কেট কভারেজ আনলক করে; /confirm প্রতিটি মার্কেট একটি নির্ভরযোগ্য ট্র্যাক রেকর্ড জমা করার সাথে সাথে সিম্বল সাপোর্ট প্রসারিত হয়।

প্যারামিটারসমূহ

প্যারামিটারটাইপবিবরণ
সিম্বলপ্রয়োজনীয়স্ট্রিংঅ্যাসেট সিম্বল। একটি: BTC, ETH, SOL (ট্রেডার+)
দিকপ্রয়োজনীয়স্ট্রিংট্রেড দিক: long বা short
সোর্সঐচ্ছিকস্ট্রিংআপনার সিগন্যাল সোর্সের জন্য লেবেল (অ্যানালিটিক্সের জন্য লগ করা হয়)। সর্বোচ্চ ৩২ অক্ষর।

উদাহরণ রিকোয়েস্ট

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

ডিজাইন দ্বারা স্বচ্ছ। প্রতিটি প্রতিক্রিয়ায় একটি factors অবজেক্ট দেখায় প্রতিটি লেগের স্কোর × ওজন = ওয়েটেড অবদান, একটি adjustments অবজেক্ট পোস্ট-ফিল্টার টুইকের জন্য, weights ব্যবহৃত, এবং একটি coverage ম্যাপ। অন-চেইন লেগ ব্যবহার করে রিয়েল ফ্রি Coin Metrics ডেটা (MVRV / exchange-flow / active-address) যখন Glassnode কী সেট করা থাকে না। এটি একটি মাল্টি-ফ্যাক্টর কনফ্লুয়েন্স স্কোর — সিদ্ধান্ত সমর্থন, গ্যারান্টিযুক্ত জয়-রেট নয়.

ট্র্যাক না করা সিম্বলগুলি সৎ। একটি সিম্বল ট্র্যাক করা ডেরিভেটিভস/হোয়েল ইউনিভার্সের বাইরে হলে একটি স্পষ্ট "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" রিটার্ন করে "unsupported":true — কখনই বানানো LOW.

প্রতিক্রিয়া ক্ষেত্রসমূহ

ক্ষেত্রধরনবর্ণনা
tsintegerগণনার ইউনিক্স টাইমস্ট্যাম্প
symbolstringঅ্যাসেট সিম্বল (BTC/ETH/SOL)
directionstringঅনুরোধ করা দিক (লং/শর্ট)
compositefloatকম্পোজিট কনফ্লুয়েন্স স্কোর -1.0 (এক্সট্রিম কন্ট্রা) থেকে +1.0 (স্ট্রং কনফার্ম)। জয়-রেট নয়।
base_compositefloatপোস্ট-ফিল্টার সমন্বয় প্রয়োগের আগে কম্পোজিট
confidencestringHIGH / MEDIUM / LOW / VETO / NO_DATA
actionstringCONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP
size_multfloatপ্রস্তাবিত পজিশন সাইজ মাল্টিপ্লায়ার (যেমন 0.0 – 1.5)
unsupportedbooltrue যখন সিম্বল কভারেজের বাইরে (NO_DATA এর সাথে যুক্ত)
deriv_scorefloatডেরিভেটিভস সাব-স্কোর (-1 থেকে 1)
onchain_scorefloatঅন-চেইন সাব-স্কোর (-1 থেকে 1)
whale_scorefloatহোয়েল কনসেনসাস সাব-স্কোর (-1 থেকে 1)
x_scorefloatX/সোশ্যাল-সেন্টিমেন্ট সাব-স্কোর (-1 থেকে 1); 0 যখন ব্যবহার করা হয় না
factorsobjectপ্রতি-লেগ ব্রেকডাউন: score × weight = weighted ডেরিভেটিভস / অনচেইন / হোয়েল / x_sentiment এর জন্য (অনচেইন অন্তর্ভুক্ত source)
adjustmentsobjectসাইনড পোস্ট-ফিল্টার টুইকস (agreement, trend, rsi_1h, news_macro, momentum, time_of_day, streak_decay)
weightsobjectএই মূল্যায়নের জন্য প্রকৃতপক্ষে ব্যবহৃত ওজন সেট
coverageobject{derivatives, whale, onchain} — কোন লেগগুলিতে রিয়েল ডেটা ছিল
reasonsarrayস্কোরের জন্য মানব-পাঠযোগ্য ব্যাখ্যা স্ট্রিংসমূহ

GET  /snapshot

একটি সম্পূর্ণ মার্কেট স্ন্যাপশট রিটার্ন করে যাতে একটি প্রদত্ত সিম্বলের জন্য সমস্ত সাব-স্কোর, র মেট্রিক্স, এবং ইন্ডিকেটর ভ্যালু অন্তর্ভুক্ত থাকে। ড্যাশবোর্ড এবং লগিংয়ের জন্য উপযোগী।

প্রয়োজন: ট্রেডার প্রো

GET  /onchain

কাঁচা অন-চেইন মেট্রিক্স রিটার্ন করে: MVRV, SOPR, এক্সচেঞ্জ নেট ফ্লো, রিয়েলাইজড ক্যাপ রেশিও, এবং সাইকেল পজিশন ক্লাসিফিকেশন।

প্রয়োজন: ট্রেডার প্রো

GET  /v1/derivatives/*

৫০০+ সিম্বল জুড়ে ক্রস-এক্সচেঞ্জ ডেরিভেটিভস স্ক্রিনার: ফান্ডিং-রেট হিটম্যাপ, ওপেন-ইন্টারেস্ট র্যাঙ্কিংস, এবং লং/শর্ট-রেশিও সিগন্যাল ডিটেকশন। শীর্ষ ১০ সারি পাবলিক; সম্পূর্ণ স্ক্রিনারের জন্য ট্রেডার বা প্রো প্রয়োজন। এন্ডপয়েন্টস: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET  /v1/options/*

ডেরিবিট-সোর্সড BTC & ETH অপশন অ্যানালিটিক্স (পাবলিক, কোন অথ): পুট/কল রেশিও, ম্যাক্স পেইন, এবং স্ট্রাইক দ্বারা ওপেন ইন্টারেস্ট। এন্ডপয়েন্টস: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET  /v1/etf/*

স্পট BTC & ETH ETF দৈনিক নেট ফ্লো এবং প্রতি-ফান্ড ব্রেকডাউন (পাবলিক)। এন্ডপয়েন্টস: /v1/etf/flows, /v1/etf/funds.

GET  /v1/historical/*

হিস্ট্রিক্যাল ফান্ডিং, ওপেন ইন্টারেস্ট, লং/শর্ট রেশিও (বাইন্যান্স), এবং OHLCV (কয়েনগেকো) ব্যাকটেস্টিংয়ের জন্য। এন্ডপয়েন্টস: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET  /v1/dex/*

ডেক্সস্ক্রিনার-পাওয়ার্ড ট্রেন্ডিং পেয়ারস, টোকেন সার্চ, এবং পেয়ার ডিটেইলস (পাবলিক, কোন অথ)। এন্ডপয়েন্টস: /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

হোয়েল ওয়ালেট কনসেনসাস ডেটা রিটার্ন করে: লং/শর্ট স্প্লিট, টোটাল নোশনাল এক্সপোজার, শীর্ষ ১০ পজিশন (প্রো শুধুমাত্র), এবং ওয়ালেট কাউন্ট।

প্রয়োজন: ট্রেডার প্রো

GET  /signals

সমস্ত মনিটর করা অ্যাসেট জুড়ে সর্বশেষ HIGH/MEDIUM সিগন্যালের একটি স্ট্রিম রিটার্ন করে। সুযোগ স্ক্যানিংয়ের জন্য উপযোগী।

প্রয়োজন: প্রো

GET  /v1/strategies/*

স্বচ্ছ, রিড-অনলি ট্র্যাক রেকর্ড স্মার্ট মানি সিগন্যালের উপর এক্সিকিউট করা অটোমেটেড ট্রেডিং স্ট্র্যাটেজির জন্য — যার মধ্যে রয়েছে 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 — স্ট্র্যাটেজিগুলিকে ফিড করা সিগন্যাল-টাইপ ব্রেকডাউন (কাউন্ট / উইনস / উইন_রেট / এভারেজ_পিএনএল প্রতি সিগন্যাল টাইপ)।

পূর্বের পারফরম্যান্স ভবিষ্যতের ফলাফলের নির্দেশক নয়। চিত্রগুলি একটি একক ~৩ মাসের রেজিম প্লাস লাইভ ট্রেডের উপর ব্যাকফিল্ড করা হয়েছে এবং যেখানে উল্লেখ করা হয়েছে সেখানে প্রি-ফি হিসাবে দেখানো হয়েছে।

GET  /export

হিস্ট্রিক্যাল সিগন্যাল ডেটা CSV হিসাবে ডাউনলোড করুন ব্যাকটেস্টিংয়ের জন্য। প্যারামিটারস: symbol, from (ইউনিক্স টিএস), to (ইউনিক্স টিএস)।

প্রয়োজন: প্রো

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

প্রয়োজন: প্রো

একটি HTTPS URL রেজিস্টার করুন আপনার মনিটর করা অ্যাসেট জুড়ে একটি সিগন্যাল ফায়ার হলে রিয়েল-টাইম সাইনড ইভেন্ট পুশগুলি পেতে। ডেলিভারিগুলি একটি X-SmartMoney-Event হেডার এবং একটি HMAC-SHA256 সিগনেচার বহন করে X-SmartMoney-Signature, এবং ব্যাকঅফ সহ ৩× পর্যন্ত রিট্রাই করে।

রিকোয়েস্ট বডি

ফিল্ডটাইপবর্ণনা
urlপ্রয়োজনস্ট্রিংইভেন্টগুলি POST করার জন্য HTTPS এন্ডপয়েন্ট (শুরু হতে হবে https://)
eventsপ্রয়োজনঅ্যারেইভেন্ট নাম, যেমন ["HIGH","MEDIUM","VETO"] বা ["*"]
symbolsপ্রয়োজনঅ্যারেফিল্টার করার জন্য সিম্বল, যেমন ["BTC","ETH"] বা ["*"]
secretপ্রয়োজনস্ট্রিংআপনার সাইনিং সিক্রেট, ≥ ১৬ অক্ষর (স্টোর করা হ্যাশড)

সিগনেচার যাচাই করা

HMAC কী হল আপনার রেজিস্টার করা সিক্রেটের SHA-256 হেক্স ডাইজেস্ট। সেই কী দিয়ে র ক রিকোয়েস্ট বডির HMAC-SHA256 কম্পিউট করুন এবং (কনস্ট্যান্ট-টাইম) এর বিপরীতে তুলনা করুন X-SmartMoney-Signatureদেখুন Webhook বাস্তবায়ন গাইড.

ইন্টেলিজেন্স

GET  /analysis

প্রয়োজন: প্রো

AI-চালিত মার্কেট রেজিম শ্রেণীবিভাগ সিগন্যাল কনফ্লিক্ট ডিটেকশন সহ রিটার্ন করে। ক্রস-সিগন্যাল অ্যাগ্রিমেন্ট বিশ্লেষণ করে, ডেরিভেটিভস, অন-চেইন এবং হোয়েল ডেটার মধ্যে ডাইভারজেন্স চিহ্নিত করে এবং ফরওয়ার্ড-লুকিং রিস্ক ফ্যাক্টর এবং টাইম-হরাইজনড রিকমেন্ডেশন সহ একটি প্রাকৃতিক-ভাষার সারাংশ তৈরি করে।

প্যারামিটারস

প্যারামিটারটাইপবর্ণনা
symbolrequiredstringঅ্যাসেট সিম্বল: BTC, ETH, বা SOL

উদাহরণ প্রতিক্রিয়া

JSON
{
"ts": 1710940821,
"symbol": "BTC",
"regime": "late_cycle_divergence",
"regime_label": "Late Cycle — Signal Divergence",
"summary": "BTC একটি লেট বুল সাইকেল ফেজে রয়েছে যেখানে অন-চেইন স্ট্রেংথ ডেরিভেটিভস ওভারএক্সটেনশনের সাথে কনফ্লিক্ট করছে। হোয়েলগুলি এক্সপোজার কমাচ্ছে যখন রিটেইল LSR বৃদ্ধি পাচ্ছে।",
"signal_conflicts": [
"হোয়েল স্কোর বিয়ারিশ যখন অনচেইন স্কোর বুলিশ",
"ফান্ডিং রেট 3-মাসের সর্বোচ্চ — সম্ভাব্য স্কুইজ রিস্ক"
],
"risk_factors": ["উচ্চতর ফান্ডিং", "OI ডাইভারজেন্স", "হোয়েল রিডাকশন"],
"recommendation": "লং এক্সপোজার কমিয়ে দিন, স্টপ টাইট করুন। বর্তমান মূল্যের উপরে নতুন লং এড়িয়ে চলুন।",
"time_horizon": "4h–12h"
}
প্রো প্ল্যান প্রয়োজন। এই এন্ডপয়েন্টটি AI প্রসেসিং ওভারহেডের কারণে প্রতি অনুরোধে 3 API কল খরচ করে।

GET  /liquidations

প্রয়োজন: ট্রেডার প্রো

রিটার্নস দুটি পরিপূরক ভিউ: (1) লিভারেজ-প্রজেক্টেড levels — একটি অনুমান যেখানে লিকুইডেশন ক্লাস্টার বসে; এবং (2) একটি realized_heatmap — REAL এক্সিকিউটেড ফোর্সড-লিকুইডেশন ইনটেনসিটি (মূল্য × সময়), পাবলিক এক্সচেঞ্জ WebSocket ফিড থেকে লাইভ এগ্রিগেটেড: Binance, OKX, Bybit, Bitget, BitMEX। হিটম্যাপটি উপস্থিত থাকে যখন স্ট্রিমে সিম্বলের জন্য ডেটা থাকে (খুব শান্ত মার্কেটে বা স্টার্টআপের ঠিক পর অনুপস্থিত)।

প্যারামিটারস

প্যারামিটারটাইপবিবরণ
সিম্বলঐচ্ছিকস্ট্রিংঅ্যাসেট সিম্বল (ডিফল্ট BTC)। রিয়েল হিটম্যাপ সক্রিয়ভাবে ট্রেডেড পার্প সিম্বলগুলিকে কভার করে।

উদাহরণ প্রতিক্রিয়া

JSON
{
"symbol": "BTC",
"cascade_risk": "HIGH",
"nearest_long_liq_pct": -3.2,
"nearest_short_liq_pct": 4.1,
// রিয়েল এক্সিকিউটেড লিকুইডেশন — ৫টি এক্সচেঞ্জ থেকে সরাসরি
"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, নিকটতম দূরত্ব, এবং রিয়েলাইজড টোটাল/বাই-সাইড। প্রো প্ল্যান: সম্পূর্ণ প্রজেক্টেড levels প্লাস সম্পূর্ণ realized_heatmap (ম্যাট্রিক্স, প্রতি-প্রাইস ক্লাস্টার, প্রতি-এক্সচেঞ্জ কাউন্ট)। প্রজেক্টেড এস্টিমেট উত্তর দেয় "স্টপগুলি কোথায়"; রিয়েলাইজড হিটম্যাপ দেখায় "কি আসলে লিকুইডেটেড হয়েছে।"

GET  /liquidations/heatmap

উপলব্ধ: ফ্রি কোন অথেন্টিকেশন প্রয়োজন নেই (প্রতি-আইপি থ্রোটলড)

পাবলিক প্রাইস-লেভেল লিকুইডেশন হিটম্যাপ। একটি Coinglass-স্টাইল প্রাইস × টাইম ম্যাট্রিক্স রিটার্ন করে রিয়েল এক্সিকিউটেড ফোর্সড লিকুইডেশন, প্রতিটি লিকুইডেশন প্রিন্ট হওয়া প্রাইস অনুযায়ী বাকেটেড — পাবলিক এক্সচেঞ্জ ওয়েবসকেট ফিড থেকে সরাসরি অ্যাগ্রিগেটেড: Binance, OKX, Bybit, Bitget, BitMEX। clusters অ্যারে হল প্র্যাকটিক্যাল আউটপুট: লিকুইডেটেড নোশনাল অনুযায়ী র্যাঙ্ক করা প্রাইস বাকেট, প্রতিটি তার ডমিন্যান্ট সাইড সহ ট্যাগ করা। ডেটা লাইভ স্ট্রিমের উপর নির্ভর করে — একটি খুব শান্ত সিম্বল বা সদ্য রিস্টার্ট করা গেটওয়ে ওয়েল-ফর্মড খালি স্ট্রাকচার প্লাস একটি সৎ note। দেখানো লেভেলগুলি শুধুমাত্র রিয়েল লিকুইডেশন, কখনও এস্টিমেটেড নয়।

প্যারামিটারসমূহ

প্যারামিটারধরনবর্ণনা
symboloptionalstringঅ্যাসেট প্রতীক (ডিফল্ট BTC).
window_minutesoptionalintপিছনে ফিরে দেখার সময় মিনিটে (ডিফল্ট 240, ৫–১৪৪০ এর মধ্যে সীমাবদ্ধ)।
price_bucketsoptionalintমূল্য বাকেটের সংখ্যা (ডিফল্ট 50, ৫–১০০ এর মধ্যে সীমাবদ্ধ)।

উদাহরণ প্রতিক্রিয়া

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 খালি থাকে, এবং একটি note ফিল্ড ব্যাখ্যা করে কেন। এটি executed liquidations এর একটি রেকর্ড — কোনও পূর্বাভাস নয়। "স্টপ কোথায় আছে" এর অনুমান পেতে, প্রমাণীকৃত /liquidations এন্ডপয়েন্ট ব্যবহার করুন।

GET  /liquidations/onchain

প্রয়োজন: ট্রেডার প্রো

Executed অন-চেইন DeFi লেন্ডিং liquidations সরাসরি আমাদের নিজস্ব স্থানীয় থেকে ক্যাপচার করা BSC + Avalanche ফুল নোড — কোনও ট্রেডিং বট থেকে স্বাধীন। BSC তে Venus/Cream এবং Moolah, এবং Avalanche তে AAVE V3/V2, Benqi, BankerJoe, Granary এবং Vinium কভার করে। প্রো টিয়ার অতিরিক্তভাবে রিটার্ন করে at_risk অবস্থান (বট-নির্ভর, অনুপস্থিত থাকতে পারে)।

প্যারামিটারসমূহ

প্যারামিটারধরনবর্ণনা
chainoptionalstringbsc বা avax। সকল চেইনের জন্য বাদ দিন।
limitoptionalintegerসর্বোচ্চ সারি (ডিফল্ট ১০০, সর্বোচ্চ ৫০০)। নতুন থেকে পুরাতন।

উদাহরণ প্রতিক্রিয়া

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, পরিশোধ_করুন_USD_জানা: 148230.55 } },
নোডসমূহ: { bsc: { পৌঁছানো_যায়: true, হেড_ব্লক: 89173010, ইভেন্ট_সর্বমোট: 61 } }
}
}

GET  /smart-stop

প্রয়োজন: ট্রেডার প্রো

বর্তমান লিকুইডেশন হিটম্যাপ, ভোলাটিলিটি ব্যান্ড এবং মার্কেট স্ট্রাকচার ভিত্তিক ইন্টেলিজেন্ট স্টপ-লস লেভেল গণনা করে। আপনার এন্ট্রি প্রাইস এবং রিস্ক টলারেন্স অনুযায়ী টায়ার্ড স্টপ সুপারিশ এবং টেক-প্রফিট সাজেশন প্রদান করে।

প্যারামিটারসমূহ

প্যারামিটারটাইপবিবরণ
symbolrequiredstringঅ্যাসেট সিম্বল: BTC, ETH, বা SOL
directionrequiredstringপজিশন দিক: long বা short
entry_priceoptionalfloatআপনার এন্ট্রি প্রাইস। উহ্য থাকলে বর্তমান মার্কেট প্রাইস ডিফল্ট হিসেবে বিবেচিত হবে।
risk_pctoptionalfloatঅ্যাকাউন্টের % হিসাবে সর্বোচ্চ গ্রহণযোগ্য রিস্ক। ডিফল্ট: 2.0

উদাহরণ প্রতিক্রিয়া

JSON
{
"symbol": "BTC",
"direction": "long",
"entry_price": 96420,
"stops": {
"tight": { "price": 95100, "note": "1h স্ট্রাকচারের নিচে। স্কাল্পিংয়ের জন্য সর্বোত্তম।" },
"recommended": { "price": 93800, "note": "94K$-এ মেজর লিকুইডেশন ক্লাস্টারের নিচে। স্ট্যান্ডার্ড সুইং স্টপ।" },
"wide": { "price": 91200, "note": "4h ডিমান্ড জোনের নিচে। পজিশন ট্রেড স্টপ।" }
},
"avoid_zones": [
{ "low": 94200, "high": 94800, "reason": "ঘন লিকুইডেশন ক্লাস্টার — উচ্চ স্লিপেজ রিস্ক" }
],
"take_profit_suggestions": [
{ "tp1": 98500, "tp2": 101000, "tp3": 104200 }
]
}
ট্রেডার প্ল্যান: শুধুমাত্র recommended স্টপ রিটার্ন করে। প্রো প্ল্যান: সব তিনটি স্টপ টায়ার, avoid_zones, এবং সম্পূর্ণ টেক-প্রফিট সাজেশন।

GET  /funding-arb

প্রয়োজন: ট্রেডার প্রো

রিয়েল টাইমে ক্রস-এক্সচেঞ্জ ফান্ডিং রেট আরবিট্রেজ সুযোগ চিহ্নিত করে। আনুমানিক বার্ষিক ফলন, অপ্টিমাল এক্সচেঞ্জ পেয়ার এবং স্প্রেড ক্যাপচার করার জন্য প্রয়োজনীয় হেজ অ্যাকশন সহ র্যাঙ্কড সুযোগ প্রদান করে।

প্যারামিটারসমূহ

প্যারামিটারটাইপবিবরণ
min_spreadoptionalfloatঅন্তর্ভুক্ত করার জন্য সর্বনিম্ন ফান্ডিং রেট স্প্রেড (দশমিক হিসাবে)। ডিফল্ট: 0.01
symboloptionalstringএকটি নির্দিষ্ট অ্যাসেটে ফিল্টার করুন। সমর্থিত সকল অ্যাসেট স্ক্যান করতে বাদ দিন।

উদাহরণ প্রতিক্রিয়া

JSON
{
"ts": 1710940821,
"opportunities": [
{
"symbol": "BTC",
"spread": 0.032,
"apr": 84.2,
"long_exchange": "hyperliquid",
"short_exchange": "bybit",
"action": "লং HYPE / শর্ট BYBIT",
"estimated_profit_8h_usd": 26.4
}
]
}
ট্রেডার প্ল্যান: শুধুমাত্র শীর্ষ 1 সুযোগ, কোন হিস্টোরিক্যাল স্প্রেড ডাটা নেই। প্রো প্ল্যান: এক্সচেঞ্জ পেয়ার প্রতি 24h স্প্রেড হিস্টোরি সহ সমস্ত বর্তমান সুযোগ।

ফ্রি পাবলিক ভ্যারিয়েন্ট No auth

একটি নো-কি পাবলিক এন্ডপয়েন্ট শীর্ষ 10 সুযোগ সহ একটি লাইভ ক্রস-এক্সচেঞ্জ স্ক্রিনার রিটার্ন করে, এমবেডিং বা দ্রুত চেকের জন্য আদর্শ। এটি প্রতি-সিম্বল স্প্রেড হিস্টোরি এবং হেভি ফিল্ড বাদ দেয় এবং 120-সেকেন্ড ক্যাশ থেকে সার্ভ করা হয়। যখন ফ্রেশনেস উইন্ডোতে কোন ক্রস-এক্সচেঞ্জ ফান্ডিং স্প্রেড থাকে না, এটি একটি খালি opportunities অ্যারে সহ একটি note — কখনই ফেব্রিকেটেড ডাটা নয়।

GET (no auth)
GET /v1/derivatives/funding-arb
JSON
{
"opportunities": [
{
symbol: OGN,
spread_pct: 0.297667,
annualized_apr: 325.95,
long_exchange: bybit,
short_exchange: hyperliquid,
estimated_profit_per_10k: 29.77,
risk_notes: লো স্প্রেড — নিশ্চিত করুন যে ফি আর্বিট্রেজ মার্জিন গ্রাস না করে।
}
],
scanned_symbols: 222,
ts: 1783268753,
public: true,
limited: true
}
ফ্রি, কোনো API কী প্রয়োজন নেই। শুধুমাত্র শীর্ষ ১০ সুযোগ, ক্যাপড এবং ক্যাশড (১২০ সেকেন্ড)। লাইভ স্ক্রিনার পেজ: funding-arb.html.

GET  /smart-money/flow

প্রয়োজন: ট্রেডার প্রো

একটি কোয়ালিটি-ওয়েটেড হোয়েল ডাইরেকশনাল ইনডেক্স প্রতি সিম্বলের জন্য, স্কোরড -100 (হোয়েল মানি শর্টের দিকে ঝোঁক) থেকে +100 (লং এর দিকে ঝোঁক)। হাজার হাজার ট্র্যাক করা হাইপারলিকুইড হোয়েল ওয়ালেট থেকে তৈরি — প্রতিটি তার নিজস্ব ঐতিহাসিক জয়ের হার এবং PnL দ্বারা ওয়েটেড এবং সাম্প্রতিকতা দ্বারা ক্ষয়প্রাপ্ত। এটি একটি পজিশনিং ইনডেক্স, কোনো কিনা/বিক্রয় সংকেত বা মূল্য ভবিষ্যদ্বাণী নয়। যেসব সিম্বলে কম সংখ্যক ওয়ালেট অবদান রাখে সেগুলো লেবেল করা হয় thin এবং সৎভাবে স্কোর করা হয়। লাইভ পেজ: smart-money-flow.html.

প্যারামিটারস

প্যারামিটারটাইপবিবরণ
symboloptionalstringএকক সিম্বল (যেমন BTC)। সব ট্র্যাক করা সিম্বল পেতে |score| দ্বারা র্যাঙ্কড হলে বাদ দিন।
window_hoursoptionalintস্কোরিং উইন্ডো, ক্ল্যাম্পড টু 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: কোয়ালিটি-ওয়েটেড হোয়েল ডাইরেকশনাল পজিশনিং ইনডেক্স (-১০০..+১০০)। কোনো মূল্য ভবিষ্যদ্বাণী বা কিনা/বিক্রয় সংকেত নয়।
}
ট্রেডার প্ল্যান: শীর্ষ ১২ সিম্বল, অবদানকারীর বিবরণ গোপন রাখা হয়েছে। প্রো প্ল্যান: সব সিম্বল সহ প্রতি-সিম্বল top_contributors। ওয়ালেট ওয়েটস বাউন্ডেড টু [0.25,1.0]; PnL হল সর্বশেষ পজিশন স্ন্যাপশট থেকে একটি আনরিয়েলাইজড প্রক্সি।

GET  /v1/whales/crowding

উপলব্ধ: ফ্রি কোনো অথেন্টিকেশন প্রয়োজন নেই — অ্যানোনিমাস শীর্ষ ১০ সিম্বল পায়, ট্রেডার+ সম্পূর্ণ তালিকা পায়

কম্বাইন্ড হোয়েল পজিশনিং ও ক্রাউডিং কনটেক্সট প্রতি সিম্বলের জন্য, মার্জড অ্যাক্রস হাইপারলিকুইড + GMX v2 + জুপিটার পার্পস। রিটার্নস গ্রস/নেট নোশনাল, ডাইরেকশনাল স্কিউ, ওয়ালেট ও ভেনিউ কাউন্ট, পজিশন কনসেন্ট্রেশন (টপ-৩ শেয়ার + HHI), একটি ওয়েটেড-এভারেজ লিভারেজ, এবং লিকুইডেশন-প্রক্সিমিটি বাকেটস (USD নোশনাল তার আনুমানিক লিকুইডেশন প্রাইসের ৫% এবং ১০% এর মধ্যে বসে আছে, লং/শর্ট বিভক্ত)। এটি কনটেক্সট, কোনো ডাইরেকশনাল সিগন্যাল নয়। ফিল্ডস যা ডেরিভেবল নয় সেগুলো null এবং রেন্ডার হিসাবে — — যেমন lev_wavg/crowding_index যখন কোনো পজিশন লিভারেজ বহন করে না। লিকুইডেশন দূরত্বগুলি একটি আইসোলেটেড-মার্জিন অনুমান (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), না এক্সচেঞ্জ-রিপোর্টেড লিকুইডেশন প্রাইস।

প্যারামিটারস

প্যারামিটারটাইপবিবরণ
min_notionaloptionalfloatসিম্বল অন্তর্ভুক্ত করার জন্য সর্বনিম্ন কম্বাইন্ড গ্রস নোশনাল (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: [ লিকুইডেশন দূরত্বগুলি আইসোলেটেড-মার্জিন অনুমান, এক্সচেঞ্জ-প্রতিবেদিত নয়। ]
}
সৎ নোট: skew হয় net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1)। শুধুমাত্র প্রকৃত উপস্থিত ভেন্যুগুলি প্রদর্শিত হয় venues। লিভারেজ ছাড়া পজিশনগুলি অনুমান না করে লিক বাকেট থেকে বাদ দেওয়া হয়। বেনামী কলাররা গ্রস দ্বারা শীর্ষ 10 সিম্বল পায় (সাথে gated: true); ট্রেডার+ সম্পূর্ণ তালিকা পায়।

GET  /v1/options/gex

উপলব্ধ: ফ্রি কোন প্রমাণীকরণ প্রয়োজন নেই (প্রতি-আইপি থ্রটলড)

ডিলার গামা এক্সপোজার (GEX) এনালিটিক্স জন্য BTC & ETH, পাবলিক Deribit অপশন চেইন থেকে লাইভ গণনা করা হয় (কোন প্রমাণীকরণ নেই)। প্রতি স্ট্রাইকে নেট ডিলার GEX রিটার্ন করে (SpotGamma ডিলার-শর্ট কনভেনশন), গামা-ফ্লিপ লেভেল (স্ট্রাইক যেখানে ক্রমবর্ধমান নেট GEX শূন্য অতিক্রম করে), IV টার্ম স্ট্রাকচার (এটিএম ইমপ্লায়েড ভলাটিলিটি দিন-থেকে-এক্সপায়ারি দ্বারা), এবং একটি ফ্রন্ট-এক্সপায়ারি IV স্কিউ (25Δ-প্রক্সি রিস্ক রিভার্সাল)। GEX রেজিম positive (ডিলাররা লং গামা → ভলাটিলিটি-দমনকারী) বা negative (ভলাটিলিটি-প্রবর্ধক)। সম্পূর্ণ স্বয়ংসম্পূর্ণ — প্রতিটি কলে পুনরায় গণনা করা হয়, কোন স্টোরড-ডিবি নির্ভরতা নেই।

প্যারামিটারস

প্যারামিটারটাইপবর্ণনা
symboloptionalstringBTC অথবা ETH শুধুমাত্র। ডিফল্ট: BTC.

উদাহরণ অনুরোধ

GET (কোন প্রমাণীকরণ নেই)
curl "https://api.smartmoneyapi.com/v1/options/gex?symbol=BTC"

উদাহরণ প্রতিক্রিয়া

JSON
{
"symbol": "BTC", "available": true, "spot": 63203.0,
"net_gex": 18240000.0, "regime": "positive",
"gamma_flip": 64919.82, "gamma_flip_pct": 2.72,
"call_gex": 31200000.0, "put_gex": -12960000.0,
"by_strike": [
{ "strike": 60000, "net_gex": -2100000.0 },
{ "strike": 65000, "net_gex": 4800000.0 }
],
"term_structure": [
{ "expiry": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
{ "expiry": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
],
"skew": {
"expiry": "8JUL26", "dte": 0.76,
"put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
"risk_reversal": 14.35, "bias": "downside_fear"
}
}
সৎ নোট: Deribit চুক্তি গুণক হল 1 (কয়েন-ডিনোমিনেটেড OI)। যেকোনো ফেচ ব্যর্থতায় এন্ডপয়েন্ট ফেরত দেয় available: false খালি প্যানেল সহ — কখনই তৈরি GEX নয়। IV স্কিউ 25Δ এর জন্য একটি নির্দিষ্ট ±10% স্ট্রাইক প্রক্সি ব্যবহার করে (সত্য 25-ডেল্টা প্রতিটি স্ট্রাইকের জন্য ডেল্টা সমাধান করা প্রয়োজন); প্রদর্শনের জন্য পর্যাপ্ত, একটি আনুমানিক হিসাবে ডকুমেন্ট করা।

GET  /v1/liquidations/simulate

উপলব্ধ: ফ্রি কোন প্রমাণীকরণ প্রয়োজন নেই (প্রতি-আইপি থ্রটলড)

ইন্টারেক্টিভ লিকুইডেশন ক্যাসকেড স্ট্রেস-টেস্ট. একটি প্রকল্পিত মূল্য পরিবর্তন দেওয়া হলে, এটি অনুমানকৃত লিভারেজড পজিশনগুলি ফেরত দেয় যা লিকুইডেটেড হবে, মূল্য স্তর / সাইড / এক্সচেঞ্জ দ্বারা বাধ্যতামূলক ভলিউম এবং একটি ক্যাসকেড-গভীরতা রিডআউট। একটি নিম্নমুখী চলন লিকুইডেট করে লং যাদের লিক-মূল্য লক্ষ্যের সমান/উপরে বসে; একটি ঊর্ধ্বমুখী চলন লিকুইডেট করে শর্ট যাদের লিক-মূল্য লক্ষ্যের সমান/নিচে বসে। দুটি স্বাধীন পদ্ধতি একত্রিত করা হয়েছে: ট্র্যাক করা হাইপারলিকুইড তিমিদের থেকে সঠিক লিকুইডেশন মূল্য রিয়েল লিভারেজ/এন্ট্রি, প্লাস প্রতিটি এক্সচেঞ্জের জন্য পরিসংখ্যানগত OI-ব্যান্ড ক্লাস্টার (ক্রাউড লিভারেজ ফান্ডিং থেকে অনুমান করা)। সবকিছু স্পষ্টভাবে লেবেল করা আছে estimated: true — এটি পার-অ্যাকাউন্ট মার্জিন, ক্রস বনাম আইসোলেটেড, যোগ করা মার্জিন, বা ADL জানতে পারে না।

প্যারামিটারসমূহ

প্যারামিটারটাইপবিবরণ
symboloptionalstringঅ্যাসেট সিম্বল। ডিফল্ট: BTC.
move_pctoptionalfloatপ্রকল্পিত মূল্য পরিবর্তন শতাংশ হিসাবে (নেতিবাচক = নিচে, ধনাত্মক = উপরে)। ডিফল্ট: -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": সত্য, কভারেজ_ঘন্টা: 17.8, পার্শ্ব_২৪ঘণ্টা: { লং: 6100000.0, শর্ট: 2400000.0 } },
পদ্ধতি: { দাবিত্যাগ: অনুমান করা হয়েছে — অ্যাকাউন্ট অনুযায়ী মার্জিন, ক্রস বনাম আইসোলেটেড, অ্যাড-মার্জিন, বা ADL জানা সম্ভব নয়। }
}
সত্যিকারের নোট: প্রতিটি পূর্বাভাসিত সংখ্যা বাস্তব ডাটাবেস রিড থেকে প্রাপ্ত; ব্যর্থ হলে কিছুই তৈরি করা হয় না। একটি ট্র্যাক করা হয়নি এমন সিম্বল, স্টেল স্ন্যাপশট, বা অনুপস্থিত প্রাইস রিটার্ন করে ok: true, empty: true একটি সহজ ইংরেজি বার্তা সহ, নকল বার নয়। realized_context এটি একটি তরুণ, ক্রমবর্ধমান নমুনা যা লাইব বাধ্যতামূলক লিকুইডেশন স্ট্রিম থেকে সংগ্রহ করা হয়েছে, শুধুমাত্র প্রসঙ্গ হিসাবে উপস্থাপিত — এটি কখনই প্রজেকশনকে "বাস্তবায়িত" করে না।

GET  /v1/wallet/{addr}/profile

যাদের জন্য উপলব্ধ: ফ্রি কোনও অথেন্টিকেশন প্রয়োজন নেই (প্রতি-আইপি থ্রোটলড)

একটি ক্রস-ভেন্যু ওয়ালেট প্রোফাইল সরাসরি ট্র্যাক করা তিমি পজিশনের স্ন্যাপশট থেকে সম্পূর্ণভাবে তৈরি। একটি ট্র্যাক করা হাইপারলিকুইড তিমির জন্য, বর্তমান খোলা পজিশন, আনরিয়ালাইজড-পিএনএল/এক্সপোজার/পজিশন-কাউন্ট রিটার্ন করে টাইম সিরিজ, একটি ওপেন/ক্লোজ/ফ্লিপ অ্যাক্টিভিটি টাইমলাইন (পরপর স্ন্যাপশট ডিফিং করে পুনর্গঠিত), ডিকোডেড এইচএল-লিডারবোর্ড লেবেল, এবং একটি ওপেন-বুক সামারি। লাইভ পেজ: wallet-profiler.html.

প্যারামিটারসমূহ

প্যারামিটারটাইপবর্ণনা
addrপ্রয়োজনীয়স্ট্রিংওয়ালেট ঠিকানা (পাথ সেগমেন্ট), যেমন /v1/wallet/0x3bcae23e…/profile.
দিনঐচ্ছিকপূর্ণসংখ্যাসিরিজ এবং টাইমলাইনের জন্য লুক-ব্যাক উইন্ডো। ডিফল্ট: 30.

উদাহরণ অনুরোধ

GET (কোন প্রমাণীকরণ নেই)
curl https://api.smartmoneyapi.com/v1/wallet/0x3bcae23e8c380dab4732e9a159c0456f12d866f3/profile?days=30

উদাহরণ প্রতিক্রিয়া

JSON
{
ok: true, wallet: 0x3bcae23e…, tracked: true,
first_seen_ts: 1782827733, latest_snapshot_ts: 1783418468, as_of: 1783418468,
hyperliquid: {
label: { name: Andre is back, score: 74,
window_pnl_usd: 1307000, win_rate_pct: 71, trades: 42 },
positions: [
{ venue: hyperliquid, symbol: ETH, direction: short,
size: 1200.0, entry_px: 1800.0, unrealized_pnl: 34800.0,
leverage: 20.0, value_usd: 2160000.0 }
],
series: [ { ts: 1783330000, unrealized_pnl: 42000.0, exposure_usd: 18400000.0, positions: 5 } ],
timeline: [ { ts: 1783400000, event: flip, symbol: ETH,
direction: short, from_direction: long, value_usd: 2160000.0 } ],
summary: {
open_positions: 5, in_profit: 3, in_loss: 2, longs: 0, shorts: 5,
total_unrealized_pnl: -12000.0, total_exposure_usd: 21000000.0, blended_leverage: 19.9,
window_days: 30, snapshots_in_window: 474,
realized_pnl: None, realized_pnl_note: Not derivable — only open snapshots are seen, never closing fills.
}
}
}
সৎ নোট: যা দেখানো হচ্ছে তা বাস্তব স্ন্যাপশট ডেটা থেকে — pnl HL-এর নিজস্ব আনরিয়ালাইজড মার্ক-টু-মার্কেট, value_usd খোলা নোটিশনাল। রাউন্ড-ট্রিপে রিয়ালাইজড P&L পাওয়া যায় না (আমরা শুধু খোলা স্ন্যাপশট দেখি, ক্লোজিং ফিলস কখনো দেখি না) এবং এটি দেখানো হয় null / —; টাইমলাইন CLOSE ইভেন্টে কোনো P&L দাবি নেই। একটি বৈধ কিন্তু ট্র্যাক না করা অ্যাড্রেস ফেরত দেয় tracked: false একটি নোট সহ; একটি অবৈধ অ্যাড্রেস ফেরত দেয় ok: false, error: "invalid_address" (HTTP 400)। HL-লিডারবোর্ড লেবেলটি HL-এর নিজস্ব উইন্ডো স্ট্যান্ডিং ডিসকভারিতে, আমাদের দ্বারা গণনা করা নয়।

GET  /flows

প্রয়োজন: প্রো

ক্রস-অ্যাসেট ক্যাপিটাল ফ্লো ডেটা রিটার্ন করে যা BTC, ETH, এবং SOL-এর মধ্যে একাধিক টাইম উইন্ডোতে রোটেশন প্যাটার্ন দেখায়। যে অ্যাসেটটি ক্যাপিটাল জমা করছে এবং যে অ্যাসেটটি বিতরণ করা হচ্ছে তা যেকোনো মুহূর্তে চিহ্নিত করতে সহায়ক।

উদাহরণ প্রতিক্রিয়া

JSON
{
ts: 1710940821,
flows: {
BTC: { 1h: 142000000, 4h: 380000000, 12h: -90000000, 24h: 220000000 },
ETH: { 1h: -38000000, 4h: -110000000, 12h: 55000000, 24h: -80000000 },
SOL: { 1h: 12000000, 4h: 29000000, 12h: 18000000, 24h: 44000000 }
},
rotations_detected: [
4h উইন্ডোতে ETH থেকে BTC-তে ক্যাপিটাল রোটেশন শনাক্ত হয়েছে,
সমস্ত উইন্ডোতে SOL জমা অব্যাহত
]
}
প্রো প্ল্যান প্রয়োজন। ফ্লো মানগুলি USD নেট ইনফ্লো (পজিটিভ) বা আউটফ্লো (নেগেটিভ) প্রতি টাইম উইন্ডো।

GET  /whale-events

প্রয়োজন: ট্রেডার প্রো

ট্র্যাক করা ওয়ালেট এবং অন-চেইন অ্যাড্রেসের মধ্যে উল্লেখযোগ্য হোয়েল পজিশন পরিবর্তন — খোলা, বন্ধ, এবং দিক পরিবর্তন — নির্দিষ্ট লুক-ব্যাক উইন্ডোতে শনাক্ত করে রিটার্ন করে।

প্যারামিটার

প্যারামিটারটাইপবিবরণ
symbolঐচ্ছিকstringঅ্যাসেট দ্বারা ফিল্টার করুন। সমস্ত মনিটর করা অ্যাসেটের জন্য বাদ দিন।
significanceঐচ্ছিকstringইভেন্টের তাৎপর্য দ্বারা ফিল্টার করুন: high, medium, বা all। ডিফল্ট: all
hoursঐচ্ছিকintegerঘন্টায় লুক-ব্যাক উইন্ডো। ডিফল্ট: 24

উদাহরণ প্রতিক্রিয়া

JSON
{
symbol: BTC,
summary: {
flips_to_long: 3,
flips_to_short: 1,
new_opens: 7,
closes: 2
},
events: [
{
ধরন: ফ্লিপ_লং,
ওয়ালেট: 0xWhale...a4f2,
দিক: লং,
আকার_ইউএসডি: 4200000,
টিএস: 1710938400
}
]
}
ট্রেডার প্ল্যান: রিটার্নস দ্য summary অবজেক্ট শুধুমাত্র। প্রো প্ল্যান: ফুল events ফিড ওয়ালেট আইডেন্টিফায়ার, সাইজ, এবং টাইমস্ট্যাম্প সহ।

GET  /regimes/history

প্রয়োজন: প্রো

একটি প্রদত্ত অ্যাসেটের জন্য ঐতিহাসিক রেজিম শ্রেণীবিভাগ ডেটা রিটার্ন করে। এটি ব্যবহার করে আপনি ঐতিহাসিকভাবে নির্দিষ্ট রেজিম টাইপগুলি কীভাবে পারফর্ম করেছে, প্রতিটি রেজিম টাইপ সাধারণত কতক্ষণ স্থায়ী হয় এবং সময়ের সাথে সাথে রেজিম ট্রানজিশনগুলি কীভাবে ঘটে তা ব্যাকটেস্ট করতে পারেন।

প্যারামিটারস

প্যারামিটারটাইপবিবরণ
সিম্বলঐচ্ছিকস্ট্রিংঅ্যাসেট সিম্বল। ডিফল্ট: BTC
রেজিমঐচ্ছিকস্ট্রিংএকটি নির্দিষ্ট রেজিম টাইপে ফিল্টার করুন, যেমন late_cycle_divergence। সমস্ত রেজিমের জন্য বাদ দিন।
দিনঐচ্ছিকইন্টিজারদিনে লুক-ব্যাক উইন্ডো। ডিফল্ট: 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 }
]
}
প্রো প্ল্যান প্রয়োজন। এর সাথে একত্রিত করুন /analysis ঐতিহাসিক রেজিম পারফরম্যান্স ডেটার বিরুদ্ধে কৌশল অনুমান যাচাই করতে।

GET  /exchange-health

উপলব্ধ: ফ্রি ট্রেডার প্রো

সমস্ত মনিটর করা এক্সচেঞ্জের জন্য রিয়েল-টাইম স্বাস্থ্য অবস্থা রিটার্ন করে যার মধ্যে প্রতি-এক্সচেঞ্জ লেটেন্সি, ত্রুটি হার এবং ডেটা স্টেলনেস ইন্ডিকেটর অন্তর্ভুক্ত। কোন অথেন্টিকেশন প্রয়োজন নেই — পাবলিকলি অ্যাক্সেসযোগ্য এন্ডপয়েন্ট।

উদাহরণ প্রতিক্রিয়া

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

প্রয়োজন: ট্রেডার প্রো

ডেরিভেটিভস সেন্টিমেন্ট, তিমি কার্যকলাপ, ভোলাটিলিটি এবং সোশ্যাল সিগন্যাল থেকে গণনা করা একটি রিয়েল-টাইম ফিয়ার অ্যান্ড গ্রিড ইনডেক্স (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, ভ্যালিডেশনের জন্য সিক্রেট, এবং Smart Money API-এর সাথে সরাসরি সংযোগকারী প্রস্তুত Pine Script ইন্ডিকেটর। 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 কাস্টম হেডার পাঠাতে পারে না, তাই আপনার ওয়েবহুক secret JSON বডিতে অন্তর্ভুক্ত করে অথেন্টিকেট করুন (এই এন্ডপয়েন্ট X-API-Key ব্যবহার করে না)। প্রতিক্রিয়া কনফার্মেশন র্যাপ করে এবং একটি টপ-লেভেল action অফ CONFIRMED (ডেমন কনফিডেন্স HIGH/MEDIUM) বা VETOED.

Request Body

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

প্রয়োজনীয়: secret, symbol, direction (long|short). ঐচ্ছিক: source, timeframe, strategy, price.

ব্যক্তিগতকরণ

GET  /preferences

প্রয়োজন: ট্রেডার প্রো

আপনার বর্তমান ব্যক্তিগতকরণ সেটিংস ফেরত দেয়, যার মধ্যে ডিফল্ট ট্রেড প্যারামিটার, রিস্ক প্রোফাইল, ওয়াচলিস্ট এবং নোটিফিকেশন পছন্দসমূহ অন্তর্ভুক্ত।

PUT /v1/preferences

নিচের ফিল্ডগুলোর যেকোনো উপসেট সহ একটি JSON বডি পাঠিয়ে পছন্দসমূহ আপডেট করুন। অবহেলিত ফিল্ডগুলি তাদের বর্তমান মান ধরে রাখে।

পছন্দের ফিল্ডসমূহ

ফিল্ডটাইপবিবরণ
default_trade_size_usdfloatকেলি এবং স্মার্ট-স্টপ গণনার জন্য USD-তে ডিফল্ট পজিশন সাইজ
risk_tolerancestringconservative, moderate, বা aggressive
default_risk_pctfloatঅ্যাকাউন্টের % হিসাবে ডিফল্ট ঝুঁকি প্রতি ট্রেড। দ্বারা ব্যবহৃত হয় /smart-stop যখন risk_pct অবহেলিত
watchlistarrayঅ্যাসেট সিম্বলগুলির অর্ডার করা তালিকা, যেমন ["BTC","ETH","SOL"]
notification_emailstringঅ্যালার্ট ডেলিভারির জন্য ইমেইল ঠিকানা
timezonestringIANA টাইমজোন স্ট্রিং, যেমন 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"
}
]
}

রিয়েল-টাইম স্ট্রিমিং (লাইভ সোয়াপস)

আমাদের নিজস্ব BSC এবং Avalanche নোড থেকে রিয়েল-টাইমে শনাক্ত করা ≥ $500 এর DEX সোয়াপস স্ট্রিম করুন। দুটি ট্রান্সপোর্ট উপলব্ধ: একটি পাবলিক সার্ভার-সেন্ট ইভেন্টস (SSE) স্ট্রিম ফ্রি/ব্রাউজার ক্লায়েন্টদের জন্য, এবং একটি লো-লেটেন্সি ওয়েবসকেট ফায়ারহোস পেইড টিয়ারগুলির জন্য। ইভেন্টগুলি একটি ব্লকে অন্তর্ভুক্ত হওয়ার কয়েক সেকেন্ডের মধ্যে সম্প্রচারিত হয়।

পাবলিক SSE স্ট্রিম (ফ্রি)

উপলব্ধ: ফ্রি ট্রেডার প্রো
GET /v1/stream/public-swaps

কোনও অথেন্টিকেশন প্রয়োজন নেই। নেটিভ EventSource সমস্ত আধুনিক ব্রাউজারে সমর্থন। সার্ভার ইভেন্ট swap এবং পর্যায়ক্রমিক হার্টবিট প্রেরণ করে সংযোগ সচল রাখে।

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

WebSocket Firehose (Paid)

প্রয়োজন: Trader Pro
WSS /v1/ws/live-swaps?ticket=…

অনুমোদন (সুপারিশকৃত): আপনার দীর্ঘস্থায়ী কী URL-এ রাখবেন না — এটি প্রক্সি দ্বারা লগ করা হয় এবং ব্রাউজার ইতিহাসে সংরক্ষিত হয়। পরিবর্তে আপনার কী POST করুন /v1/ws/ticket সুরক্ষিত ব্যবহার করে X-API-Key হেডার, তারপর ফেরত পাওয়া একক-ব্যবহারের সাথে সকেট খুলুন ticket (বৈধ ~60সেকেন্ড, একবার ব্যবহারযোগ্য)। সার্ভার-সাইড ক্লায়েন্ট যারা হেডার সেট করতে পারে তারা হ্যান্ডশেকের সময় সরাসরি পাঠাতে পারে X-API-Key সরাসরি। ফ্রি-টিয়ার কীগুলি একটি পায় 402 payment_required প্রতিক্রিয়া। একটি hello ফ্রেম সংযোগের সময় আপনার টিয়ার এবং সম্প্রচার থ্রেশহোল্ড সহ পাঠানো হয়।

JavaScript (browser)
// 1. Exchange your key for a short-lived ticket (key stays in the header)
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
  method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. Open the socket with the single-use ticket
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
  const swap = JSON.parse(e.data);
  if (swap.type === "swap") console.log(swap);
};

WebSocket authentication (tickets)

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

Flow: POST to /v1/ws/ticket with your X-API-Key header → receive { "ticket": "…", "expires_in": 60 }. Then open wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>টিকেটটি হল একক-ব্যবহার এবং মেয়াদ শেষ হয় ~60 সেকেন্ডেসার্ভার-সাইড ক্লায়েন্ট যারা রিকোয়েস্ট হেডার সেট করতে পারে তারা পরিবর্তে পাস করতে পারে X-API-Key সরাসরি ওয়েবসকেট হ্যান্ডশেকের উপর — কোন টিকেটের প্রয়োজন নেই।

POST /v1/ws/ticket
প্রয়োজন: ট্রেডার প্রো

একটি প্রমাণিত ওয়েবসকেট হ্যান্ডশেকের জন্য এককালীন টিকেট তৈরি করে। প্রমাণীকরণ করুন 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
}

প্রতিক্রিয়া ক্ষেত্র

ক্ষেত্রপ্রকারবর্ণনা
ticketstringএকক-ব্যবহার টোকেন হিসাবে সংযুক্ত করুন ?ticket= ওয়েবসকেট URL-এ। একবার ব্যবহার করা হয়, তারপর বাতিল করা হয়।
expires_innumberটিকেট মেয়াদ শেষ হওয়ার আগে সেকেন্ড (~60)। প্রতিটি সংযোগ প্রচেষ্টার জন্য একটি নতুন টিকেট তৈরি করুন।

দ্রষ্টব্য: লিগ্যাসি ?key= কোয়েরি-প্যারাম প্রমাণীকরণ আর গ্রহণ করা হয় না ওয়েবসকেট এন্ডপয়েন্টগুলিতে নিরাপত্তা কারণে। একটি টিকেট ব্যবহার করুন (ব্রাউজার ক্লায়েন্ট) বা X-API-Key হ্যান্ডশেক হেডার (সার্ভার-সাইড ক্লায়েন্ট)।

REST স্ন্যাপশট

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

রোলিং বাফার থেকে শেষ N ব্রডকাস্ট সোয়াপ ফেরত দেয়। ড্যাশবোর্ডে প্রথম-পেইন্টের জন্য দরকারী যখন স্ট্রিম সংযোগ খোলে। এছাড়াও উপলব্ধ: /v1/live-swaps/status ব্রডকাস্টার পরিসংখ্যানের জন্য।

ইভেন্ট স্কিমা

ক্ষেত্রপ্রকারবর্ণনা
chainstringbsc বা avalanche
dexstringরাউটার নাম (যেমন pancakeswap_v2, traderjoe) বা unknown_dex
swapperstringওয়ালেটের সম্পূর্ণ 0x ঠিকানা যা সোয়াপ সম্পাদন করেছে
swapper_shortstringপ্রদর্শনের জন্য সংক্ষিপ্ত ফর্ম (যেমন 0xb300…028d)
swapper_urlstringচেইনের ব্লক এক্সপ্লোরারে সোয়াপারের সরাসরি লিঙ্ক
tx_hashstringলেনদেন হ্যাশ
explorer_urlstringBscScan / Snowtrace-এ লেনদেনের সরাসরি লিঙ্ক
token_instringবিক্রিত টোকেনের প্রতীক (যেমন USDT)
token_outstringকেনা টোকেনের প্রতীক
amount_usdnumberসোয়াপের USD মান (সর্বনিম্ন: $500)
pairstringফরম্যাট করা পেয়ার লেবেল (যেমন USDT → USDC)
blocknumberব্লক নম্বর যেখানে সোয়াপ খনন করা হয়েছিল
timestampnumberইউনিক্স ইপোক সেকেন্ড
significancestringlow / medium / high / critical USD সাইজের উপর ভিত্তি করে
seqnumberমনোটোনিক ব্রডকাস্ট সিকোয়েন্স নম্বর — ফাঁক সনাক্তকরণের জন্য ব্যবহার করুন

POST  /alerts/conditions

প্রয়োজন: প্রো

কাস্টম অ্যালার্ট নিয়ম তৈরি করুন যা একটি নির্দিষ্ট মেট্রিক একটি থ্রেশহোল্ড অতিক্রম করলে ট্রিগার হয়। অ্যালার্টগুলি আপনার পছন্দ অনুযায়ী ওয়েবহুক, ইমেল, বা ড্যাশবোর্ড নোটিফিকেশন ফিডের মাধ্যমে সরবরাহ করা হয়।

GET /v1/alerts/conditions

আপনার কনফিগার করা সমস্ত অ্যালার্ট শর্তগুলির তালিকা ফেরত দেয় তাদের আইডি, সংজ্ঞা এবং বর্তমান অবস্থা সহ।

DELETE /v1/alerts/conditions/{id}

একটি অ্যালার্ট শর্তকে তার আইডি দ্বারা স্থায়ীভাবে সরিয়ে দেয়।

GET /v1/alerts/history

সম্প্রতি অ্যালার্ট ট্রিগার ইভেন্টগুলিকে টাইমস্ট্যাম্প, ম্যাচ করা শর্ত এবং ট্রিগার সময়ের মেট্রিক মান সহ ফেরত দেয়।

অ্যালার্ট তৈরি করুন — অনুরোধ বডি

ক্ষেত্রপ্রকারবর্ণনা
namerequiredstringএই অ্যালার্টের জন্য মানুষের পাঠযোগ্য লেবেল (সর্বোচ্চ ৬৪ অক্ষর)
metricrequiredstringমনিটর করার মেট্রিক। নিচে উপলব্ধ মেট্রিক টেবিল দেখুন।
symboloptionalstringঅ্যাসেট কনটেক্স। symbol-scoped মেট্রিকের জন্য প্রয়োজনীয় যেমন funding_rate.
operatorrequiredstringতুলনা অপারেটর: gt, lt, eq, crosses_above, crosses_below
thresholdrequiredfloatমেট্রিকের বিপরীতে তুলনা করার জন্য সংখ্যাসূচক মান
deliveryoptionalstringডেলিভারি চ্যানেল, যেমন telegram (ডিফল্ট) বা webhook
cooldown_minutesoptionalintegerপুনরায় ট্রিগার করার মধ্যে ন্যূনতম মিনিট (ডিফল্ট ৬০)

বৈধ মেট্রিক এবং অপারেটরের লাইভ তালিকা দ্বারা ফেরত দেওয়া হয় GET /v1/alerts/conditions as available_metrics and available_operators.

উপলব্ধ মেট্রিক

মেট্রিকবিবরণ
funding_ratesymbol-এর জন্য বর্তমান ফান্ডিং রেট (দশমিক হিসাবে)
global_lsrsymbol-এর জন্য গ্লোবাল লং/শর্ট রেশিও
long_pctsymbol-এর জন্য নেট লং অ্যাকাউন্টের শতাংশ
top_trader_lsrsymbol-এর জন্য টপ-ট্রেডার লং/শর্ট রেশিও
taker_ratiosymbol-এর জন্য টেকার কিনা/বিক্রি রেশিও
mvrvমার্কেট ভ্যালু টু রিয়েলাইজড ভ্যালু রেশিও (BTC/ETH)
soprস্পেন্ট আউটপুট প্রফিট রেশিও (BTC/ETH)
exchange_net_flowঅন-চেইন এক্সচেঞ্জ নেট-ফ্লো সিগনাল
accumulationঅন-চেইন অ্যাকিউমুলেশন সিগনাল
whale_long_pctsymbol-এর জন্য ট্র্যাক করা তিমি ওয়ালেটগুলির লং পজিশন ধারণকারী শতাংশ
whale_n_walletssymbol-এ পজিশন সহ ট্র্যাক করা তিমি ওয়ালেটের সংখ্যা
composite_longলং দিকে কোয়েরি করা symbol-এর জন্য কম্পোজিট স্কোর
composite_shortশর্ট দিকে কোয়েরি করা symbol-এর জন্য কম্পোজিট স্কোর
funding_spreadsymbol-এর জন্য ক্রস-ভেন্যু ফান্ডিং স্প্রেড
POST — উদাহরণ বডি
{
"name": "BTC funding rate spike",
"metric": "funding_rate",
"symbol": "BTC",
"operator": "gt",
"threshold": 0.05
}

GET  /kelly

প্রয়োজন: Pro

প্রদত্ত symbol, আত্মবিশ্বাস স্তর এবং দিকের জন্য ঐতিহাসিক সিগনাল পারফরম্যান্স অনুযায়ী ক্যালিব্রেটেড কেলি ক্রাইটেরিয়ন পজিশন সাইজিং সুপারিশ ফেরত দেয়। অতিরিক্ত লিভারেজ এড়াতে অভিজ্ঞতামূলক জয়ের হারগুলিতে পজিশন সাইজ স্থাপন করে।

প্যারামিটার

প্যারামিটারপ্রকারবিবরণ
symbolrequiredstringঅ্যাসেট symbol: BTC, ETH, বা SOL
confidenceoptionalstringমডেল করার জন্য সিগনাল আত্মবিশ্বাস স্তর: HIGH, MEDIUM, বা LOW. ডিফল্ট: HIGH
directionoptionalstringট্রেড দিক: long বা short. ডিফল্ট: long
account_sizeoptionalfloatUSD-এ অ্যাকাউন্ট সাইজ কম্পিউটিং করার জন্য 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": "লাইভ ট্রেডিংয়ের জন্য হাফ-কেলি সুপারিশ করা হয় অনুমানের ত্রুটির জন্য।"
}
প্রো প্ল্যান প্রয়োজন। হিসাবগুলি অনুরোধ করা সিম্বল, কনফিডেন্স এবং দিক প্যারামিটারগুলির সাথে মিলে যাওয়া ঐতিহাসিক সিগন্যালের একটি রোলিং 90-দিনের নমুনার উপর ভিত্তি করে করা হয়েছে।

GET  /performance

উপলব্ধ: ফ্রি ট্রেডার প্রো

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

উপলব্ধ: ফ্রি ট্রেডার প্রো কোনো অথেন্টিকেশন প্রয়োজন নেই

সাইট-ওয়াইড সৎ পারফরম্যান্স পরিসংখ্যান সোর্স করা হয়েছে smart_money_confirm ডিসটিংক্ট-কল আউটকাম থেকে। HIGH এবং MEDIUM কনফিডেন্স টিয়ারে উইন রেট, সামগ্রিক নির্ভুলতা, প্রফিট ফ্যাক্টর এবং একটি প্রতি-সিম্বল ব্রেকডাউন রিটার্ন করে। সমস্ত সংখ্যা স্কোরিং উইন্ডোর উপর ইন-স্যাম্পল; প্রসঙ্গ এবং ফরওয়ার্ড-হোল্ডআউট পদ্ধতির জন্য calibration.html পরামর্শ করুন।

উদাহরণ প্রতিক্রিয়া

JSON
{
"high_winrate": 0.714,
"high_winrate_n": 14,
"medium_winrate": 0.530,
"medium_winrate_n": 34,
"overall_accuracy": 0.613,
"overall_accuracy_n": 48,
"profit_factor": 1.77,
"avg_win_pct": 4.2,
"winrate_horizon": "24h",
"winrate_basis": "distinct confirm calls, 24h resolved outcomes",
"winrate_by_symbol": {
"BTC": { "win_rate": 0.68, "n": 22 },
"ETH": { "win_rate": 0.55, "n": 18 },
"SOL": { "win_rate": 0.60, "n": 8 }
},
"forward_holdout": {
"win_rate": 0.59,
"high_win_rate": 0.70,
"high_n": 10,
"is_distinct_from_insample": false
}
}
ইন-স্যাম্পল ক্যাভিয়েট। এই প্রতিক্রিয়ার সমস্ত সংখ্যা স্কোরার টিউন করার জন্য ব্যবহৃত একই সময়কাল থেকে গণনা করা হয়েছে। forward_holdout অবজেক্টটি একমাত্র সংখ্যা যা স্কোরার কখনও দেখেনি এমন ডেটা থেকে সংগ্রহ করা হয়েছে — সময়ের সাথে এটি বাড়তে দেখুন। সম্পূর্ণ পদ্ধতি এবং ইন-স্যাম্পল / ফরওয়ার্ড-টেস্ট সীমানার জন্য calibration.html দেখুন।

GET  /v1/signals/performance

উপলব্ধ: ফ্রি ট্রেডার প্রো কোনো অথেন্টিকেশন প্রয়োজন নেই

একাধিক রেজোলিউশন হরাইজন (4h, 12h, 24h, 72h) জুড়ে সিগন্যাল আউটকাম ট্র্যাকিং। প্রতি হরাইজন হিট রেট, মোট সিগন্যাল কাউন্ট এবং সিগন্যাল টাইপ অনুযায়ী ব্রেকডাউন রিটার্ন করে।

প্যারামিটার

প্যারামিটারটাইপবর্ণনা
daysঐচ্ছিকintegerদিনে লুক-ব্যাক উইন্ডো। ডিফল্ট: 30
signal_typeঐচ্ছিকstringটাইপ দ্বারা ফিল্টার করুন, যেমন smart_money_confirm or regime_flip। সমস্ত টাইপের জন্য বাদ দিন।
symbolঐচ্ছিকstringঅ্যাসেট সিম্বল দ্বারা ফিল্টার করুন, যেমন BTC। সমস্ত সিম্বল জুড়ে সমষ্টিগতের জন্য বাদ দিন।

উদাহরণ প্রতিক্রিয়া

JSON
{
"signal_type": "smart_money_confirm",
"symbol": "BTC",
"days": 30,
"total_signals": 48,
horizons: {
4h: { hit_rate: 0.65, resolved: 46 },
12h: { hit_rate: 0.61, resolved: 44 },
24h: { hit_rate: 0.58, resolved: 40 },
72h: { hit_rate: 0.54, resolved: 32 }
},
type_breakdown: {
smart_money_confirm: { count: 35, hit_rate_24h: 0.61 },
regime_flip: { count: 13, hit_rate_24h: 0.47 }
}
}

GET  /v1/signals/recent

Available to: Free Trader Pro No authentication required

সমস্ত মনিটর করা সিম্বলে সম্প্রতি প্রকাশিত HIGH এবং MEDIUM সিগন্যালের ফিড। প্রতিটি এন্ট্রিতে সিগন্যাল টাইপ, কনফিডেন্স টিয়ার, দিক এবং রেজোলিউশন স্ট্যাটাস অন্তর্ভুক্ত থাকে যেখানে উপলব্ধ।

Example Response

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

Available to: Free Trader Pro No authentication required

একটি সিগন্যালের রেজোল্ভড আউটকাম তার সংখ্যাসূচক ID দ্বারা। প্রতিটি রেজোলিউশন হরাইজন (4h, 12h, 24h, 72h) এ হিট/মিস সহ সিগন্যাল সময় এবং রেজোলিউশনে মূল্য প্রদান করে।

Parameters

ParameterTypeDescription
idrequiredintegerSignal ID (path segment), e.g. /v1/signals/1042/outcome

Example Response

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

Requires: Free Trader Pro

অথেন্টিকেটেড ইউজারের নিজস্ব API কী এর জন্য কনফার্ম-সিগন্যাল উইন-রেট ব্রেকডাউন। প্রতিটি কনফিডেন্স টিয়ার, প্রফিট ফ্যাক্টর এবং প্রতি-সিম্বল ফিগার সহ ডিসটিংক্ট-কল উইন রেট প্রদান করে। একটি বৈধ হেডার প্রয়োজন। X-API-Key header.

Example Request

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

Example Response

JSON
{
high_winrate: 0.714,
high_n: 14,
medium_winrate: 0.530,
medium_n: 34,
overall_accuracy: 0.613,
overall_n: 48,
profit_factor: 1.77,
winrate_horizon: 24h,
by_symbol: {
BTC: { win_rate: 0.68, n: 22 },
ETH: { win_rate: 0.55, n: 18 }
}
}
Distinct-call basis. Win rates are computed per distinct confirm call (one per symbol per 5-minute window), not per every API hit — this prevents N-inflation from bots that poll repeatedly. Figures are in-sample over the default 30-day window; the same caveat as /v1/stats applies.

Shadow Gate

Requires: Free Trader Pro

An immutable, append-only personal decision ledger. Submit your trade decisions before or after executing them; the system computes a confirm score against the Smart Money engine and appends a permanent row. Use it to build an honest, timestamped track record of how well the API's signal aligned with your own entries — entirely independent of the global win-rate pool. Free and Trader tier responses have evidence fields stripped; Pro returns the full breakdown. A tier delay applies to Free tier data.

POST /v1/shadow-gate/decisions

Submit a decision. Idempotent on the Idempotency-Key request header — re-submitting the same key returns the existing row without creating a duplicate. The system immediately calls the confirm engine and appends the result as an immutable ledger row.

Request Body

FieldTypeDescription
symbolrequiredstringAsset symbol, e.g. BTC
siderequiredstringTrade direction: long or short
strategy_idoptionalstringCaller-defined strategy label (max 64 chars). Stored as-is for grouping and filtering.

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 প্রো সম্পূর্ণ কনফার্ম ব্রেকডাউন রিটার্ন করে। ফ্রি-তে একটি টিয়ার বিলম্ব প্রযোজ্য — সারিটি অবিলম্বে লেখা হয় কিন্তু কনফার্ম স্কোর ক্যাশে করা ডেটা প্রতিফলিত করতে পারে যা 60 সেকেন্ড পুরানো।
GET /v1/shadow-gate/decisions

আপনার নিজের শ্যাডো-গেট সিদ্ধান্তগুলির তালিকা করুন, নতুন থেকে শুরু করে। মালিক-স্কোপড — শুধুমাত্র আপনার API কী দ্বারা জমা দেওয়া সিদ্ধান্তগুলি ফেরত দেওয়া হয়।

প্যারামিটার

প্যারামিটারটাইপবিবরণ
limitঐচ্ছিকintegerফেরত দেওয়ার জন্য সর্বাধিক সারি। ডিফল্ট: 50, সর্বাধিক: 200
কার্সারঐচ্ছিকস্ট্রিংপূর্ববর্তী প্রতিক্রিয়ার অস্পষ্ট পৃষ্ঠা নির্দেশক 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}

আইডি দ্বারা একক সিদ্ধান্ত, Pro টিয়ারের জন্য সম্পূর্ণ নিশ্চিত প্রমাণ সহ। Free এবং Trader টিয়ারের প্রতিক্রিয়াগুলিতে factors এবং adjustments অপসারণ করা হয়েছে। রিটার্ন 403 যদি সিদ্ধান্তটি একটি ভিন্ন API কী এর অন্তর্গত হয়।

উদাহরণ প্রতিক্রিয়া (Pro)

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

একটি সিদ্ধান্তের ফলাফল ম্যানুয়ালি সমাধান করুন। ট্রেড বন্ধ করার পরে এটি কল করুন যাতে লেজার সারির বিরুদ্ধে চূড়ান্ত ফলাফল রেকর্ড করা যায়। একবার সমাধান হয়ে গেলে, সারিটি অপরিবর্তনীয় এবং আবার পরিবর্তন করা যায় না।

অনুরোধ বডি

ফিল্ডটাইপবর্ণনা
outcomeপ্রয়োজনীয়stringট্রেড ফলাফল: win বা loss
exit_priceঐচ্ছিকfloatট্রেডের জন্য প্রস্থান মূল্য। রেফারেন্সের জন্য সংরক্ষিত; প্রদান করা হলে P&L % গণনা করতে ব্যবহৃত হয়।
pnl_pctঐচ্ছিকfloatপজিশন সাইজের শতাংশ হিসাবে রিয়েলাইজড P&L, উদাহরণস্বরূপ 3.5 বা -1.2

উদাহরণ প্রতিক্রিয়া

JSON
{
id: 318,
resolved: True,
outcome: win,
exit_price: 65800.0,
pnl_pct: 4.1,
resolved_at: 1711027200
}
অপরিবর্তনীয়তা। লেজার সারি শুধুমাত্র সংযোজনযোগ্য। একবার একটি সিদ্ধান্ত জমা দেওয়া হলে এটি মুছে ফেলা যায় না, এবং একবার সমাধান হয়ে গেলে এটি পুনরায় সমাধান করা যায় না। এটি নিশ্চিত করে যে আপনি যে ট্র্যাক রেকর্ড তৈরি করেন তা সৎ এবং টেম্পার-এভিডেন্ট।

ত্রুটি কোড

স্ট্যাটাসকোডবর্ণনা
400invalid_paramsঅনুপস্থিত বা অবৈধ ক্যোয়ারী প্যারামিটার
401unauthorizedঅনুপস্থিত বা অবৈধ API কী
403plan_restrictionআপনার বর্তমান প্ল্যানে এন্ডপয়েন্ট উপলব্ধ নয়
429rate_limit_exceededদৈনিক বা বিস্ফোরণ সীমা পৌঁছেছে
500internal_errorসার্ভার ত্রুটি — সোর্স স্ট্যাটাসের জন্য /health চেক করুন
503data_staleডেটা সোর্স অনুপলব্ধ; শেষ পরিচিত ডেটা সহ ফেরত

কোড উদাহরণ

Python

Python
import requests

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

print(data[confidence]) # HIGH / MEDIUM
print(data[size_mult]) # 1.5 / 1.0
Python
import requests

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

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

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

JavaScript / Node.js

JavaScript
const API_KEY = 'sm_your_key';

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

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

cURL

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

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

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

Freqtrade ইন্টিগ্রেশন

Freqtrade স্ট্র্যাটেজিতে Smart Money কনফার্মেশন যোগ করতে confirm_trade_entry মেথড ওভাররাইড করুন।

পাইথন — Freqtrade স্ট্র্যাটেজি
import requests
from freqtrade.strategy import IStrategy

class SmartMoneyStrategy(IStrategy):
SM_API_KEY = "sm_your_key"
SM_BASE = "https://api.smartmoneyapi.com/v1"

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

CCXT + Smart Money

পাইথন — CCXT
import ccxt, requests

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

SM_KEY = "sm_your_key"

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

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

adj_amount = amount * conf["size_mult"]
order = exchange.create_market_order(
f"{symbol}/USDT", side, adj_amount
)
print(f"Order placed: {adj_amount} {symbol} {side}")
return order
সাহায্য প্রয়োজন?

চেক করুন API স্ট্যাটাস পেজ রিয়েল-টাইম স্বাস্থ্য তথ্যের জন্য, অথবা আমাদের যোগাযোগ ফর্ম.