התחלה מהירה עם ה-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) ואת מרווח ה-bid-ask, ופג כדקה אחרי החתימה. לפידים יש מזהים קבועים (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). CFD על מניות ו-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 בשרת שלכם או בבוט. לעולם אל תשימו אותו בדפי אינטרנט או באפליקציות שאחרים יכולים לפתוח: כל מי שיש לו את המפתח יכול לבזבז את היתרה שלכם.

טוב לדעת

• המחירים הם ה-bid וה-ask של המקור עצמו; 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, אבטחה וצוותים

קרדיטים, טעינות ותוכניות

משימות

עבודה כבדה (סריקות תבניות, אצוות גדולות של קודים, דוחות ארוכים) ממתינה בתור הוגן במקום להאט את האתר. לוח בקרה ← משימות מציג כל אחת עם המקום שלה בתור והזמן הצפוי; אפשר לעזוב את העמוד, ותקבלו הודעה בלוח הבקרה (ובאימייל לארוכות) כשהיא מסתיימת. משימה שנכשלת מנוסה שוב אוטומטית ולעולם לא נעלמת בשקט.

עזרה ותמיכה

• פניות תמיכה: כתבו לנו מלוח הבקרה (עם צילומי מסך); התשובות מגיעות באימייל ובפנייה.
• לשאול את ה-AI (כפתור הצ'אט בפינה הימנית התחתונה) עונה על שאלות על הפלטפורמה בכל עת.
• למידה מסביר כל אינדיקטור וכלי שרטוט; בבלוג יש מדריכים; יומן השינויים מפרט מה חדש.
• סטטוס של מחיר: GET /v1/prices/latest מציין LIVE, STALE או MARKET_CLOSED לכל ציטוט (ראו סטטוס מחיר).

אינדיקטורים ושרטוטים מחושבים בדפדפן שלכם. גרפים, אינדיקטורים והתראות הם מידע, לא ייעוץ השקעות.