Nordic Crypto ڈیٹا API

Bitcoin Lightning نوڈ#

Nordic Crypto ایک Bitcoin Lightning نوڈ چلاتا ہے۔ عرفی نام Nordic Crypto ہے۔ نفاذ LND ہے، Neutrino لائٹ کلائنٹ موڈ میں۔ نہ اکاؤنٹ، نہ API کلید۔

حیثیت کی سطر اس جامد صفحے میں لکھی ہے اور خود نہیں بدلتی۔ براہ راست حیثیت: Amboss اور 1ML۔

نوڈ URI۔ ایک سطر نقل کریں۔ پہلی سطر IPv4 ہے۔ دوسری سطر وہی نوڈ IPv6 پر ہے، [2a01:4f8:c01e:36d9::1]:9735۔

0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9@91.99.122.75:9735
0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9@[2a01:4f8:c01e:36d9::1]:9735

عوامی کلید۔

0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9

آن چین جمع کا پتا۔

bc1p7zgqhev2zzn45mefzq59gq983379lr0rsymhl558rza9k05y7vsq9mglx7

Electrum سرورز (BCH اور Nexa)#

Nordic Crypto، Bitcoin Cash اور Nexa کے لیے Rostrum Electrum سرورز چلاتا ہے۔ والیٹس اور ایپس ان سے بیلنس، ٹرانزیکشنز، UTXO، ٹوکن اور تازہ ترین بلاک پڑھ سکتی ہیں، اور ٹرانزیکشنز نشر کر سکتی ہیں۔ نہ اکاؤنٹ، نہ API کلید۔

یہ صفحہ کھلتے ہی آپ کا براؤزر ہر سرور سے اس کا ورژن اور تازہ ترین بلاک پوچھتا ہے۔ جوابی وقت تازہ ترین بلاک کی درخواست میں لگنے والا وقت ہے۔

یہ معیاری پورٹس پر Electrum پروٹوکول (JSON-RPC) استعمال کرتے ہیں: TLS کے ساتھ WebSocket (wss) Nexa کے لیے 20004 اور Bitcoin Cash کے لیے 50004 پر، اور TCP پر TLS، Nexa کے لیے 20002 اور Bitcoin Cash کے لیے 50002 پر۔ غیر خفیہ کردہ پورٹس دستیاب نہیں۔ کلائنٹ لائبریری میں ہوسٹ، پورٹ اور اسکیم (wss یا tcp_tls) درج کریں۔ میتھڈز کی فہرست Rostrum پروٹوکول دستاویزات میں ہے۔

websocat wss://electrum-bch.nordiccrypto.no:50004
{"id":1,"method":"blockchain.headers.subscribe","params":[]}

یہ سرورز اپنے فل نوڈز (Bitcoin Cash Node اور Nexa) چلاتے ہیں، اس لیے ان کے جوابات کسی تیسرے فریق پر منحصر نہیں۔ جو کلائنٹ SPV جانچ نہیں کرتا، وہ چین کے مواد کے بارے میں پھر بھی ہم پر بھروسا کرتا ہے۔ اپ ٹائم کی کوئی ضمانت نہیں۔ اپنی فہرست میں ایک دوسرا سرور رکھیں، اور اگر کوئی چند سیکنڈ میں جواب نہ دے تو اس پر منتقل ہو جائیں۔

یہاں سے شروع کریں#

• فہرستِ مضامین — تمام اینڈ پوائنٹس اور مثالی URL۔
• OpenAPI (نیز YAML).
• llms.txt — سادہ زبان میں ہدایات۔
• API کیٹلاگ (RFC 9727 لنک سیٹ؛ .json نقل).

خبریں اور ایک نیوز لیٹر حاصل کریں#

curl -fsS https://nordiccrypto.no/api/v1/news.json
curl -fsS https://nordiccrypto.no/api/v1/newsletters.json
curl -fsS https://nordiccrypto.no/api/v1/newsletters/002.json

مکمل URL عوامی سائٹ کے ڈومین روٹ سے بنتے ہیں: https://nordiccrypto.no/api/v1/news.json۔

نئی خبریں پوچھنا#

/api/v1/news/latest.json میں تازہ ترین شائع شدہ 25 خبریں ہیں، صرف id, published, country, source, source_name, language_code, own_story، سرخیاں (title, title_en, title_i18n) اور ربط (url, html_url, api_url) کے ساتھ۔ قدریں news.json جیسی ہیں، اسی ترتیب میں (تازہ ترین پہلے)۔ مجموعہ جتنا بھی بڑھے، یہ فائل چھوٹی رہتی ہے، تاکہ کوئی ایپ یا پش سرور ہر چند منٹ بعد پوچھ سکے۔ آخری ETag کے ساتھ If-None-Match بھیجیں؛ فائل نہ بدلی ہو تو GitHub Pages 304 Not Modified جواب دیتا ہے۔ id کا موازنہ ان سے کریں جو آپ دیکھ چکے ہیں؛ generated_at ہر بلڈ پر بدلتا ہے۔

curl -fsS https://nordiccrypto.no/api/v1/news/latest.json

مارکیٹ کی قیمتیں#

نارڈک ایکسچینجز کی قیمتیں مارکیٹ ڈیٹا ہیں، سرمایہ کاری کا مشورہ نہیں۔ /api/v1/markets.json ہر جوڑی کو علامت، بیس، کوٹ، آخری قیمت، خرید و فروخت کی قیمت (جب ایکسچینج انہیں شائع کرے)، ایکسچینج کی id، نام اور ملک، fetched_at، ماخذ URL اور حجم (جب ایکسچینج نے شائع کیا ہو) کے ساتھ دکھاتا ہے۔ volume_base بیس اثاثے میں حجم ہے، کسی متعین وقت کے بغیر (Firi)۔ volume_base_24h اور volume_quote_24h پچھلے 24 گھنٹوں کے ہیں (NBX)۔ غیر موجود حجم null ہے، صفر نہیں۔ کوٹ کرنسیاں NOK، SEK، DKK اور EUR ہیں۔ ایک ایکسچینج: /api/v1/markets/{exchange}.json (firi، nbx، coinmotion)۔ ایک اثاثہ: /api/v1/markets/by-asset/{symbol}.json۔ جن پلیٹ فارمز کا عوامی ٹِکر نہیں، وہ skipped میں درج ہیں اور انہیں کوئی من گھڑت قیمت نہیں دی جاتی۔

/api/v1/markets/aggregated.json میں ہر جوڑی کی ایک قطار ہے۔ BTC-NOK کا اوسط BTC-EUR کے ساتھ نہیں نکالا جاتا۔ last شائع شدہ آخری قیمتوں کا حسابی اوسط ہے۔ mid ‏(bid+ask)/2 کا اوسط ہے اور اسے last میں نہیں ملایا جاتا۔ اگر کوئی آخری قیمت موجود ہو تو price برابر last ہے، ورنہ mid۔ min اور max یہی سلسلہ استعمال کرتے ہیں۔ کوئی VWAP نہیں۔ حجم صرف ایک ہی فیلڈ اور ایک ہی جوڑی کے اندر جمع کیا جاتا ہے۔ logo_url ‏cryptocurrency-icons (CC0 1.0) کا SVG ہے، اگر اس سیٹ میں وہ اثاثہ ہو؛ یہ /api/v1/markets/logos/{symbol}.svg پر ملتا ہے، ورنہ null ہے۔ ہر اثاثے کی فائل aggregated اور لوگو دہراتی ہے۔

بلڈ ایکسچینجز سے ڈیٹا لاتا ہے۔ .github/workflows/markets-refresh.yml تقریباً ہر گھنٹے gh-pages پر JSON دوبارہ لکھتا ہے، مجموعی فائل اور آئیکنز سمیت۔ مارکیٹ صفحہ یہ فائل دوبارہ لوڈ کرتا ہے اور Firi اور Coinmotion کو براؤزر ہی میں تازہ کرتا ہے، کیونکہ ان کی APIs ‏Access-Control-Allow-Origin: * بھیجتی ہیں۔ NBX ایسا نہیں کرتا، اس لیے اس کی قطاریں فائل کے مطابق رہتی ہیں۔ gh-pages برانچ پر یہی دستاویز: raw.githubusercontent.com/jQrgen/nordic-crypto/gh-pages/api/v1/markets.json۔

curl -fsS https://nordiccrypto.no/api/v1/markets.json
curl -fsS https://nordiccrypto.no/api/v1/markets/aggregated.json

وزیٹر کے اعداد و شمار#

Cloudflare Web Analytics سے مجموعی وزٹس اور صفحات کے مناظر (کوکیز کے بغیر)۔ /api/v1/stats.json میں daily، weekly (ISO) اور monthly قطاریں ہیں، جن میں صرف visits اور pageviews ہیں۔ دن UTC کے مطابق ہیں۔ جب تک Web Analytics سائٹ اور ریفریش ٹوکن ترتیب نہ دیے جائیں، فائل خالی رہتی ہے۔ .github/workflows/stats-refresh.yml اسے تقریباً روزانہ ایک بار gh-pages پر دوبارہ لکھتا ہے۔

curl -fsS https://nordiccrypto.no/api/v1/stats.json

لیکچر#

ناروے، سویڈن، ڈنمارک، فن لینڈ، آئس لینڈ، جزائر فارو، گرین لینڈ اور آلینڈ میں بٹ کوائن، کرپٹو کرنسی اور بلاک چین پر ہونے والے عوامی لیکچر /api/v1/talks.json میں ہیں، تازہ ترین پہلے۔ ایک لیکچر: /api/v1/talks/{id}.json۔ ایک ملک: /api/v1/talks/by-country/{country}.json (NO، SE، DK، FI، IS، FO، GL، AX)۔ description ہمارا لکھا ہوا ہے۔ title، تاریخیں، دورانیہ، چینل اور مقررین source_url والے پلیٹ فارم سے آتے ہیں۔ جو فیلڈ پلیٹ فارم نے نہیں بتایا، وہ null ہے۔ embed صرف تب true ہے جب پلیٹ فارم کے oEmbed جواب میں پلیئر ہو۔ HTML صفحہ کلک کے بعد ہی پلیئر لوڈ کرتا ہے: YouTube بذریعہ youtube-nocookie.com، Vimeo بذریعہ player.vimeo.com۔ جب لیکچر کسی تقریب سے منسلک ہو تو event_id اور calendar_event_id ایک ہی تقریب id ہوتے ہیں۔ وہ تقریب /api/v1/events/{id}.json پر ہے (اور گزر جانے پر /api/v1/events/previous.json میں) اور اس کا صفحہ /calendar/{id}/ ہے۔ تقریب پر talk_ids ان لیکچرز کی فہرست دیتا ہے۔ جب ویڈیو صفحے پر دن یا جگہ نہ بتائی گئی ہو تو unlink_reason سیٹ ہوتا ہے، اور تب event_id ‏null ہوتا ہے۔ speaker_ids ’’کون کیا ہے‘‘ کی ids ہیں، اسی ترتیب میں جیسے speakers۔ شخص کا صفحہ، /api/v1/orgchart/{id}.json پر، ان لیکچرز اور لیکچر کے صفحے پر بتائی گئی کسی بھی وابستگی کی فہرست دیتا ہے۔

کئی میڈیا، ایک خبر#

ہر خبر کا ایک بنیادی میڈیا ہوتا ہے۔ اسی واقعے کی کوریج کرنے والے دوسرے میڈیا also_covered_by میں ہیں۔ sources پہلے بنیادی میڈیا اور پھر باقی کو درج کرتا ہے۔ ہر میڈیا کے پاس outlet، outlet_name، url، title (اس میڈیا کی سرخی)، published، lang، country، source_type اور logo ہیں۔ source_type کی قدر national، regional (علاقائی اور مقامی)، official (عدالتی اور سرکاری: پولیس، استغاثہ، عدالتیں، ریگولیٹرز) یا international ہوتی ہے۔ coverage.count میڈیا کی تعداد ہے۔ coverage.by_country اور coverage.by_source_type بار چارٹ کے لیے تعداد اور حصے ہیں۔ ہر قسم کا ماخذ موجود رہتا ہے، صفر تعداد کے ساتھ بھی۔ html_url اس خبر کا ہمارا صفحہ ہے۔ url بنیادی میڈیا ہے۔ Kaupr صرف ایک خبری ماخذ ہی رہتا ہے۔

تقریبات#

آنے والی اور گزشتہ تقریبات /api/v1/events.json میں ہیں۔ Luma کیلنڈر ہر تقریب کے ماخذ کے عوامی سبسکرائب iCal URL (ics) سے لیے جاتے ہیں۔ Luma کے شہر صفحات، زمرہ صفحات اور discover API استعمال نہیں ہوتے۔ Luma کا انفرادی تقریب صفحہ schema.org JSON-LD کے طور پر پڑھا جاتا ہے۔ Eventbrite کے منتظمین اور مقامات v3 API سے پڑھے جاتے ہیں، جب سرور کے پاس EVENTBRITE_TOKEN ہو۔ وہ ٹوکن اس فیڈ میں نہیں اور ریپوزیٹری میں بھی محفوظ نہیں۔ اس کے بغیر تقریب کے صفحے کا JSON-LD استعمال ہوتا ہے۔ ایک ہی عنوان، تاریخ اور مقام کا مطلب ایک تقریب ہے۔ ختم شدہ تقریبات فیڈ میں رہتی ہیں۔ description.text منتظم کے اپنے الفاظ ہیں، description.lang اس متن کی زبان ہے، اور description.source_url وہ صفحہ ہے جہاں سے یہ آیا۔ جہاں ہمارے پاس ترجمہ ہو، وہ description.i18n میں ہے۔ اگر ماخذ میں تفصیل نہ ہو تو یہ فیلڈ null ہے۔ جعلی (پریڈیٹری) کانفرنسوں کی فہرستیں ماخذ نہیں مانی جاتیں۔ Kaupr کبھی اسپانسر نہیں ہوتا۔

زبانیں#

انگریزی ڈیفالٹ فیلڈ ہے (summary، title، text)۔ ہمارے شائع کردہ ترجمے summary_i18n، title_i18n، subtitle_i18n، note_i18n، text_i18n اور about_i18n میں nn، nb، sv، da، fi اور is کلیدوں کے ساتھ ہیں۔ سائٹ کی دوسری زبانیں ترجمہ شائع ہونے تک انگریزی فیلڈ استعمال کرتی ہیں۔ کسی خبر میں title ماخذ کی سرخی ہی رہتی ہے، title_en ہماری انگریزی سرخی ہے اور title_i18n سائٹ کی نارڈک زبانوں میں ہماری سرخی ہے۔ دونوں مختلف ہوں تو صفحات پہلے صفحے کی زبان والی سرخی اور اس کے نیچے ماخذ کی سرخی دکھاتے ہیں۔ sources کے اندر ہر میڈیا کی اپنی سرخی اسی میڈیا کی زبان میں رہتی ہے۔ تاریخیں ISO 8601 کے مطابق ہیں۔

/api/v1/languages.json سائٹ کی ہر زبان کو code، native_name، english_name، rtl، html_lang اور home کے ساتھ درج کرتا ہے۔ /api/v1/geo-language.json ملک سے زبان کا اندازہ ہے، جو پہلی بار آنے پر استعمال ہوتا ہے۔ IP کا ملک tipworker کے GET /api/geo ‏(Cloudflare request.cf.country) سے آتا ہے۔ کچھ بھی محفوظ نہیں کیا جاتا۔ زبان منتخب کنندہ کی سیٹ کردہ nc_lang کوکی کو ہمیشہ ترجیح ملتی ہے۔

ماخذ کے لوگو#

/api/v1/sources.json میں ہر میڈیا کے پاس logo_url (مکمل PNG یا WebP URL، کبھی SVG نہیں، یا null) اور logo (kind، file_url (اصل فائل، SVG یا WebP)، raster_url (logo_url جیسا)، source_url، author، license، license_url، credit، یا null) ہے۔ ہر خبر میں source_logo_url ہے، تاکہ ایپ سرخی کے ساتھ میڈیا کا لوگو دکھا سکے۔ لوگو Wikimedia Commons (لائسنس کے ساتھ) یا ناشر کی اپنی سائٹ سے آتے ہیں۔ یہ ناشرین کے ٹریڈ مارک ہیں اور صرف سرخی کا ماخذ پہچاننے کے لیے دکھائے جاتے ہیں۔ ایڈیٹر کے جانچنے تک لوگو null رہتا ہے۔

CORS#

GitHub Pages ان فائلوں کے ساتھ Access-Control-Allow-Origin: * بھیجتا ہے، اس لیے کسی دوسری سائٹ کا صفحہ انہیں fetch() سے حاصل کر سکتا ہے۔ GitHub Pages اپنی مرضی کی ہیڈر فائل لاگو نہیں کرتا۔ .json والا فائل نام استعمال کریں؛ فولڈر کھولنے پر JSON نہیں ملتا۔

ادارتی پالیسی#

دستخط The Nordic Crypto team ہے۔ Kaupr ‏(kaupr.io) صرف ایک خبری ماخذ ہے اور کبھی اسپانسر نہیں ہوتا۔ یہاں کچھ بھی سرمایہ کاری کا مشورہ نہیں۔

برانڈ اکاؤنٹس#

/api/v1/meta.json میں ios، Nordic Crypto iOS ایپ کا عوامی TestFlight دعوت نامہ ہے۔ یہ App Store پر موجود نہیں۔ apple_tv بتاتا ہے کہ TestFlight ورژن خاص طور پر Apple TV کو سپورٹ کرتا ہے۔ apple_tv_i18n میں یہ مختصر جملہ سائٹ کی ہر زبان میں ہے۔ برانڈ کا نام ہمیشہ Nordic Crypto ہی رہتا ہے۔

/api/v1/meta.json میں iOS ایپ کے لیے social شامل ہے۔ social.telegram، Nordic Crypto چیٹ ہے: https://t.me/nordiccryptochat۔ social.x برانڈ اکاؤنٹ ہے: https://x.com/nordiccryptobot (@nordiccryptobot)، جو urls.x میں بھی درج ہے۔ urls.telegram چیٹ کا URL دہراتا ہے۔ urls.rss انگریزی خبروں کی فیڈ ہے: /rss.xml۔ ہر زبان کے ہوم صفحے کی اپنی rss.xml ہے۔ urls.newsletter اس سائٹ کا سائن اپ صفحہ ہے۔ label مختصر نام ہے (Telegram، X)۔ name انگریزی لنک کا متن ہے۔ name_i18n میں nn، nb، sv، da، fi اور is ہیں۔ سائٹ کی دوسری زبانیں name استعمال کرتی ہیں۔

براؤزر اطلاعات#

جب workers/push/public.json میں Worker URL ہو تو ہر صفحے کے نیچے کا بٹن Web Push ہوتا ہے۔ تب تک صفحہ بتاتا ہے کہ سروس فعال نہیں، اور کسی Worker کو کال نہیں کرتا۔ سبسکرپشنز Cloudflare Worker پر رہتی ہیں، اس جامد فیڈ میں نہیں۔ ہر اشاعت کے بعد اس Worker پر GET /api/push/feed.json وہی بیچ دکھاتا ہے (عنوان، مختصر خلاصہ، URL، ملک، اور ترجمے جب دستیاب ہوں)۔ ایک اشاعت ایک بیچ ہے۔ دستاویز میں "apns": "not implemented" لکھا ہے: Apple Push Notification service دائرے سے باہر ہے۔ iOS ایپ وقتاً فوقتاً فیڈ چیک کر سکتی ہے۔ Worker URL تب سیٹ ہوتا ہے جب workers/push/ ڈیپلائے ہو؛ یہ اس سائٹ کا پاتھ نہیں۔ سبسکرپشنز فیڈ میں نہیں۔ اس API کا /api/v1/news.json شائع شدہ خبروں کی مکمل فہرست رہتا ہے۔

اینڈ پوائنٹس#

ہر اینڈ پوائنٹ کسی جامد JSON فائل کا سادہ GET ہے۔

شامل نہیں#

مسودے، ادارتی قطار، مسترد خبریں، قارئین کی اطلاعات، نیوز لیٹر کے سبسکرائبرز کے پتے، اینالیٹکس ٹوکن اور نجی ذاتی ڈیٹا اس فیڈ میں نہیں۔ نامعلوم id پر سائٹ کا عام 404 ملتا ہے، JSON خرابی نہیں۔

ورژن 1 کے فیلڈ نام برقرار رہیں گے۔ نئے فیلڈ آ سکتے ہیں۔ غیر مطابق تبدیلی کے لیے نیا پاتھ استعمال ہوگا۔