ForHosting KIT · أدوات المطورين

حاسبة متوسط تكلفة العملات المشفرة

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

● Betaمجاني · داخل متصفحك

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

أدخلوا كمية كل عملية شراء وسعر العملة فيها، فتحصلون على إجمالي الكمية المحتفظ بها وإجمالي تكلفة الاقتناء ومتوسط التكلفة. تفيد النتيجة في متابعة المحفظة وتقدير سعر التعادل ومراجعة الأرقام قبل إعداد السجلات. يعتمد الحساب على خطوات حتمية ويمنح عمليات الشراء الكبيرة وزنها الصحيح، بدلاً من استخدام متوسط حسابي بسيط ومضلل للأسعار المدرجة وحدها.

أدخلوا كل عملية شراء كسجل مستقل

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

افهموا طريقة حساب المتوسط المرجّح

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

استخدموا النتيجة ضمن نطاقها الصحيح

يمثل متوسط التكلفة مؤشراً عملياً للمحفظة، لكنه ليس بالضرورة رقماً جاهزاً للإقرار الضريبي. تغطي هذه الحاسبة عمليات الاقتناء فقط، وتفترض أن تكلفة السجل تساوي الكمية مضروبة في السعر. وهي لا تضيف رسوم منصة التداول أو الشبكة أو الحسومات أو التحويلات أو عمليات البيع أو دخل التعدين أو مكافآت التخزين أو الهبات أو الانقسامات أو تحويل العملات. إذا كانت الرسوم جزءاً قانونياً من تكلفة الاقتناء في حالتكم، فأدخلوها ضمن سعر معدل لكل عملة قبل إضافة الصف، واحتفظوا بالسجلات الأصلية التي تشرح التعديل. قد تفرض الجهة الضريبية عند بيع العملات طريقة التحديد بعينه أو FIFO أو LIFO أو طريقة أخرى تعتمد على الولاية القضائية. ويمكن أن تنتج هذه الطرق أرباحاً محققة مختلفة حتى مع معرفة المتوسط الحالي. استخدموا النتيجة للتخطيط أو متابعة المحفظة أو مطابقة السجلات أو الاسترشاد بسعر التعادل، ثم راجعوا القواعد والسجلات المطبقة في بلدكم قبل الإبلاغ عن الأرباح الخاضعة للضريبة. تبلغ كلفة الطلب الآلي عبر API مقدار $0.002.

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

متابعة سعر الدخول إلى المحفظة

اجمعوا المشتريات الدورية في سعر متوسط مرجّح لكل عملة لعرض مؤشر واضح في لوحة المحفظة.

تقدير مستوى التعادل

قارنوا متوسط تكلفة الاقتناء بسعر السوق قبل احتساب الرسوم أو الضرائب أو قواعد التصرف في العملات.

مطابقة سجلات منصة التداول

تحققوا من أن كميات المشتريات وتكاليفها المصدرة تنتج الإجماليات المجمعة المتوقعة.

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

ما المعادلة التي تستخدمها الحاسبة؟

تقسم مجموع حاصل ضرب الكمية في السعر لكل عملية شراء على مجموع جميع الكميات المقتناة.

لماذا لا تُحسب الأسعار بمتوسط مباشر؟

يمنح المتوسط المباشر عملية الشراء الصغيرة والكبيرة التأثير نفسه، بينما يعكس الترجيح عدد العملات المشتراة عند كل سعر.

هل يمكن أن تكون الكميات كسرية؟

نعم. تُقبل الكميات الكسرية الموجبة، وهو أمر مهم للأصول التي تُشترى عادة بأجزاء صغيرة من العملة.

هل تشمل النتيجة رسوم التداول أو الشبكة؟

لا. أدخلوا سعراً معدلاً إذا أردتم تضمين الرسوم، واحتفظوا بسجلات تشرح كيفية حساب ذلك السعر.

هل تساوي هذه النتيجة أساس التكلفة الضريبي؟

ليس بالضرورة. تعتمد المعالجة الضريبية على الولاية القضائية وسجل المعاملات وطريقة التصرف المسموح بها. تحسب الأداة متوسط الاقتناء المرجّح فقط.

كم تبلغ كلفة الحساب عبر API؟

تبلغ كلفة كل طلب API مقدار $0.002. ويتاح الحساب في المتصفح من دون إرسال طلب API.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/finance/crypto-cost-basis

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

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

curl -X POST https://api.kit.forhosting.com/finance/crypto-cost-basis \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchases":[{"quantity":0.5,"price":30000},{"quantity":0.25,"price":36000},{"quantity":1.25,"price":28000}]}'

const res = await fetch("https://api.kit.forhosting.com/finance/crypto-cost-basis", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "purchases": [
      {
        "quantity": 0.5,
        "price": 30000
      },
      {
        "quantity": 0.25,
        "price": 36000
      },
      {
        "quantity": 1.25,
        "price": 28000
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/crypto-cost-basis",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "purchases": [
        {
            "quantity": 0.5,
            "price": 30000
        },
        {
            "quantity": 0.25,
            "price": 36000
        },
        {
            "quantity": 1.25,
            "price": 28000
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/crypto-cost-basis", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"purchases":[{"quantity":0.5,"price":30000},{"quantity":0.25,"price":36000},{"quantity":1.25,"price":28000}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"purchases":[{"quantity":0.5,"price":30000},{"quantity":0.25,"price":36000},{"quantity":1.25,"price":28000}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/crypto-cost-basis", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "purchases": [
    {
      "quantity": 0.5,
      "price": 30000
    },
    {
      "quantity": 0.25,
      "price": 36000
    },
    {
      "quantity": 1.25,
      "price": 28000
    }
  ]
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.crypto_cost_basis",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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