ForHosting KIT · المال والتمويل

حاسبة العائد السنوي الفعلي

عائد 2% خلال ربع سنة يعادل نحو 8.24% في السنة لا 8%، لأن ربح كل ربع يواصل الكسب في الربع التالي. أدخل عائد فترة حيازة واحدة وعدد هذه الفترات في السنة. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

عائد فترة الاحتفاظ: 2
الفترات في السنة: 4

تحصل على

عائد فترة الاحتفاظ (عشري): 0.02
العائد السنوي الفعلي: 0.08243216
العائد السنوي الفعلي (%): 8.243216

العوائد المعلنة على الأذون والسندات القصيرة وغيرها من أدوات السوق النقدي غالبًا ما تكون عوائد فترة حيازة: ما تحقق خلال نافذة قسيمة أو ربع سنة أو العمر المتبقي لمطالبة نقدية. مقارنة تلك الأرقام بعائد سند أو APY ادخارية أو منتج آخر يرسمل وفق تقويم مختلف مضلّلة إلى أن تُعاد صياغتها على مقياس سنوي مشترك. العائد السنوي الفعلي ينجز تلك الإعادة مع الرسملة: EAY يساوي واحدًا زائد عائد فترة الحيازة، مرفوعًا إلى عدد تلك الفترات في السنة، ناقص واحد. عائد فترة حيازة ربعي بنسبة اثنين بالمئة ليس ثمانية بالمئة في السنة؛ أربع فترات مركّبة تنتج نحو 8.24 بالمئة.

معنى العائد السنوي الفعلي وكيف ترسمل الصيغة

عائد فترة الحيازة هو التغيّر النسبي أو العشري في القيمة على فاصل متقطع: الأشهر الثلاثة حتى استحقاق أذن خزانة، أو الستة أشهر بين تواريخ القسيمة، أو أي فترة معاد صياغتها يستخدمها المنتج فعلًا. يجيب عن مقدار ما كسبتم في تلك النافذة، لا عن مقارنة النافذة بسنة. الاختصارات الاسمية مثل ضرب عائد ربعي في أربعة تتجاهل الرسملة داخل السنة وتبخس المعدل السنوي الحقيقي كلما كان العائد الدوري موجبًا.

العائد السنوي الفعلي يعيد الرسملة. اكتبوا HPY لعائد فترة الحيازة كنسبة عشرية وm لعدد تلك الفترات التي تتسع في سنة. عندئذٍ EAY يساوي واحدًا زائد HPY، مرفوعًا إلى m، ناقص واحد.

إذا درّت أداة لثلاثة أشهر اثنين بالمئة فإن HPY يساوي 0.02 وm يساوي 4، فيكون EAY هو 1.02 مرفوعًا إلى الرابعة ناقص واحد، أي 0.08243216 أو 8.243216 بالمئة، لا الثمانية بالمئة التي تقتبسها سنوية خطية. عندما يساوي m واحدًا يتطابق EAY مع HPY لأن فترة الحيازة سنة أصلًا. عندما يكون HPY صفرًا يكون EAY صفرًا.

عندما يكون HPY سالبًا لكنه أكبر من سالب مئة بالمئة يكون EAY سالبًا ويصف انخفاضًا سنويًا مركّبًا. عائد فترة حيازة بسالب مئة بالمئة أو أسوأ يجعل واحدًا زائد HPY صفرًا أو سالبًا، وهي هوية لا تقبل الرسملة، فترفض الحاسبة تلك الحالة بدل إرجاع نتيجة غير متناهية. يجب أن تكون الفترات في السنة موجبة بصرامة: الصفر ليس تواترًا، وm السالب يعكس عامل النمو إلى تقويم لا وجود له.

أين تُثبت حاسبة العائد السنوي الفعلي قيمتها

مرشحو CFA ومكاتب الدخل الثابت يستخدمون حاسبة العائد السنوي الفعلي عندما يجب إعادة صياغة تسعيرة سوق نقدي أو عائد حيازة لأذن خزانة أو عائد فترة قسيمة إلى معدل سنوي مركّب يجلس إلى جوار YTM سند أو APY ادخار. فرق المنتج والخزانة تقارن أدوات ربعية وشهرية ويومية على شاشة واحدة دون الضرب في m والتظاهر بأن ذلك رسملة.

المعلمون الذين يشرحون الفرق بين عائد فترة الحيازة وعائد الخصم المصرفي وAPR الاسمي والعائد السنوي الفعلي يمكنهم بذر أمثلة صفية تُظهر اثنين بالمئة في الربع ترسمل إلى 8.24 بالمئة في السنة، ثم الفشل القاطع عندما يكتب أحدهم تواترًا صفريًا. فشل التحقق لا يستهلك الرصيد. أبقوا الطلبات صغيرة وثبّتوا العوائد المقّربة في الاختبارات لتحصلوا على EAY قابل للتكرار للواجبات وإضافات LMS وعمال الحافة دون نصب بحث هدف في جدول أو مكتبة دخل ثابت كاملة خاصة بكم.

حالات الاستخدام

إعادة صياغة عائد حيازة في السوق النقدي

حوّلوا عائد حيازة أذن خزانة أو ورقة تجارية وعدد الفترات في السنة إلى عائد سنوي فعلي مركّب يمكن مقارنته بسند أو APY ادخار.

فحوصات صفية وعلى أسلوب CFA

تحققوا من EAY = (1 + HPY)^m − 1 في أمثلة ربعية ونصف سنوية وشهرية، بما في ذلك الفشل المطلوب عندما تكون الفترات في السنة صفرًا أو سالبة.

مقارنات المنتج والخزانة

وحّدوا عوائد فترة القسيمة أو الدفع من تقاويم مختلفة على مقياس سنوي مركّب واحد في التقارير وAPIs.

الأسئلة الشائعة

كيف يُحسب العائد السنوي الفعلي من عائد فترة الحيازة؟

الهوية هي EAY = (1 + HPY)^m − 1، حيث HPY عائد فترة الحيازة عشريًا وm عدد تلك الفترات في السنة. وتعيد الحاسبة المعدل نفسه نسبة مئوية أيضًا.

لماذا لا يكون عائد ربعي بنسبة 2% مساويًا لـ 8% في السنة؟

السنوية الخطية تضرب 2% في أربعة وتتجاهل الرسملة. (1.02)^4 − 1 يساوي 0.08243216، نحو 8.24%، وذلك هو العائد السنوي الفعلي.

ما عائد فترة الحيازة؟

هو ما يكسبه الاستثمار خلال فترة محددة: الأشهر الثلاثة حتى استحقاق أذن الخزانة، أو الأشهر الستة بين قسيمتين، أو أي فترة أخرى يعتمدها المنتج. ويبيّن الربح في تلك النافذة لا ما يعادله سنويًا.

كم فترة في السنة يجب أن أُدخل؟

عدد فترات الحيازة التي تتسع لها السنة: 1 للسنوي، و2 لنصف السنوي، و4 للربعي، و12 للشهري، و52 للأسبوعي، و365 لليومي. ويجب أن يكون أكبر من صفر، وتُقبل الكسور إذا تطلبتها فترتك.

هل يمكن أن يكون عائد الفترة سالبًا؟

نعم ما دام أكبر من سالب 100%. فالعائد السالب يعطي عائدًا سنويًا فعليًا سالبًا، أي تراجعًا سنويًا مركبًا. أما خسارة 100% أو أكثر فلا يمكن رسملتها وتُرفض.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/fin/effective-annual-yield

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/fin/effective-annual-yield \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"holding_period_yield":2,"periods_per_year":4}'

const res = await fetch("https://api.kit.forhosting.com/fin/effective-annual-yield", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "holding_period_yield": 2,
    "periods_per_year": 4
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/effective-annual-yield",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "holding_period_yield": 2,
    "periods_per_year": 4
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/effective-annual-yield", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"holding_period_yield":2,"periods_per_year":4}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"holding_period_yield":2,"periods_per_year":4}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/effective-annual-yield", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "holding_period_yield": 2,
  "periods_per_year": 4
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.effective_annual_yield",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

تقبل هذه الحاسبة العائد الدوري وعدد الفترات في السنة، وتعيد المعدل السنوي عشريًا ونسبة مئوية، وترفض عددًا صفريًا أو سالبًا بـ invalid_input حتى لا يتحوّل تقويم فاسد في صمت إلى معدل غير متناهٍ. الحساب النقي نفسه يشغّل ودجت المتصفح المجاني ومسار API المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح.

عقد الإدخال وشكل الاستجابة وسلوك الخطأ

يجب أن يكون عددًا متناهيًا أكبر من الصفر بصرامة؛ التواترات الكسرية مسموحة إن استخدمتها إعادة الصياغة. إذا لم يكن واحد زائد عائد فترة الحيازة العشري موجبًا بصرامة فالرسملة غير معرّفة وتفشل المهمة. أرسلوا عبر POST جسم JSON برقمين متناهيين إلزاميين: holding_period_yield و periods_per_year. افتراضيًا holding_period_yield نسبة مئوية: اثنان يعنيان عائد فترة حيازة اثنين بالمئة. اضبطوا as_percent على false لتمرير نسبة عشرية (0.02 لنفس الاثنين بالمئة). periods_per_year هو عدد فترات الحيازة تلك التي تتسع في سنة: 1 سنوي، 2 نصف سنوي، 4 ربعي، 12 شهري، 52 أسبوعي، 365 يومي. عدد صحيح اختياري decimals من 0 إلى 12 (الافتراضي 8) يتحكّم في تقريب half-up المطبق مرة واحدة على holding_period_yield_decimal و effective_annual_yield و effective_annual_yield_percent. الأسماء البديلة المقبولة للعائد هي hpy و periodic_yield؛ وللتواتر m و frequency. يجوز أن يصل كل حقل عددي كرقم JSON أو كسلسلة رقمية. الحقول الناقصة والسلاسل الفارغة والقيم المنطقية وغير المتناهية تفشل بـ invalid_input مع تسمية الحقل ولا تُحاسب. إذا كان periods_per_year صفرًا أو سالبًا يفشل المعالج برسالة أنه يجب أن يكون أكبر من الصفر، لأن تواتر رسملة غير موجب ليس تقويمًا. عند النجاح يعيد الجسم holding_period_yield و periods_per_year و as_percent؛ ويعيد holding_period_yield_decimal (الـ HPY المستخدم في القوة)؛ و effective_annual_yield كنسبة عشرية؛ و effective_annual_yield_percent لذلك المعدل مضروبًا في مئة؛ وسلسلة صيغة تعيد صياغة eay = (1 + hpy)^m - 1. مثال: holding_period_yield 2 مع periods_per_year 4 ينتج عائدًا سنويًا فعليًا قدره 0.08243216 أو 8.243216 بالمئة.

أين تُثبت حاسبة العائد السنوي الفعلي قيمتها

الأتمتة التي تخزّن أصلًا عائدًا دوريًا وتقويم دفع يمكنها إرسال الرقمين عبر POST وتثبيت effective_annual_yield في الاختبارات بدل إعادة اشتقاق القوة في كل خدمة. مواقع المحتوى التي تستهدف العائد السنوي الفعلي أو EAY من HPY أو سنوية عائد الحيازة تكسب ودجتًا حيًا يتطابق مساره المجاني في المتصفح مع مسار API المدفوع مسبقًا على الوحدة النقية نفسها. لأن التنفيذ parse نقي من المستوى A، كل استدعاء ناجح يكلف السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.

أسئلة تقنية

ماذا يحدث إذا كانت الفترات في السنة صفرًا أو سالبة؟

تفشل المهمة بـ invalid_input. قيمة periods_per_year غير الموجبة ليست تواتر رسملة، فتُرفض الطلبية ولا تُحاسب.

هل يُدخل عائد فترة الحيازة نسبة مئوية أم عشريًا؟

افتراضيًا as_percent يساوي true، لذا 2 تعني 2%. اضبطوا as_percent على false لتمرير نسبة عشرية مثل 0.02 لنفس العائد.

كم تبلغ تكلفة حاسبة العائد السنوي الفعلي؟

أداة المتصفح مجانية. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ والإدخال غير الصالح لا يُحاسب.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

معنى العائد السنوي الفعلي وكيف ترسمل الصيغة

أين تُثبت حاسبة العائد السنوي الفعلي قيمتها

حالات الاستخدام

إعادة صياغة عائد حيازة في السوق النقدي

فحوصات صفية وعلى أسلوب CFA

مقارنات المنتج والخزانة

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الأخطاء

ملاحظات تقنية

عقد الإدخال وشكل الاستجابة وسلوك الخطأ

أين تُثبت حاسبة العائد السنوي الفعلي قيمتها

أسئلة تقنية

شكرًا