Data-API från Nordic Crypto
Ett öppet JSON-flöde av webbplatsen, för appar och andra verktyg. Inget konto och ingen API-nyckel. Det genereras på nytt varje gång webbplatsen byggs.
Bitcoin Lightning-nod#
Nordic Crypto driver en Bitcoin Lightning-nod. Aliaset är Nordic Crypto. Implementationen är LND, i lättklientläge med Neutrino. Inget konto och ingen API-nyckel.
| Nod | Status | Implementation |
|---|---|---|
| Bitcoin Nordic Crypto | synkar / tar inte emot kanaler ännu | LND (Neutrino lättklient) |
Nod-URI. Kopiera en rad. Första raden är IPv4. Andra raden är samma nod på IPv6, [2a01:4f8:c01e:36d9::1]:9735.
0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9@91.99.122.75:9735 0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9@[2a01:4f8:c01e:36d9::1]:9735
Publik nyckel.
0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9
Insättningsadress på kedjan.
bc1p7zgqhev2zzn45mefzq59gq983379lr0rsymhl558rza9k05y7vsq9mglx7
Electrum-servrar (BCH och Nexa)#
Nordic Crypto driver Rostrum-baserade Electrum-servrar för Bitcoin Cash och Nexa. Plånböcker och appar kan hämta behållningar, transaktioner, UTXO:er, tokens och senaste block från dem, och sända ut transaktioner. Inget konto och ingen API-nyckel.
| Server | Status | Blockhöjd | Svarstid | Version |
|---|---|---|---|---|
Bitcoin Cashwss://electrum-bch.nordiccrypto.no:50004 | – | – | – | – |
Nexawss://electrum-nexa.nordiccrypto.no:20004 | – | – | – | – |
De talar Electrum-protokollet (JSON-RPC) på standardportarna: WebSocket med TLS (wss) på 20004 för Nexa och 50004 för Bitcoin Cash, och TLS över TCP på 20002 för Nexa och 50002 för Bitcoin Cash. Okrypterade portar erbjuds inte. I ett klientbibliotek anger du värd, port och schema (wss eller tcp_tls). Metoderna finns i Rostrums protokolldokumentation.
websocat wss://electrum-bch.nordiccrypto.no:50004
{"id":1,"method":"blockchain.headers.subscribe","params":[]}
Servrarna kör egna fullnoder (Bitcoin Cash Node och Nexa), så svaren är inte beroende av någon tredje part. En klient som inte gör SPV-kontroller litar ändå på oss när det gäller vad kedjan innehåller. Det finns ingen garanti för drifttid. Ha en extra server i listan och gå vidare om en inte svarar inom några sekunder.
Börja här#
- Översikt — alla endpoints och exempel-URL:er.
- OpenAPI (även som YAML).
- llms.txt — instruktioner i klartext.
- API-katalog (RFC 9727-linkset; kopia som .json).
Hämta nyheter och ett nyhetsbrev#
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
Absoluta URL:er använder den publika webbplatsen, från domänroten: https://nordiccrypto.no/api/v1/news.json.
Fråga efter nya artiklar#
/api/v1/news/latest.json innehåller de 25 nyaste publicerade artiklarna, med bara id, published, country, source, source_name, language_code, own_story, rubrikerna (title, title_en, title_i18n) och länkarna (url, html_url, api_url). Värdena är desamma som i news.json, i samma ordning (nyast först). Filen förblir liten hur långt arkivet än växer, så en app eller en push-server kan fråga den med några minuters mellanrum. Skicka If-None-Match med den senaste ETag; GitHub Pages svarar 304 Not Modified så länge filen är oförändrad. Jämför id med dem du redan sett; generated_at ändras vid varje bygge.
curl -fsS https://nordiccrypto.no/api/v1/news/latest.json
Marknadspriser#
Priser från nordiska kryptobörser är marknadsdata, inte investeringsråd. /api/v1/markets.json listar varje handelspar med symbol, bas, kvot, senaste pris, köp- och säljkurs när börsen publicerar dem, börsens id, namn och land, fetched_at, käll-URL och volym när börsen har publicerat den. volume_base är bastillgången utan angivet tidsfönster (Firi). volume_base_24h och volume_quote_24h avser de senaste 24 timmarna (NBX). Saknad volym är null, inte noll. Kvotvalutorna är NOK, SEK, DKK och EUR. En börs: /api/v1/markets/{exchange}.json (firi, nbx, coinmotion). En tillgång: /api/v1/markets/by-asset/{symbol}.json. Handelsplatser utan publik ticker listas under skipped och får inget påhittat pris.
/api/v1/markets/aggregated.json har en rad per handelspar. BTC-NOK slås inte ihop med BTC-EUR. last är det aritmetiska medelvärdet av publicerade senaste priser. mid är medelvärdet av (bid+ask)/2 och blandas inte in i last. price är lika med last när något senaste pris finns, annars mid. min och max använder samma serie. Det finns ingen VWAP. Volym summeras bara inom samma fält och samma par. logo_url är en SVG från cryptocurrency-icons (CC0 1.0) när samlingen innehåller tillgången, serverad på /api/v1/markets/logos/{symbol}.svg, och annars null. Filen per tillgång upprepar aggregated och logotypen.
Bygget hämtar data från börserna. .github/workflows/markets-refresh.yml skriver om JSON-filen på gh-pages ungefär en gång i timmen, inklusive den aggregerade filen och ikonerna. Marknadssidan laddar om filen och uppdaterar Firi och Coinmotion i webbläsaren, eftersom de API:erna skickar Access-Control-Allow-Origin: *. Det gör inte NBX, så de raderna följer filen. Samma dokument på gh-pages-grenen: 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
Besöksstatistik#
Sammanlagda besök och sidvisningar från Cloudflare Web Analytics (utan kakor). /api/v1/stats.json har raderna daily, weekly (ISO) och monthly med endast visits och pageviews. Dagar räknas i UTC. Filen är tom tills Web Analytics-webbplatsen och uppdateringstoken är konfigurerade. .github/workflows/stats-refresh.yml skriver om den på gh-pages ungefär en gång om dagen.
curl -fsS https://nordiccrypto.no/api/v1/stats.json
Föredrag#
Offentliga föredrag om bitcoin, kryptovalutor och blockkedjor som hållits i Norge, Sverige, Danmark, Finland, Island, Färöarna, Grönland och Åland finns i /api/v1/talks.json, nyaste först. Ett föredrag: /api/v1/talks/{id}.json. Ett land: /api/v1/talks/by-country/{country}.json (NO, SE, DK, FI, IS, FO, GL, AX). description är skriven av oss. title, datum, längd, kanal och talare kommer från plattformen på source_url. Ett fält som plattformen inte angav är null. embed är true bara när plattformens oEmbed-svar innehåller en spelare. HTML-sidan laddar spelaren först efter ett klick: YouTube via youtube-nocookie.com, Vimeo via player.vimeo.com. event_id och calendar_event_id är samma evenemangs-id när föredraget är kopplat. Evenemanget finns på /api/v1/events/{id}.json (och /api/v1/events/previous.json när det har passerat) och sidan är /calendar/{id}/. talk_ids på evenemanget listar de föredragen. unlink_reason sätts när videosidan inte angav dag eller plats, och event_id är då null. speaker_ids är id:n från ”Vem är vem” i samma ordning som speakers. Personen, på /api/v1/orgchart/{id}.json, listar de föredragen och eventuell anknytning som föredragssidan angav.
Flera medier, en nyhet#
En nyhet har ett huvudmedium. Andra medier som bevakade samma händelse finns i also_covered_by. sources listar huvudmediet först och sedan de andra. Varje medium har outlet, outlet_name, url, title (mediets egen rubrik), published, lang, country, source_type och logo. source_type är national, regional (regionalt och lokalt), official (rättsväsende och myndigheter: polis, åklagare, domstolar, tillsynsmyndigheter) eller international. coverage.count är antalet medier. coverage.by_country och coverage.by_source_type är antal och andelar för staplarna. Alla källtyper finns med, även de med noll. html_url är vår sida för nyheten. url är huvudmediet. Kaupr är fortfarande endast en nyhetskälla.
Evenemang#
Kommande och tidigare evenemang finns i /api/v1/events.json. Luma-kalendrar hämtas från den publika iCal-adressen för prenumeration på varje evenemangskälla (ics). Lumas stadssidor, kategorisidor och discover-API används inte. En enskild evenemangssida på Luma läses som schema.org JSON-LD. Arrangörer och lokaler på Eventbrite läses med v3-API:t när servern har EVENTBRITE_TOKEN. Den token finns inte i flödet och är inte incheckad. Utan den används JSON-LD från evenemangssidan. Samma titel, datum och plats räknas som ett evenemang. Avslutade evenemang ligger kvar i flödet. description.text är arrangörens egen text, description.lang är textens språk och description.source_url är sidan den kommer från. description.i18n innehåller en översättning där vi har en. Fältet är null när källan saknade beskrivning. Listningar från oseriösa konferensarrangörer används inte som källa. Kaupr är aldrig sponsor.
Språk#
Engelska är standardfältet (summary, title, text). Översättningar som vi har publicerat finns i summary_i18n, title_i18n, subtitle_i18n, note_i18n, text_i18n och about_i18n, med nycklarna nn, nb, sv, da, fi och is. Övriga språk på webbplatsen använder det engelska fältet tills en översättning har publicerats. I en nyhet är title fortfarande källans rubrik, title_en vår engelska rubrik och title_i18n vår rubrik på de nordiska språken. Sidorna visar rubriken på sidans språk först och källans rubrik under när de skiljer sig. Varje mediums egen rubrik, i sources, står på mediets språk. Datum anges enligt ISO 8601.
/api/v1/languages.json listar alla språk på webbplatsen med code, native_name, english_name, rtl, html_lang och home. /api/v1/geo-language.json är gissningen från land till språk som används vid första besöket. Landet från IP-adressen kommer från tipworker GET /api/geo (Cloudflare request.cf.country). Inget sparas. Kakan nc_lang, som sätts av språkväljaren, vinner alltid.
Källornas logotyper#
Varje medium i /api/v1/sources.json har logo_url (absolut PNG- eller WebP-URL, aldrig SVG, eller null) och logo (kind, file_url (originalet, SVG eller WebP), raster_url (samma som logo_url), source_url, author, license, license_url, credit, eller null). Varje nyhet har source_logo_url, så att en app kan visa mediets logotyp bredvid rubriken. Logotyperna kommer från Wikimedia Commons (med licens) eller utgivarens egen webbplats. De är utgivarnas varumärken och visas bara för att identifiera källan till en rubrik. En logotyp förblir null tills redaktören har granskat den.
CORS#
GitHub Pages skickar Access-Control-Allow-Origin: * för de här filerna, så en sida på en annan webbplats kan hämta dem med fetch(). GitHub Pages tillämpar inga egna header-filer. Använd filnamnet med .json; att öppna en katalog ger inte JSON-datan.
Redaktionellt#
Avsändare är The Nordic Crypto team. Kaupr (kaupr.io) är endast en nyhetskälla och aldrig sponsor. Inget här är investeringsråd.
Varumärkets konton#
ios i /api/v1/meta.json är den publika TestFlight-inbjudan till iOS-appen från Nordic Crypto. Appen finns inte i App Store. apple_tv anger att TestFlight-versionen särskilt stöder Apple TV. apple_tv_i18n har den korta meningen på alla språk på webbplatsen. Varumärket heter alltid Nordic Crypto.
/api/v1/meta.json innehåller social för iOS-appen. social.telegram är chatten för Nordic Crypto på https://t.me/nordiccryptochat. social.x är varumärkets konto på https://x.com/nordiccryptobot (@nordiccryptobot), även listat som urls.x. urls.telegram upprepar chattens URL. urls.rss är det engelska nyhetsflödet på /rss.xml. Varje språks startsida har sin egen rss.xml. urls.newsletter är anmälningssidan på den här webbplatsen. label är det korta namnet (Telegram, X). name är länktexten på engelska. name_i18n har nn, nb, sv, da, fi och is. Övriga språk på webbplatsen använder name.
Aviseringar i webbläsaren#
När workers/push/public.json har en Worker-URL är knappen längst ned på varje sida Web Push. Fram till dess säger sidan att tjänsten inte är påslagen och anropar ingen Worker. Prenumerationerna finns på en Cloudflare Worker, inte i det här statiska flödet. Efter en publicering listar GET /api/push/feed.json på den Workern samma omgångar (titel, kort sammanfattning, URL, land och översättningar när vi har dem). En publicering är en omgång. Dokumentet anger "apns": "not implemented": Apple Push Notification service ingår inte. En iOS-app kan fråga flödet regelbundet. Worker-URL:en sätts när workers/push/ har driftsatts; det är ingen sökväg på den här webbplatsen. Prenumerationer finns inte i flödet. API:ets /api/v1/news.json är fortfarande den fullständiga listan över publicerade nyheter.
Endpoints#
Varje endpoint är en enkel GET av en statisk JSON-fil.
| Sökväg | Returnerar |
|---|---|
/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). |
Ingår inte#
Utkast, redaktionskön, avvisade nyheter, tips från läsare, nyhetsbrevsprenumeranternas adresser, analystoken och privata personuppgifter finns inte i flödet. Ett okänt id ger en vanlig 404 från webbplatsen, inte ett JSON-fel.