API क्विक स्टार्ट

क्रेडिट की कीमत: $0.001 (साइन-अप पर 1000 मुफ़्त क्रेडिट)। बेस URL 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), ऑन-चेन FX, स्टेबलकॉइन भुगतान और सिंथेटिक एसेट के लिए। आपका ऐप एक हस्ताक्षरित कीमत रिपोर्ट लेता है; आपका कॉन्ट्रैक्ट उसे हमारे वेरिफ़ायर कॉन्ट्रैक्ट को देता है, जो ऑन-चेन हस्ताक्षर जाँचता है। रास्ते में कीमत जाली नहीं बनाई जा सकती, और किसी को संदेशवाहक पर भरोसा नहीं करना पड़ता।

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) से सत्यापित कीमत पढ़ें। यह केवल maxAge से नई लाइव कीमत (बाज़ार OPEN) लौटाता है।

हर रिपोर्ट बाज़ार की स्थिति (OPEN, CLOSED, HALTED) और बिड-आस्क स्प्रेड बताती है, और हस्ताक्षर के लगभग एक मिनट बाद समाप्त हो जाती है। फ़ीड की तय ID होती हैं (keccak256("XAUUSD")), सर्किट ब्रेकर असामान्य उछाल रोकते हैं, और Chainlink-संगत एडैप्टर (latestRoundData) उपलब्ध है। हमारे रिलेयर द्वारा पहले से ऑन-चेन रखी गई कीमतें मुफ़्त पढ़ी जा सकती हैं।

ओरेकल दस्तावेज़ फ़ीड, नेटवर्क और कॉन्ट्रैक्ट

मुफ़्त टियर (बिना की)

बिना खाते के API आज़माएँ: प्रति IP पता प्रति मिनट 10 अनुरोध और प्रति दिन 1000, प्रति अनुरोध 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 होता है जो केवल एक बात बताता है: कीमत कितनी ताज़ा है।

केवल LIVE कीमतें पाने के लिए require_live=true जोड़ें; बाहर रखे गए सिंबल का शुल्क नहीं लगता। हर माँगा गया टिकर ठीक एक सूची में आता है: data (कीमत है), no_data (ज्ञात टिकर, अभी कीमत नहीं) या unknown (उपलब्ध नहीं)।

ट्रेडिंग समय। फ़ॉरेक्स, धातु और ज़्यादातर इंडेक्स रविवार शाम से शुक्रवार शाम (UTC) तक ट्रेड होते हैं। शेयर और ETF CFD अपने एक्सचेंज के नियमित सत्र को स्थानीय समय में, डेलाइट सेविंग के साथ, मानते हैं: न्यूयॉर्क 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 मिलता है।

रियल-टाइम कीमतें (ट्रेडिंग बॉट, डैशबोर्ड)

सबसे ताज़ा कीमत पाने के दो तरीके। दोनों वही कोट्स देते हैं; अपने प्रोग्राम के काम करने के तरीके से चुनें।

कीमत कितनी ताज़ा है?

जिन सिंबल को आप स्ट्रीम कर रहे हैं, या जिन्हें आपने पिछले 5 मिनट में /prices/latest से माँगा है, वे स्रोत से लगभग हर सेकंड रिफ़्रेश होते हैं (सभी ग्राहकों में एक समय में ऐसे सिंबल तक)। बाकी सभी सिंबल पृष्ठभूमि में लगातार, पर कम बार, रिफ़्रेश होते हैं। इसलिए: जिन सिंबल में आप ट्रेड करते हैं उन्हें माँगें या सब्सक्राइब करें, और वे तेज़ हो जाते हैं।

हर कोट में time होता है, वह क्षण जब स्रोत ने उसे बनाया (UTC), और एक status। ट्रेडिंग प्रोग्राम को हमेशा दोनों जाँचने चाहिए:

• REST कॉल पर require_live=true इस्तेमाल करें: केवल 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 प्रोटोकॉल

हेडर Authorization: Bearer <your key> (स्कोप read:latest) के साथ /stream से जुड़ें। फिर 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 बहुत ज़्यादा खुले कनेक्शन। सर्वर हर 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 की अपने सर्वर या बॉट में रखें। इसे कभी ऐसे वेब पेज या ऐप में न डालें जिन्हें दूसरे खोल सकें: जिसके पास की है वह आपका बैलेंस खर्च कर सकता है।

जानने योग्य

• कीमतें स्रोत की अपनी बिड और आस्क हैं; /symbols में price_basis बताता है कि बार किस कीमत से बनाए जाते हैं। ये सांकेतिक बाज़ार डेटा हैं, निष्पादन स्थल नहीं: आपके ऑर्डर आपके अपने ब्रोकर की कीमतों पर भरते हैं।
• समय हमेशा UTC में। दशमलव इंस्ट्रूमेंट की अपनी परिशुद्धता वाली स्ट्रिंग हैं, इसलिए पूर्णांकन से कुछ नहीं खोता।
• इतिहास (बार और टिक) के लिए ऊपर के एंडपॉइंट देखें; रियल-टाइम और इतिहास एक ही सिंबल और की साझा करते हैं।

चार्ट, इंडिकेटर, ड्रॉइंग टूल और कीमत अलर्ट (वेबसाइट)

हर टिकर का मुफ़्त इंटरैक्टिव चार्ट /price/<ticker> पर है, जैसे /price/EURUSD। ये वेबसाइट की सुविधाएँ हैं: इनमें कोई API क्रेडिट नहीं लगता, और खाता केवल विश्लेषण सहेजने और अलर्ट लगाने के लिए चाहिए।

चार्ट में नए हैं? हर इंडिकेटर और ड्रॉइंग टूल सरल शब्दों में सीखें: विचार, सूत्र, इस्तेमाल का तरीका और एक उदाहरण।

वॉचलिस्ट, तुलना, मल्टी-चार्ट और स्क्रीनर (वेबसाइट)

ट्रेडिंग आइडिया, प्रोफ़ाइल और फ़ॉलो (वेबसाइट)

मोबाइल ऐप (iPhone और Android)

अपने खाते से साइन इन करें और पाएँ: लाइव कीमतों वाली आपकी वॉचलिस्ट, पूरा चार्ट (हर इंडिकेटर, ड्रॉइंग टूल और पैटर्न विज़ार्ड, आपके सहेजे विश्लेषणों के साथ), फ़ोन सूचनाओं के रूप में कीमत अलर्ट (अलर्ट पर push टिक करें; ऐप में खाता के अंतर्गत सूचनाएँ चालू करें) और समुदाय के आइडिया। दो-चरणीय साइन-इन वेबसाइट की तरह काम करता है। जिस भी फ़ोन पर आप साइन इन करते हैं वह खाता में सूचीबद्ध होता है, जहाँ आप उसे साइन आउट कर सकते हैं; नया पासवर्ड हर फ़ोन को साइन आउट करता है। प्लान और टॉप-अप इस वेबसाइट पर संभाले जाते हैं। आप अपना खाता ऐप में या यहाँ खाता में हटा सकते हैं।

दोस्तों को आमंत्रित करें (रेफ़रल)

डैशबोर्ड → दोस्तों को आमंत्रित करें में आपका निजी लिंक मिलता है (/r/your-code; लोगों को वहाँ भेजने के लिए ?next=/premium या इस साइट का कोई भी पेज जोड़ें)। जो इसे खोलकर 30 दिनों के भीतर खाता बनाता है, वह आपसे जुड़ जाता है। उसके साइन-अप के बाद 12 महीनों तक, वह जो भी टॉप-अप चुकाता है (मुख्य नेटवर्क पर क्रिप्टो या कार्ड, कम से कम $5) उस पर आपको 20% मिलता है। रिफ़ंड की स्थिति के लिए कैशबैक 14 दिन रुकता है, फिर आपके बैलेंस में जुड़ता है: इसे API क्रेडिट, प्लान या Chart Premium पर खर्च करें। आप इसे $50 से भुगतान के रूप में भी ले सकते हैं (स्टेबलकॉइन या PayPal), ईमेल से पुष्ट और हमारी टीम द्वारा जाँचा गया। ख़ुद को या अपने दूसरे खाते को आमंत्रित करना नहीं गिना जाता, और हर आमंत्रित करने वाले की मासिक सीमा है।

पार्टनर प्रोग्राम (ब्रोकर और शिक्षक)

व्यवसाय अपने ग्राहकों को Chart Premium देते हैं: डैशबोर्ड → पार्टनर में आवेदन करें; स्वीकृति के बाद आपको पार्टनर ID और 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, फ़ोन, ब्राउज़र और वेबहुक

# 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 बताता है (देखें कीमत स्थिति)।

इंडिकेटर और ड्रॉइंग आपके ब्राउज़र में गणना किए जाते हैं। चार्ट, इंडिकेटर और अलर्ट जानकारी हैं, निवेश सलाह नहीं।