データ API

Bitcoin Lightning ノード#

Nordic Crypto は Bitcoin Lightning ノードを運営しています。エイリアスは Nordic Crypto です。実装は LND で、Neutrino のライトクライアントモードです。アカウントも API キーも不要です。

ノード	状態	実装
Bitcoin Nordic Crypto	同期中 / チャネルはまだ受け付けていません	LND（Neutrino ライトクライアントモード）

状態の行はこの静的なページに書かれており、自分では更新されません。ライブの状態: Amboss と 1ML。

ノード URI。行をコピーしてください。1 行目は IPv4 です。2 行目は同じノードの 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 キーも不要です。

サーバー	状態	ブロック高	応答時間	バージョン
Bitcoin Cash `wss://electrum-bch.nordiccrypto.no:50004`	–	–	–	–
Nexa `wss://electrum-nexa.nordiccrypto.no:20004`	–	–	–	–

このページを開くと、ブラウザが各サーバーにバージョンと最新ブロックを問い合わせます。応答時間は最新ブロックの問い合わせにかかった時間です。

標準ポートで 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 linkset、 .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）。出来高がない場合は 0 ではなく 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 はペアごとに 1 行です。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 は約 1 時間ごとに gh-pages 上の JSON を、集計ファイルとアイコンも含めて書き換えます。マーケットページはこのファイルを再読み込みし、Firi と Coinmotion はブラウザ上で直接更新します。これらの API は 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 による集計済みの訪問数とページビュー（Cookie は使いません）。/api/v1/stats.json には daily、weekly（ISO）、monthly の行があり、visits と pageviews のみを含みます。日付は UTC です。Web Analytics のサイトと更新用トークンが設定されるまで、ファイルは空です。.github/workflows/stats-refresh.yml が約 1 日に 1 回 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 は、プラットフォームの oEmbed 応答にプレーヤーが含まれる場合のみ true です。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 は「人物一覧」の ID で、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 は棒グラフ用の件数と割合です。件数が 0 の種類も含め、すべての情報源の種類が含まれます。html_url はそのニュースの当サイトのページです。url は主要メディアです。Kaupr は引き続きニュースの情報源にすぎません。

イベント#

今後と過去のイベントは /api/v1/events.json にあります。Luma のカレンダーは、各イベントソースの公開 iCal 購読 URL（ics）から取得します。Luma の都市ページ、カテゴリページ、discover API は使いません。個別の Luma イベントページは schema.org の JSON-LD として読み取ります。Eventbrite の主催者と会場は、サーバーに EVENTBRITE_TOKEN がある場合に v3 API で読み取ります。このトークンはフィードにもリポジトリにも含まれていません。トークンがない場合はイベントページの 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 Cookie が常に優先されます。

情報源のロゴ#

/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、国、翻訳がある場合は翻訳）を一覧にします。1 回の公開が 1 バッチです。ドキュメントには "apns": "not implemented" とあり、Apple Push Notification service は対象外です。iOS アプリはフィードを定期的に取得できます。Worker の URL は workers/push/ をデプロイしたときに設定され、このサイト上のパスではありません。購読情報はフィードに含まれません。この API の /api/v1/news.json が引き続き公開済みニュースの完全な一覧です。

エンドポイント#

どのエンドポイントも、静的な JSON ファイルへの単純な GET です。

パス	返す内容
`/api/v1/index.json`	Discovery document: every endpoint, with example URLs.
`/api/v1/news.json`	Published news and our own stories, newest first.
`/api/v1/news/latest.json`	The 25 newest published stories with id, published, country, source and headlines only. For apps and notifiers that poll often; news.json is the full list.
`/api/v1/news/by-country/{country}.json`	Published news for one country code: NO, SE, DK, FI, IS, NORDIC or EU.
`/api/v1/news/topics.json`	Topic ids present in the published news, with counts.
`/api/v1/newsletters.json`	Published newsletter issues, newest first. The list omits the HTML body; the issue URL includes text and html.
`/api/v1/events.json`	Public events, soonest start first, including past events.
`/api/v1/events/upcoming.json`	Events that have not ended, soonest first. Judged in the event's own offset.
`/api/v1/events/past.json`	Finished public events, newest first. Finished events stay in the archive.
`/api/v1/events/previous.json`	Previous events, newest finish first. Finished calendar events plus backfilled public events (source backfill). Backfill is not on the calendar or in upcoming or past.
`/api/v1/events/by-country/{country}.json`	Public events for one country code.
`/api/v1/talks.json`	Public talks on bitcoin, cryptocurrencies and blockchain in the Nordic countries, newest first. A player is embedded on the site only when embed is true (YouTube via youtube-nocookie.com, or the Vimeo player). Unknown fields are null. description is ours; title and the other details come from the platform.
`/api/v1/talks/by-country/{country}.json`	Public talks for one country code: NO, SE, DK, FI, IS, FO (Faroe Islands), GL (Greenland) or AX (Åland).
`/api/v1/sources.json`	News outlets, justice-system press pages, the public search terms, and event sources. coverage is national, regional, local or justice. region is the place. feed is null when no working RSS, sitemap or index page was verified. method is rss, html, sitemap, search or manual. Event sources name the intake method. Luma calendars use a public iCal subscribe URL. Eventbrite organizers and venues use the v3 API when the server has EVENTBRITE_TOKEN; the token is not in this feed. Without it, event pages are schema.org JSON-LD. icon_url is a public icon from the outlet when one was easy to find. logo_source is the URL the stored logo was fetched from. logo is the checked outlet image for that source id when one is on file, used only to identify the source. Kaupr is marked as a news source only and is never an event sponsor.
`/api/v1/academia.json`	Editor-approved courses, student groups, publications and research.
`/api/v1/academia/courses.json`	Academia section: courses.
`/api/v1/academia/groups.json`	Academia section: groups.
`/api/v1/academia/publications.json`	Academia section: publications.
`/api/v1/academia/research.json`	Academia section: research.
`/api/v1/academia/{id}.json`	One academia row. The id is in academia.json.
`/api/v1/books.json`	Published books on bitcoin, crypto and blockchain by Nordic authors or about the Nordic countries. title is the original title. authors are as printed; author_role is "editors" for an edited volume. language is a code (nn, nb, sv, da, fi, en). source is the library catalogue or publisher page where the row was checked. about is our one-line description in English. No cover images.
`/api/v1/developers.json`	Open-source developers: technical people in Nordic crypto with public crypto-related code (an own non-fork crypto repo, or merged commits or pull requests in a public crypto project). name is as shown on the code profile. profiles are the GitHub/GitLab/Codeberg/sourcehut profile links. notable has up to three items: kind "repo" (own repo: name, url, stars, language, description, last_push) or kind "contrib" (project, host, url, commits, merged_prs). Stars and counts are from the date in checked. nordic_source is where the Nordic link is shown. whoswho_id links the who's who entry. Only rows the editor approved; a preview build also has pending rows (status "pending").
`/api/v1/orgchart.json`	Published who's who: organisations, people, relations, regulation notes and caveats. A person named on a talk has talk_ids, event_ids and talks. affiliations lists the organisation the talk page stated for that talk, with the talk date when the page gave one, the source URL and the retrieval time. An affiliation the page did not state is omitted.
`/api/v1/orgchart/relations.json`	Relations between published who's who entries.
`/api/v1/orgchart/regulation.json`	Short regulation status for each Nordic country, as on the who's who page.
`/api/v1/orgchart/relations/{id}.json`	One relation from the who's who.
`/api/v1/profiles.json`	Public profile links (Wikipedia, X, Wikidata and similar) for people and organisations.
`/api/v1/images.json`	Logos and photos used on the public who's who, with licence and credit. These are not newspaper photographs.
`/api/v1/illustrations.json`	Pictures used on story cards and story pages. Each record has source, author, license and url. No photograph from another newspaper is included. Outlet logos are in images.json and on each news item as source_logo.
`/api/v1/changelog.json`	Site changelog (product changes, not the news), newest first.
`/api/v1/rules.json`	How EU crypto rules become law in the five countries. Simplified, not legal advice. Omitted while the page is still a placeholder.
`/api/v1/archive/articles.json`	Append-only archive of stories that have been on the public site. removed is true when a story later left the site; the row stays.
`/api/v1/stats.json`	Aggregate visitor counts from Cloudflare Web Analytics (no cookies): visits and page views per UTC day, ISO week and calendar month. updated_at is null and the lists are empty until the Web Analytics site and the refresh token are configured.
`/api/v1/markets.json`	Nordic exchange prices. Market data, not investment advice. Each ticker names the exchange, fetched_at, the source URL and volume when the exchange published it. NOK, SEK, DKK and EUR only. aggregated is one row per pair.
`/api/v1/markets/aggregated.json`	One price per base-quote pair. BTC-NOK is separate from BTC-EUR. last is the mean of published last prices. mid is the mean of bid/ask midpoints and is not blended into last. Volume is summed only within the same field and the same pair. logo_url is a CC0 icon when cryptocurrency-icons includes the asset, otherwise null.
`/api/v1/markets/{exchange}.json`	Prices from one included exchange: firi (Norway), nbx (Norway) or coinmotion (Finland).
`/api/v1/markets/by-asset/{symbol}.json`	Prices for one asset (the base symbol, such as BTC) on every included Nordic exchange, plus aggregated pairs for each quote currency and logo_url when an icon is available.
`/api/v1/languages.json`	Site UI languages: code, native name, English name, rtl, html lang and home URL.
`/api/v1/geo-language.json`	Country to default site language. An IP guess only; the nc_lang cookie from the language switcher wins.
`/api/v1/meta.json`	Site name, languages, countries, page list, CORS, editorial notes and brand social accounts (social.telegram, social.x).

含まれないもの#

下書き、編集キュー、却下されたニュース、読者からの情報提供、ニュースレター購読者のアドレス、アナリティクスのトークン、非公開の個人情報はこのフィードに含まれません。不明な ID にはサイトの通常の 404 が返り、JSON のエラーではありません。

バージョン 1 のフィールド名は変わりません。新しいフィールドが追加されることはあります。互換性のない変更には新しいパスを使います。

Nordic Crypto データ API