محوّل العملات وواجهة برمجة أسعار الصرف API | YEB

أسعار صرف فورية لأكثر من 170 عملة (تقليدية، مشفرة، معادن). قارن الأسعار عبر 8 منصات بما في ذلك Wise وRevolut وPayPal. بيانات تاريخية حتى سنة واحدة.

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

احصل على مفتاح API اشترِ أرصدة

ماذا يمكنك أن تفعل؟

أسعار صرف فورية

أكثر من 170 عملة تقليدية ومشفرة ومعادن ثمينة في استدعاء واحد.

مقارنة أسعار المنصات

قارن Wise وRevolut وPayPal وXE و5 منصات أخرى للعثور على أفضل صفقة.

بيانات تاريخية حتى سنة واحدة

لقطات يومية لتحليل الاتجاهات والرسوم البيانية والاختبار الرجعي.

نقطة النهاية:

99.9 % وقت التشغيل

5ms الاستجابة

20 req/s

0.001 الأرصدة / الطلب

List Currencies


POST https://api.yeb.to/v1/currency/currencies

المعامل	النوع	مطلوب	الوصف
`api_key`	string	نعم	Your API key

مثال

curl -X POST https://api.yeb.to/v1/currency/currencies \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY"
}'

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

{
  "currencies": [
    { "code": "EUR", "name": "Euro", "symbol": "\u20ac", "decimals": 2, "type": "fiat" },
    { "code": "USD", "name": "US Dollar", "symbol": "$", "decimals": 2, "type": "fiat" },
    { "code": "BTC", "name": "Bitcoin", "symbol": "\u20bf", "decimals": 8, "type": "crypto" },
    { "code": "XAU", "name": "Gold (Troy Ounce)", "symbol": "XAU", "decimals": 2, "type": "metal" }
  ],
  "total": 182,
  "top_fiat": ["USD","EUR","GBP","BGN","JPY","AUD","CAD","CHF"],
  "top_crypto": ["BTC","ETH","SOL","ADA","BNB","USDT","USDC","XRP","DOGE","DOT"],
  "metals": ["XAU","XAG","XPT","XPD"]
}

{"error":"Invalid API key","code":401}

رموز الاستجابة

الرمز	الوصف
200 Success	تمت معالجة الطلب بنجاح.
400 Bad Request	فشل التحقق من المدخلات.
401 Unauthorized	مفتاح API مفقود أو خاطئ.
403 Forbidden	المفتاح غير نشط أو غير مسموح.
429 Rate Limit	طلبات كثيرة جدًا.
500 Server Error	فشل غير متوقع.

List Currencies

currency/currencies 0.0010 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Code Samples

Response

Status: —

Headers

Body

Get Exchange Rates


POST https://api.yeb.to/v1/currency/rates

المعامل	النوع	مطلوب	الوصف
`api_key`	string	نعم	Your API key
`from`	string	اختياري	Source currency code (use with `to` for single pair)
`to`	string	اختياري	Target currency code (use with `from` for single pair)
`pairs`	array	اختياري	Array of pairs: `[{"from":"EUR","to":"BGN"}, ...]` (max 20)

مثال

curl -X POST https://api.yeb.to/v1/currency/rates \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "from": "EUR",
  "to": "BGN"
}'

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

{
  "rates": [
    {
      "from": "EUR",
      "to": "BGN",
      "rate": 1.955800,
      "source": "fawazahmed0",
      "fetched_at": "2026-02-20T14:30:00Z"
    }
  ]
}

{"error":"pairs array or from/to parameters are required","code":422}

رموز الاستجابة

الرمز	الوصف
200 Success	تمت معالجة الطلب بنجاح.
400 Bad Request	فشل التحقق من المدخلات.
401 Unauthorized	مفتاح API مفقود أو خاطئ.
403 Forbidden	المفتاح غير نشط أو غير مسموح.
429 Rate Limit	طلبات كثيرة جدًا.
500 Server Error	فشل غير متوقع.

Get Exchange Rates

currency/rates 0.0050 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

From Currency

body · string

To Currency

body · string

Pairs

body · string

Code Samples

Response

Status: —

Headers

Body

Convert Currency


POST https://api.yeb.to/v1/currency/convert

المعامل	النوع	مطلوب	الوصف
`api_key`	string	نعم	Your API key
`from`	string	نعم	Source currency code (e.g. EUR, USD, BTC)
`to`	string	نعم	Target currency code (e.g. BGN, GBP, ETH)
`amount`	number	نعم	Amount to convert (0.01 – 10,000,000)
`include_platforms`	bool	اختياري	Include platform rate comparison (default: true)

مثال

curl -X POST https://api.yeb.to/v1/currency/convert \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "from": "EUR",
  "to": "BGN",
  "amount": 1000,
  "include_platforms": true
}'

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

{
  "from": "EUR",
  "to": "BGN",
  "amount": 1000,
  "mid_market": {
    "rate": 1.9558,
    "result": 1955.80
  },
  "platforms": {
    "wise":    { "rate": 1.9460, "result": 1946.03, "fee": 5.93, "total_cost": 15.70, "markup": "0.50%" },
    "revolut": { "rate": 1.9509, "result": 1950.91, "fee": 0,    "total_cost": 4.89,  "markup": "0.25%" },
    "paypal":  { "rate": 1.8776, "result": 1877.57, "fee": 3.99, "total_cost": 82.22, "markup": "4.00%" }
  },
  "sources": { "primary": "fawazahmed0" },
  "fetched_at": "2026-02-20T14:30:00Z"
}

{"error":"Exchange rate not available for xxx/yyy","code":404}

رموز الاستجابة

الرمز	الوصف
200 Success	تمت معالجة الطلب بنجاح.
400 Bad Request	فشل التحقق من المدخلات.
401 Unauthorized	مفتاح API مفقود أو خاطئ.
403 Forbidden	المفتاح غير نشط أو غير مسموح.
429 Rate Limit	طلبات كثيرة جدًا.
500 Server Error	فشل غير متوقع.

Convert Currency

currency/convert 0.0090 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

From Currency

body · string · required

To Currency

body · string · required

Amount

body · string · required

Include Platforms

body · string

Code Samples

Response

Status: —

Headers

Body

List Platforms


POST https://api.yeb.to/v1/currency/platforms

المعامل	النوع	مطلوب	الوصف
`api_key`	string	نعم	Your API key

مثال

curl -X POST https://api.yeb.to/v1/currency/platforms \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY"
}'

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

{
  "platforms": {
    "wise":       { "name": "Wise",          "markup": 0.50, "fee_pct": 0.50, "fee_flat": 0, "weekend_extra": 0 },
    "revolut":    { "name": "Revolut",       "markup": 0.25, "fee_pct": 0,    "fee_flat": 0, "weekend_extra": 0.75 },
    "paypal":     { "name": "PayPal",        "markup": 4.00, "fee_pct": 2.90, "fee_flat": 0, "weekend_extra": 0 },
    "skrill":     { "name": "Skrill",        "markup": 3.99, "fee_pct": 1.45, "fee_flat": 0, "weekend_extra": 0 },
    "western_union": { "name": "Western Union", "markup": 2.00, "fee_pct": 0, "fee_flat": 5, "weekend_extra": 0 },
    "xe":         { "name": "XE",            "markup": 0.50, "fee_pct": 0,    "fee_flat": 0, "weekend_extra": 0 },
    "remitly":    { "name": "Remitly",       "markup": 1.50, "fee_pct": 0,    "fee_flat": 0, "weekend_extra": 0 },
    "ofx":        { "name": "OFX",           "markup": 0.50, "fee_pct": 0,    "fee_flat": 0, "weekend_extra": 0 }
  }
}

{"error":"Invalid API key","code":401}

رموز الاستجابة

الرمز	الوصف
200 Success	تمت معالجة الطلب بنجاح.
400 Bad Request	فشل التحقق من المدخلات.
401 Unauthorized	مفتاح API مفقود أو خاطئ.
403 Forbidden	المفتاح غير نشط أو غير مسموح.
429 Rate Limit	طلبات كثيرة جدًا.
500 Server Error	فشل غير متوقع.

List Platforms

currency/platforms 0.0010 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Code Samples

Response

Status: —

Headers

Body

Historical Rates


POST https://api.yeb.to/v1/currency/historical

المعامل	النوع	مطلوب	الوصف
`api_key`	string	نعم	Your API key
`from`	string	نعم	Source currency code
`to`	string	نعم	Target currency code
`start_date`	string	اختياري	Start date in YYYY-MM-DD (default: 30 days ago)
`end_date`	string	اختياري	End date in YYYY-MM-DD (default: today)

مثال

curl -X POST https://api.yeb.to/v1/currency/historical \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "from": "EUR",
  "to": "BGN",
  "start_date": "2026-01-01",
  "end_date": "2026-01-31"
}'

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

{
  "from": "EUR",
  "to": "BGN",
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "rates": [
    { "date": "2026-01-01", "rate": 1.955800 },
    { "date": "2026-01-02", "rate": 1.955800 },
    { "date": "2026-01-03", "rate": 1.955600 }
  ],
  "count": 31
}

{"error":"Date range must not exceed 365 days","code":422}

رموز الاستجابة

الرمز	الوصف
200 Success	تمت معالجة الطلب بنجاح.
400 Bad Request	فشل التحقق من المدخلات.
401 Unauthorized	مفتاح API مفقود أو خاطئ.
403 Forbidden	المفتاح غير نشط أو غير مسموح.
429 Rate Limit	طلبات كثيرة جدًا.
500 Server Error	فشل غير متوقع.

Historical Rates

currency/historical 0.0200 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

From Currency

body · string · required

To Currency

body · string · required

Start Date

body · string

End Date

body · string

Code Samples

Response

Status: —

Headers

Body

محوّل العملات وواجهة برمجة أسعار الصرف API | YEB — Practical Guide

A hands-on guide to the Currency API: real-time exchange rates from multiple verified sources, platform fee comparison (Wise, Revolut, PayPal & more), historical rate data, and how to integrate it all into your application.

Last updated: 07 مارس 2026, 10:42 API Version: v1 Burst: 20 req/s Latency: 5 ms

#What the Currency API does

The Currency API provides 5 endpoints for production-ready currency data: list 170+ currencies (fiat, crypto & metals), fetch live exchange rates from multiple verified sources, convert amounts with platform fee comparison, browse platform markups, and query historical daily rates for up to one year.

Key advantage: rates are aggregated from multiple independent sources (fawazahmed0, fxratesapi, ECB) and cross-verified. If one source is unavailable or drifts, fallback sources keep your data accurate and fresh.

#Endpoints at a glance

Endpoint	What it does	Credits
`currencies`	List all supported currencies with code, name, symbol, type (fiat/crypto/metal)	0.001
`rates`	Get live exchange rates for one or more currency pairs (max 20)	0.005
`convert`	Convert an amount & compare what you’d receive on 8 platforms	0.009
`platforms`	List platforms with their markup percentages and fee structures	0.001
`historical`	Daily historical rates for a pair (up to 365 days)	0.02

#Convert & Platform Comparison

The convert endpoint is the most popular. It returns the mid-market rate plus what you’d actually receive on each platform after their markup and fees.

POST

curl -X POST https://api.yeb.to/v1/currency/convert \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "from": "EUR",
    "to": "BGN",
    "amount": 1000,
    "include_platforms": true
  }'

The response includes the mid-market conversion and a breakdown per platform:

rate — the effective rate after platform markup
result — what you actually receive
fee — the platform’s transfer fee
total_cost — total hidden cost vs mid-market (markup + fee)
markup — the platform’s markup percentage

#Supported platforms

We compare rates across 8 popular money transfer platforms:

Platform	Markup	Fee	Notes
Wise	0.50%	Variable	Transparent mid-market based
Revolut	0.25%	None (free plan)	+0.75% on weekends
XE	0.50%	None	Close to mid-market
OFX	0.50%	None	Good for large amounts
Remitly	1.50%	Variable	Popular for remittances
Western Union	2.00%	Flat fee	Wide physical network
Skrill	3.99%	1.45%	Digital wallet
PayPal	4.00%	2.90%	Highest total cost

#Currency coverage

The API supports 170+ currencies across three categories:

Fiat — USD, EUR, GBP, BGN, JPY, CHF, AUD, CAD, and 150+ more
Crypto — BTC, ETH, SOL, ADA, BNB, USDT, USDC, XRP, DOGE, DOT
Precious metals — XAU (gold), XAG (silver), XPT (platinum), XPD (palladium)

Use the currencies endpoint to fetch the full list with symbols and decimal precision.

#Historical rates

The historical endpoint returns daily rate snapshots for any pair. Useful for building charts, calculating averages, or backtesting strategies.

Default range: last 30 days
Maximum range: 365 days
Dates in YYYY-MM-DD format

#How rates are sourced

Reliability is built in through multi-source aggregation:

Primary — fawazahmed0 exchange API (CDN-backed, 200+ currencies, no rate limit, updated every 15 min)
Secondary — fxratesapi.com (real-time verification every 30 min)
Fallback — European Central Bank (ECB) daily reference rates
Cache — last known rate if all sources are temporarily unavailable (< 24h)

If the primary and secondary sources diverge by more than 1%, the system logs a deviation warning and uses the primary rate.

#Common use cases

E-commerce — display prices in the visitor’s local currency
Fintech apps — show users how much they’d save on each platform
Travel apps — quick multi-currency converter
Accounting — historical rates for end-of-month reconciliation
Crypto dashboards — live BTC/ETH prices alongside fiat

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

نجمع الأسعار من مصادر مستقلة متعددة (fawazahmed0، fxratesapi، البنك المركزي الأوروبي) ونتحقق منها بشكل متبادل. إذا تعطل أحد المصادر، توفر المصادر الأخرى بديلاً.

تستند هوامش المنصات إلى هياكل الرسوم المنشورة. نطبق نسبة الهامش المعروفة لكل منصة على سعر السوق المتوسط. قد تختلف الأسعار الفعلية قليلاً حسب المبلغ والممر.

نعم. ندعم أكثر من 10 عملات مشفرة رئيسية بما في ذلك BTC وETH وSOL وUSDT وUSDC والمزيد. المعادن الثمينة (XAU، XAG، XPT، XPD) متاحة أيضاً.

الأسعار التاريخية متاحة لمدة تصل إلى 365 يوماً. يتم أخذ لقطات يومية تلقائياً وتخزينها للرسوم البيانية والتحليل.

يتم تحديث الأسعار الأولية كل 15 دقيقة. يتم تشغيل التحقق من المصدر الثانوي كل 30 دقيقة. يتم تخزين عمليات البحث عن أزواج فردية مؤقتاً لمدة 5 دقائق.

نعم. كل طلب، حتى تلك التي تؤدي إلى أخطاء، تستهلك أرصدة. هذا لأن أرصدتك مرتبطة بعدد الطلبات، بغض النظر عن النجاح أو الفشل. إذا كان الخطأ بسبب مشكلة في المنصة من جانبنا، سنستعيد الأرصدة المتأثرة (بدون استرداد نقدي).

تواصل معنا على [email protected]. نأخذ الملاحظات بجدية—إذا كان تقرير الخطأ أو طلب الميزة ذا معنى، يمكننا إصلاح أو تحسين الواجهة بسرعة ومنحك 50 رصيدًا مجانيًا كشكر لك.

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

نعمل بنظام الأرصدة. الأرصدة هي وحدات مسبقة الدفع وغير قابلة للاسترداد تنفقها على استدعاءات API والأدوات. تُستهلك الأرصدة بنظام FIFO (الأقدم أولاً) وصالحة لمدة 12 شهرًا من تاريخ الشراء. تعرض لوحة التحكم تاريخ كل عملية شراء وانتهاء صلاحيتها.

نعم. جميع الأرصدة المشتراة (بما في ذلك الأرصدة الجزئية) صالحة لمدة 12 شهرًا من الشراء. تنتهي صلاحية الأرصدة غير المستخدمة تلقائيًا وتُحذف نهائيًا في نهاية فترة الصلاحية. لا يمكن استعادة الأرصدة المنتهية أو تحويلها إلى نقد أو قيمة أخرى. قاعدة انتقالية: الأرصدة المشتراة قبل 22 سبتمبر 2025 تُعامل كمشتراة في 22 سبتمبر 2025 وتنتهي في 22 سبتمبر 2026 (ما لم يُذكر تاريخ انتهاء أبكر عند الشراء).

نعم—ضمن فترة الصلاحية. تبقى الأرصدة غير المستخدمة متاحة وتُترحل من شهر لآخر حتى تنتهي صلاحيتها بعد 12 شهرًا من الشراء.

الأرصدة غير قابلة للاسترداد. اشترِ فقط ما تحتاجه—يمكنك دائمًا إعادة الشحن لاحقًا. إذا تسبب خطأ في المنصة في فشل الشحن، قد نستعيد الأرصدة المتأثرة بعد التحقيق. لا استرداد نقدي.

الأسعار محددة بالأرصدة وليس بالدولارات. كل نقطة نهاية لها تكلفتها الخاصة—انظر شارة "الأرصدة / الطلب" أعلاه. ستعرف دائمًا بالضبط ما تنفقه.

← العودة إلى واجهات البرمجة

احصل على رصيد لفتح المحتوى والميزات المميزة

نوع العميل

بلد الفوترة

API / نقطة النهاية

العملة

عدد الطلبات

محوّل العملات وواجهة برمجة أسعار الصرف API | YEB

ماذا يمكنك أن تفعل؟

أسعار صرف فورية

مقارنة أسعار المنصات

بيانات تاريخية حتى سنة واحدة

List Currencies

مثال

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

رموز الاستجابة

List Currencies

Parameters

Code Samples

Response

Get Exchange Rates

مثال

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

رموز الاستجابة

Get Exchange Rates

Parameters

Code Samples

Response

Convert Currency

مثال

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

رموز الاستجابة

Convert Currency

Parameters

Code Samples

Response

List Platforms

مثال

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

رموز الاستجابة

List Platforms

Parameters

Code Samples

Response

Historical Rates

مثال

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

رموز الاستجابة

Historical Rates

Parameters

Code Samples

Response

محوّل العملات وواجهة برمجة أسعار الصرف API | YEB — Practical Guide

#What the Currency API does

#Endpoints at a glance

#Convert & Platform Comparison

#Supported platforms

#Currency coverage

#Historical rates

#How rates are sourced

#Common use cases

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

من أين تأتي أسعار الصرف؟

هل أسعار المنصات (Wise، Revolut، إلخ) فورية؟

هل تدعمون أسعار العملات المشفرة؟

إلى أي مدى تعود البيانات التاريخية؟

كم مرة يتم تحديث الأسعار؟

هل الطلبات التي تحتوي على أخطاء تُحتسب وتكلف أرصدة؟

وجدت خطأ أو أريد تخصيصات في واجهات البرمجة. ماذا أفعل؟

ما هو حد المعدل؟

كيف يعمل الدفع والاستخدام؟

هل تنتهي صلاحية الأرصدة؟

هل تُترحل الأرصدة غير المستخدمة؟

هل تقدمون استردادات؟

كم تكلف كل استدعاء API؟