بدء سريع مع الـ API

سعر الرصيد: 0.001 $ (1000 رصيد مجاني عند التسجيل). العنوان الأساسي https://api.marketapi.app/v1. أرسل مفتاحك في ترويسة Authorization. تُرفض المفاتيح في عناوين URL.

curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/bars?symbol=EURUSD&timeframe=M1&from=2026-09-01T00:00:00Z&to=2026-09-02T00:00:00Z"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/symbols/EURUSD"

EURUSD وXAUUSD مجرد أمثلة: ضع مكانهما الرمز الذي تريده، مكتوبًا تمامًا كما في قائمة الأسعار (مجمّعة حسب السوق: فوركس، معادن، مؤشرات، أسهم، طاقة، عملات مشفرة، مع بحث) أو في قائمة الرموز (CSV). وتُفصل الرموز المتعددة بفواصل.

منتجان بمفتاح API واحد. يقدّم API أسعار السوق أدناه الأسعار للتطبيقات والروبوتات ولوحات المعلومات. ويقدّم أوراكل الأسعار على السلسلة الأسعار نفسها كتقارير موقّعة تتحقق منها العقود الذكية على السلسلة.

نقاط النهاية

إلى أي مدى تعود الشموع: M1 7 days · M2–M6 30 days · M10–M30 3 months · H1 12 months · H2–H12 3 years · D1–MN1 5 years (بقدر ما يمتد تاريخ السوق نفسه).

أوراكل الأسعار على السلسلة (للعقود الذكية)

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

1. اجلب تقريرًا بمفتاح API الخاص بك:

   curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/oracle/report?symbols=XAUUSD&chain_id=10"

2. أرسل report وsignature الخاصين به إلى submit() في المتحقق ضمن معاملتك.
3. اقرأ السعر المُتحقَّق منه بـ getPriceNoOlderThan(feedId, maxAge). لا يعيد إلا سعرًا مباشرًا (السوق OPEN) أحدث من maxAge.

يذكر كل تقرير حالة السوق (OPEN أو CLOSED أو HALTED) وفارق الشراء والبيع، وتنتهي صلاحيته بعد نحو دقيقة من التوقيع. للخلاصات معرّفات ثابتة (keccak256("XAUUSD"))، وتوقف قواطع الدائرة القفزات غير الطبيعية، ويتوفر محوّل متوافق مع Chainlink (latestRoundData). يمكن قراءة الأسعار التي خزّنها المُرحِّل لدينا على السلسلة مجانًا.

توثيق الأوراكل الخلاصات والشبكات والعقود

الفئة المجانية (بلا مفتاح)

جرّب الـ API دون حساب: 10 طلب في الدقيقة و1000 في اليوم لكل عنوان IP، حتى 5 رمز لكل طلب.

curl "https://api.marketapi.app/v1/free/prices/latest?symbols=EURUSD"
curl "https://api.marketapi.app/v1/free/symbols"
curl "https://api.marketapi.app/v1/free/market-status?symbols=EURUSD"

تحتاج المزيد؟ أنشئ حسابًا للوصول الكامل بمفتاح API الخاص بك.

حالة السعر

يحمل كل سعر status لا يقول إلا شيئًا واحدًا: مدى حداثة السعر.

أضف require_live=true لتتلقى أسعار LIVE فقط؛ ولا تُحتسب الرموز المستبعدة. يظهر كل رمز مطلوب في قائمة واحدة بالضبط: data (له سعر) أو no_data (رمز معروف، لا سعر بعد) أو unknown (غير متاح).

ساعات التداول. يُتداول الفوركس والمعادن ومعظم المؤشرات من مساء الأحد إلى مساء الجمعة (UTC). وتتبع عقود فروقات الأسهم وصناديق ETF الجلسة الاعتيادية لبورصتها بالتوقيت المحلي مع التوقيت الصيفي: نيويورك 09:30–16:00، ولندن 08:00–16:30، وفرانكفورت وباريس 09:00–17:30. تُحسب عطلات البورصات (NYSE وLSE وXetra وEuronext) أيام إغلاق. خارج هذه الساعات يكون السعر MARKET_CLOSED لا STALE؛ وإذا واصل المصدر التسعير رغم ذلك (مثلًا قبل الافتتاح) يكون السعر LIVE.

مواصفات الأدوات

يعيد GET /v1/symbols/{symbol} المواصفات الكاملة للأداة كما يوردها المصدر، بما فيها العملات وحجم العقد وحجم التيك وحدود الحجم، مع جلسات تداولها. ويعرض GET /v1/symbols/{symbol}/properties/history كل تغيير عليها. وتتضمن قائمة الرموز (CSV) حقول المواصفات الرئيسية.

إعادة المحاولة الآمنة

أرسل ترويسة Idempotency-Key لجعل إعادة المحاولة آمنة: تكرار طلب بالمفتاح نفسه خلال 24 ساعة يعيد الرد الأول بالضبط، دون احتساب (ردود حتى 2 MB). وللبيانات الحالية أرسل مفتاحًا جديدًا؛ والمفتاح الذي لم يعد رده محفوظًا يتلقى 409 idempotency_key_used.

الأسعار اللحظية (روبوتات التداول ولوحات المعلومات)

طريقتان للحصول على أحدث سعر. كلتاهما تقدّمان الأسعار نفسها؛ اختر بحسب طريقة عمل برنامجك.

ما مدى حداثة السعر؟

الرموز التي تبثّها، أو التي طلبتها عبر /prices/latest خلال آخر 5 دقائق، تُحدَّث من المصدر نحو كل ثانية (حتى رمز من هذا النوع لجميع العملاء في آن واحد). وتُحدَّث كل الرموز الأخرى باستمرار في الخلفية، بوتيرة أقل. لذا: اطلب الرموز التي تتداولها أو اشترك فيها، فتصبح سريعة.

يحمل كل سعر time، أي لحظة إنتاج المصدر له (UTC)، وstatus. يجب على برنامج التداول التحقق من كليهما دائمًا:

• استخدم require_live=true في استدعاءات REST: لا تُعاد إلا أسعار LIVE (وتُدرج البقية منفصلة دون احتساب).
• قارن time بساعتك وتجاهل الأسعار الأقدم مما تتحمله استراتيجيتك. قد تكون الأسواق هادئة: فقد لا يتغير السعر لفترة بشكل مشروع.

مثال REST

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"

{"data": [{"symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
           "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}],
 "not_live": [], "unknown": [], "no_data": []}

الاستعلام أسرع من مرة في الثانية لا يفيد شيئًا: فهذا معدل قراءة المصدر للرموز النشطة.

بروتوكول WebSocket

اتصل بـ /stream مع الترويسة Authorization: Bearer <your key> (الصلاحية read:latest). ثم أرسل رسائل JSON:

> {"action": "subscribe",   "symbols": ["EURUSD", "XAUUSD"]}
< {"type": "subscribed", "symbols": ["EURUSD", "XAUUSD"], "rejected": []}
< {"type": "quote", "symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
   "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}
> {"action": "unsubscribe", "symbols": ["XAUUSD"]}
< {"type": "error", "code": "...", "detail": "..."}

الحدود: حتى 50 رمز لكل اتصال. رموز الإغلاق: 4401 مفتاح غير صالح، و4402 نفد الرصيد (اشحن ثم أعد الاتصال)، و4429 اتصالات مفتوحة كثيرة جدًا. يرسل الخادم إشارات ping كل 20 ثانية؛ وتردّ عليها معظم مكتبات WebSocket تلقائيًا.

مثال Python (pip install "websockets>=14")

import asyncio, json, os, websockets

async def main():
    url = "/stream"
    headers = {"Authorization": "Bearer " + os.environ["API_KEY"]}
    while True:                                   # reconnect with backoff
        try:
            async with websockets.connect(url, additional_headers=headers) as ws:
                await ws.send(json.dumps({"action": "subscribe", "symbols": ["EURUSD"]}))
                async for raw in ws:
                    msg = json.loads(raw)
                    if msg["type"] == "quote" and msg["status"] == "LIVE":
                        print(msg["symbol"], msg["bid"], msg["ask"], msg["time"])
        except websockets.ConnectionClosed as e:
            if e.code in (4401, 4402):            # wrong key / no balance: retrying will not help
                raise
        await asyncio.sleep(5)

asyncio.run(main())

مثال Node.js (npm install ws)

const WebSocket = require("ws");
const ws = new WebSocket("/stream", { headers: { Authorization: "Bearer " + process.env.API_KEY } });
ws.on("open", () => ws.send(JSON.stringify({ action: "subscribe", symbols: ["EURUSD"] })));
ws.on("message", (raw) => {
  const m = JSON.parse(raw);
  if (m.type === "quote" && m.status === "LIVE") console.log(m.symbol, m.bid, m.ask, m.time);
});
ws.on("close", (code) => console.log("closed", code));   // reconnect after a few seconds unless 4401/4402

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

من المفيد معرفته

• الأسعار هي سعرا الشراء والبيع الخاصان بالمصدر؛ ويذكر price_basis في /symbols السعر الذي تُبنى منه الأشرطة. إنها بيانات سوق إرشادية وليست مكان تنفيذ: تُنفَّذ أوامرك بأسعار وسيطك الخاص.
• الأوقات دائمًا بتوقيت UTC. والأعداد العشرية سلاسل بدقة الأداة نفسها، فلا يضيع شيء بالتقريب.
• للتاريخ (الأشرطة والتيكات) راجع نقاط النهاية أعلاه؛ يتشارك الوقت الحقيقي والتاريخ الرموز والمفاتيح نفسها.

الرسوم البيانية والمؤشرات وأدوات الرسم وتنبيهات الأسعار (الموقع)

لكل رمز رسم بياني تفاعلي مجاني على /price/<ticker>، مثل /price/EURUSD. هذه ميزات الموقع: لا تستهلك أرصدة API، ولا تحتاج إلى حساب إلا لحفظ التحليلات وضبط التنبيهات.

جديد على الرسوم البيانية؟ تعلّم كل مؤشر وأداة رسم بكلمات بسيطة: الفكرة والمعادلة وطريقة الاستخدام ومثال.

قوائم المتابعة والمقارنات والرسوم المتعددة والفلتر (الموقع)

أفكار التداول والملفات الشخصية والمتابعة (الموقع)

تطبيق الجوال (iPhone وAndroid)

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

ادعُ أصدقاءك (الإحالات)

تجد في لوحة التحكم ← ادعُ أصدقاءك رابطك الشخصي (/r/your-code؛ أضف ?next=/premium أو أي صفحة من هذا الموقع لتوجيه الناس إليها). من يفتحه وينشئ حسابًا خلال 30 يومًا يُربط بك. ولمدة 12 أشهر بعد تسجيله، يمنحك كل شحن يدفعه (عملات مشفرة على الشبكات الرئيسية أو بطاقة، بحد أدنى 5 $) نسبة 20%. ينتظر الاسترداد النقدي 14 أيام تحسبًا لأي استرجاع، ثم يُضاف إلى رصيدك: أنفقه على أرصدة API أو الخطط أو Chart Premium. يمكنك أيضًا صرفه (عملات مستقرة أو PayPal) ابتداءً من 50 $، بتأكيد عبر البريد ومراجعة من فريقنا. لا تُحتسب دعوة نفسك أو حساب ثانٍ لك، وهناك حد شهري لكل داعٍ.

برنامج الشركاء (الوسطاء والمعلّمون)

تمنح الشركات عملاءها Chart Premium: قدّم طلبك من لوحة التحكم ← الشريك؛ وبعد الموافقة تحصل على معرّف شريك و5 مقاعد تجريبية مجانية (14 يوم Pro لكل منها). تُشترى المقاعد في حزم (10, 50, 250) بخصم 30%، لـ Pro أو Pro+ ولمدة 1 أو 3 أو 6 أو 12 شهرًا لكل منها، من رصيدك. يصبح كل مقعد رمز تفعيل لمرة واحدة، يُنشأ في صفحة الشريك أو عبر API الشركاء، مع مرجع عميلك الخاص إن شئت (يُحفظ مخفيًا). يمكن إلغاء الرموز غير المستخدمة فتعيد مقعدها. يُدخل العملاء الرمز في صفحة Premium.

معالج الأنماط (الموقع)

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

Chart Premium (الموقع)

الرسوم البيانية مجانية. يضيف Chart Premium مزيدًا من الأدوات الثقيلة لمدة 1 أو 3 أو 6 أو 12 شهرًا، تُدفع من الرصيد المسبق نفسه الخاص بالـ API (الفترات الأطول أرخص شهريًا).

مختبر الاستراتيجيات (الموقع)

يختبر الاستراتيجية على الرسم البياني استراتيجية تداول على الشموع السابقة للإطار الزمني الظاهر، ويعرض كل صفقة على الرسم والربح والتراجع ونسبة الربح ومنحنى رأس المال مقارنةً بالشراء والاحتفاظ. اختر استراتيجية مدمجة وغيّر مدخلاتها، أو اكتب استراتيجيتك بـ JavaScript. بعد تسجيل الدخول يمكنك الاختبار على ما يصل إلى 20,000 شمعة وحفظ ما يصل إلى 50 استراتيجية. يعمل سكربتك في متصفحك فقط، داخل بيئة معزولة لا تصل إلى الإنترنت ولا إلى حسابك ولا إلى هذا الموقع.

يشرح الدليل الكامل لوحدة الاختبار الرجعي كل إعداد ونتيجة، والمرجع الكامل للسكربت (بما فيه المؤشرات الـ 71 كلها في الكود) و11 مثالًا جاهزًا للتشغيل.

const len = input("Average period", 50, { min: 2, max: 500 });
const avg = ta.sma(close, len);
plot(avg, "SMA " + len, "#2F80ED");

function onBar(i) {
  if (avg[i] == null) return;                       // still warming up
  if (position <= 0 && close[i] > avg[i]) long({ slPct: 2 });
  if (position >= 0 && close[i] < avg[i]) short({ slPct: 2 });
}

مشاركة التحليلات والأندية

شارك تحليلًا برابط، أو اعملوا معًا في نادٍ: مساحة عمل مشتركة بدردشة ورفّ من تحليلات الرسوم البيانية.

إلى أين تُرسل التنبيهات: البريد الإلكتروني وTelegram والهاتف والمتصفح وwebhooks

# Python: check that a webhook really comes from us (Flask example)
import hashlib, hmac, time
from flask import Flask, request, abort
SECRET = b"your-webhook-secret"
app = Flask(__name__)

@app.post("/alerts")
def alerts():
    ts = request.headers.get("X-Alert-Timestamp", "")
    sig = request.headers.get("X-Alert-Signature", "").removeprefix("sha256=")
    good = hmac.new(SECRET, ts.encode() + b"." + request.get_data(), hashlib.sha256).hexdigest()
    if not hmac.compare_digest(sig, good) or abs(time.time() - int(ts or 0)) > 300:
        abort(401)
    alert = request.get_json()
    print(alert)            # your trading bot, Slack, a spreadsheet…
    return "ok"

الحدود والأخطاء (API الأسعار)

حسابك: مفاتيح API والأمان والفرق

الأرصدة والشحن والخطط

المهام

ينتظر العمل الثقيل (عمليات مسح الأنماط والدفعات الكبيرة من الرموز والتقارير الطويلة) في طابور عادل بدلًا من إبطاء الموقع. يعرض لوحة التحكم ← المهام كل مهمة مع مكانها في الطابور والوقت المتوقع؛ يمكنك مغادرة الصفحة وستُبلَّغ في لوحة التحكم (وبالبريد للمهام الطويلة) عند انتهائها. المهمة التي تفشل يُعاد تشغيلها تلقائيًا ولا تختفي بصمت أبدًا.

المساعدة والدعم

• تذاكر الدعم: راسلنا من لوحة التحكم (مع لقطات شاشة)؛ تصل الردود بالبريد الإلكتروني وعلى التذكرة.
• يجيب اسأل الذكاء الاصطناعي (زر الدردشة أسفل اليمين) عن أسئلة المنصة في أي وقت.
• يشرح قسم تعلّم كل مؤشر وأداة رسم؛ وفي المدونة دروس تعليمية؛ ويعرض سجل التغييرات الجديد.
• حالة السعر: يذكر GET /v1/prices/latest لكل سعر LIVE أو STALE أو MARKET_CLOSED (راجع حالة السعر).

تُحسب المؤشرات والرسوم في متصفحك. الرسوم البيانية والمؤشرات والتنبيهات معلومات وليست نصيحة استثمارية.