معدل العائد السنوي
استثمار ارتفع من 10000 إلى 16105.10 في خمس سنوات ربح 61.05% إجمالًا، أي 10% سنويًا بالضبط عند احتساب الفائدة المركبة. قارن استثمارات بمدد مختلفة على الأساس السنوي نفسه. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- القيمة الابتدائية
- 10,000
- القيمة النهائية
- 16,105.1
- السنوات
- 5
- العائد السنوي (%)
- 10
- العائد السنوي المحتسب
- 0.1
- العائد الإجمالي (%)
- 61.051
تُدخل القيمة الأولية والقيمة النهائية وفترة الاحتفاظ بالسنوات، فتحصل على النسبة السنوية الثابتة التي كانت ستنقل الرقم الأول إلى الرقم الثاني — وهي العائد السنوي الهندسي — إضافة إلى العائد الإجمالي طوال الفترة. تعمل بشكل حتمي، من دون بيانات سوق ومن دون افتراضات حول التدفقات النقدية الوسيطة، لذا تنتج المدخلات نفسها الإجابة نفسها دائمًا، سواء استدعيتها مرة واحدة في متصفح أو مليون مرة من خط أنابيب للتقارير.
ما الذي يقيسه معدل العائد السنوي فعلًا
استثمار نما من 10,000 إلى 16,105.10 في خمس سنوات حقق ربحًا إجماليًا قدره 61.05 بالمئة، لكن هذا الرقم لا يصلح لمقارنته باستثمار آخر احتُفظ به ثمانية عشر شهرًا. يحوّل معدل العائد السنوي أي فترة احتفاظ إلى رقم سنوي بالسؤال عن معدل النمو السنوي الثابت، المركّب، الذي يعيد إنتاج التغير الملحوظ. رياضيًا هو r = (النهائية / الأولية)^(1 / السنوات) − 1، ويُعبَّر عنه هنا كنسبة مئوية.
في المثال السابق، الإجابة هي 10 بالمئة سنويًا بالضبط. ولأن الصيغة تأخذ الجذر ذا الرتبة n لمضاعف النمو، فإنها تراعي التركيب بصورة صحيحة: سنتان متتاليتان بنسبة 10 بالمئة تنتجان 21 بالمئة إجمالًا، لا 20. لا يحتاج المسار إلا إلى ثلاثة أرقام — القيمة الأولية والقيمة النهائية والسنوات — ويمكن أن تكون السنوات كسرية، فالمركز المحتفظ به ثلاثين شهرًا هو ببساطة 2.5 سنة.
والنتيجة هي العائد السنوي الهندسي، وهو المقياس الصحيح عندما تُعاد الأرباح استثمارها وتريد رقمًا سنويًا قابلًا للمقارنة.
المدخلات والتحقق وكيفية قراءة النتيجة
المدخلات الثلاثة كلها مطلوبة. تُعيد الاستجابة عرض المدخلات الثلاثة لتبقى سجلاتك واصفة لنفسها، ثم تضيف العائد السنوي كنسبة مئوية وككسر عشري، إضافة إلى العائد الإجمالي طوال الفترة كسياق. والرقم السنوي السالب يعني أن الاستثمار فقد قيمته على أساس سنوي مركّب.
وإذا غاب حقل أو لم يكن رقمًا منتهيًا، تسمّي رسالة الخطأ الحقل المسؤول ليتمكن نموذج أو خط أنابيب من تحديد ما يجب تصحيحه بالضبط.
متى تستخدمه — ومتى لا تستخدمه
استخدم هذا المسار كلما لم تكن تملك سوى طرفَي الاستثمار: سعري شراء عقار وبيعه، أو الرصيدين الافتتاحي والختامي لحساب بلا إيداعات وسيطة، أو قيمة مركز في تاريخَي تقرير. وهو مثالي لتوحيد استثمارات احتُفظ بها فترات مختلفة كي تُرتَّب بعدل، ولملء رقم الأداء السنوي في لوحات المعلومات وتقارير العملاء. لا تستخدمه عندما دخل مال أو خرج خلال الفترة — فالإيداعات والسحوبات تشوّه الصيغة البسيطة ذات النقطتين، والأداة المناسبة حينئذ هي حساب معدل العائد الداخلي على التدفقات النقدية الفعلية.
كما أنه يُنعّم التقلب بحكم بنائه: فالأصل الذي تضاعف ثم انخفض إلى النصف ثم تضاعف مجددًا لا يُظهر إلا المسار الصافي بين الطرفين.
حالات الاستخدام
قارن استثمارات احتُفظ بها فترات مختلفة
وحّد مركزًا في الأسهم دام ثلاث سنوات وصفقة دامت ثمانية عشر شهرًا على الأساس السنوي نفسه قبل أن تقرر أيهما كان أفضل أداءً.
أكمل رقم الأداء السنوي في تقرير
أدخل الرصيدين الافتتاحي والختامي في خط أنابيب التقارير وأرفق رقمًا سنويًا متسقًا بكل حساب أو صندوق أو محفظة.
تحقق من بلوغ هدف ما
تأكد من أن استثمارًا كان يُفترض أن يعيد 8 بالمئة سنويًا قد فعل ذلك فعلًا، استنادًا إلى ما أودعته وما قبضته.
الأسئلة الشائعة
كم التكلفة؟
كما يمكن تشغيله مجانًا في متصفحك على هذه الصفحة.
ماذا يحدث إذا كانت فترة الاحتفاظ صفرًا أو سالبة؟
يجب أن تكون فترة الاحتفاظ أكبر من الصفر.
هل يمكن أن تكون القيمة النهائية صفرًا؟
نعم. القيمة النهائية صفر تمثل خسارة كاملة وتنتج عائدًا سنويًا قدره سالب 100 بالمئة.
هل يتعامل مع الإيداعات أو السحوبات خلال الفترة؟
لا. يفترض مركزًا واحدًا يُشترى ويُحتفظ به بين تقييمين. وعند وجود تدفقات نقدية وسيطة، يلزم حساب معدل العائد الداخلي.
هل يمكن أن تكون النتيجة سالبة؟
نعم. كلما كانت القيمة النهائية أدنى من الأولية، كان العائد السنوي سالبًا، ما يعكس خسارة سنوية مركّبة.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/fin/annualized-rate-of-return \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"initial_value":10000,"final_value":16105.1,"years":5}'const res = await fetch("https://api.kit.forhosting.com/fin/annualized-rate-of-return", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"initial_value": 10000,
"final_value": 16105.1,
"years": 5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/annualized-rate-of-return",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"initial_value": 10000,
"final_value": 16105.1,
"years": 5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/annualized-rate-of-return", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"initial_value":10000,"final_value":16105.1,"years":5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"initial_value":10000,"final_value":16105.1,"years":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/annualized-rate-of-return", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"initial_value": 10000,
"final_value": 16105.1,
"years": 5
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.annualized_rate_of_return",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تجيب واجهة برمجة تطبيقات معدل العائد السنوي عن السؤال الذي ينتهي إليه كل مقارنة بين الاستثمارات: كم حقق هذا سنويًا؟
المدخلات والتحقق وكيفية قراءة النتيجة
يجب أن تكون القيمة الأولية أكبر من الصفر قطعًا، لأن مضاعف النمو بالنسبة إلى الصفر غير معرَّف؛ ويجوز أن تكون القيمة النهائية صفرًا، ما يمثل خسارة كاملة وينتج عائدًا سنويًا قدره سالب 100 بالمئة؛ ويجب أن تكون فترة الاحتفاظ موجبة — فأي طلب بسنوات صفرية أو سالبة يُرفض بخطأ invalid_input ولا يُحتسَب أبدًا.
متى تستخدمه — ومتى لا تستخدمه
تكلف العملية $0.002 لكل استدعاء عبر API وتعمل مجانًا في متصفحك على هذه الصفحة، بالشفرة نفسها تمامًا في الجانبين، فيكون الرقم الذي تختبر به هو الرقم الذي تدفع مقابله.
أسئلة تقنية
ما الصيغة المستخدمة؟
r = (final_value / initial_value)^(1 / years) − 1، وتُرجَع كنسبة مئوية. وهو العائد السنوي الهندسي الذي يراعي التركيب.