Nordic Crypton data-API
Sivuston avoin JSON-syöte sovelluksille ja muille työkaluille. Ei tiliä eikä API-avainta. Syöte luodaan uudelleen aina, kun sivusto rakennetaan.
Bitcoinin Lightning-solmu#
Nordic Crypto ylläpitää Bitcoinin Lightning-solmua. Alias on Nordic Crypto. Toteutus on LND, Neutrinon kevytasiakastilassa. Ei tiliä eikä API-avainta.
| Solmu | Tila | Toteutus |
|---|---|---|
| Bitcoin Nordic Crypto | synkronoi / ei vielä avoinna kanaville | LND (Neutrino-kevytasiakas) |
Solmun URI. Kopioi rivi. Ensimmäinen rivi on IPv4. Toinen rivi on sama solmu IPv6:lla, [2a01:4f8:c01e:36d9::1]:9735.
0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9@91.99.122.75:9735 0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9@[2a01:4f8:c01e:36d9::1]:9735
Julkinen avain.
0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9
Talletusosoite ketjussa.
bc1p7zgqhev2zzn45mefzq59gq983379lr0rsymhl558rza9k05y7vsq9mglx7
Electrum-palvelimet (BCH ja Nexa)#
Nordic Crypto ylläpitää Rostrum-pohjaisia Electrum-palvelimia Bitcoin Cashille ja Nexalle. Lompakot ja sovellukset voivat hakea niistä osoitteiden varat, transaktiot, UTXO:t, tokenit ja ketjun kärjen sekä lähettää transaktioita verkkoon. Ei tiliä eikä API-avainta.
| Palvelin | Tila | Lohkokorkeus | Vasteaika | Versio |
|---|---|---|---|---|
Bitcoin Cashwss://electrum-bch.nordiccrypto.no:50004 | – | – | – | – |
Nexawss://electrum-nexa.nordiccrypto.no:20004 | – | – | – | – |
Palvelimet käyttävät Electrum-protokollaa (JSON-RPC) vakioporteissa: WebSocket TLS:n kanssa (wss) portissa 20004 Nexalle ja 50004 Bitcoin Cashille sekä TLS TCP:n yli portissa 20002 Nexalle ja 50002 Bitcoin Cashille. Salaamattomia portteja ei tarjota. Anna asiakaskirjastolle isäntä, portti ja skeema (wss tai tcp_tls). Metodit on lueteltu Rostrumin protokolladokumentaatiossa.
websocat wss://electrum-bch.nordiccrypto.no:50004
{"id":1,"method":"blockchain.headers.subscribe","params":[]}
Palvelimilla on omat täydet solmut (Bitcoin Cash Node ja Nexa), joten niiden vastaukset eivät riipu kolmannesta osapuolesta. Asiakas, joka ei tee SPV-tarkistuksia, luottaa silti meihin siinä, mitä ketju sisältää. Käytettävyydelle ei anneta takuuta. Pidä listallasi toinen palvelin ja siirry eteenpäin, jos palvelin ei vastaa muutamassa sekunnissa.
Aloita tästä#
- Hakemisto — kaikki endpointit ja esimerkki-URL:t.
- OpenAPI (myös YAML).
- llms.txt — ohjeet selkokielellä.
- API-luettelo (RFC 9727 -linkset; .json-kopio).
Hae uutiset ja uutiskirje#
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
Absoluuttiset URL:t käyttävät julkista sivustoa verkkotunnuksen juuressa: https://nordiccrypto.no/api/v1/news.json.
Uusien juttujen kysely#
/api/v1/news/latest.json sisältää 25 uusinta julkaistua juttua, ja vain kentät id, published, country, source, source_name, language_code, own_story, otsikot (title, title_en, title_i18n) ja linkit (url, html_url, api_url). Arvot ovat samat kuin tiedostossa news.json, samassa järjestyksessä (uusin ensin). Tiedosto pysyy pienenä, vaikka arkisto kasvaisi, joten sovellus tai push-palvelin voi kysyä sitä muutaman minuutin välein. Lähetä If-None-Match ja viimeisin ETag; GitHub Pages vastaa 304 Not Modified, kun tiedosto ei ole muuttunut. Vertaa tunnuksia niihin, jotka olet jo nähnyt; generated_at vaihtuu jokaisella buildilla.
curl -fsS https://nordiccrypto.no/api/v1/news/latest.json
Markkinahinnat#
Pohjoismaisten pörssien hinnat ovat markkinadataa, eivät sijoitusneuvontaa. /api/v1/markets.json listaa jokaisen kaupankäyntiparin: symboli, perus- ja noteerausvaluutta, viimeisin hinta, osto- ja myyntikurssi, kun pörssi julkaisee ne, pörssin tunniste, nimi ja maa, fetched_at, lähde-URL sekä volyymi, kun pörssi on julkaissut sen. volume_base on perusvaluutan volyymi ilman nimettyä aikaikkunaa (Firi). volume_base_24h ja volume_quote_24h kattavat viimeiset 24 tuntia (NBX). Puuttuva volyymi on null, ei nolla. Noteerausvaluutat ovat NOK, SEK, DKK ja EUR. Yksi pörssi: /api/v1/markets/{exchange}.json (firi, nbx, coinmotion). Yksi omaisuuserä: /api/v1/markets/by-asset/{symbol}.json. Kauppapaikat, joilla ei ole julkista tickeriä, on lueteltu kohdassa skipped, eikä niille keksitä hintaa.
/api/v1/markets/aggregated.json sisältää yhden rivin kaupankäyntiparia kohti. BTC-NOK-hintaa ei keskiarvoisteta BTC-EUR-hinnan kanssa. last on julkaistujen viimeisimpien hintojen aritmeettinen keskiarvo. mid on arvon (bid+ask)/2 keskiarvo, eikä sitä sekoiteta last-arvoon. price on last, jos viimeisin hinta on olemassa, muuten mid. min ja max käyttävät samaa sarjaa. VWAP-arvoa ei ole. Volyymi lasketaan yhteen vain saman kentän ja saman parin sisällä. logo_url on SVG cryptocurrency-icons-kokoelmasta (CC0 1.0), kun kokoelmassa on kyseinen omaisuuserä; se tarjoillaan osoitteessa /api/v1/markets/logos/{symbol}.svg, muuten arvo on null. Omaisuuseräkohtainen tiedosto toistaa aggregated-tiedot ja logon.
Sivuston rakennus hakee tiedot pörsseistä. .github/workflows/markets-refresh.yml kirjoittaa JSON-tiedoston gh-pages-haaraan uudelleen noin kerran tunnissa, mukaan lukien kootun tiedoston ja kuvakkeet. Markkinasivu lataa tämän tiedoston uudelleen ja päivittää Firin ja Coinmotionin selaimessa, koska niiden API:t lähettävät otsakkeen Access-Control-Allow-Origin: *. NBX ei lähetä, joten sen rivit seuraavat tiedostoa. Sama dokumentti gh-pages-haarassa: 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
Kävijätilastot#
Kootut käynnit ja sivunkatselut Cloudflare Web Analyticsista (ei evästeitä). /api/v1/stats.json sisältää rivit daily, weekly (ISO) ja monthly, joissa on vain visits ja pageviews. Päivät ovat UTC-aikaa. Tiedosto on tyhjä, kunnes Web Analytics -sivusto ja päivitystunniste on määritetty. .github/workflows/stats-refresh.yml kirjoittaa sen gh-pages-haaraan uudelleen noin kerran päivässä.
curl -fsS https://nordiccrypto.no/api/v1/stats.json
Esitelmät#
Julkiset esitelmät bitcoinista, kryptovaluutoista ja lohkoketjuista, jotka on pidetty Norjassa, Ruotsissa, Tanskassa, Suomessa, Islannissa, Färsaarilla, Grönlannissa ja Ahvenanmaalla, ovat osoitteessa /api/v1/talks.json, uusin ensin. Yksi esitelmä: /api/v1/talks/{id}.json. Yksi maa: /api/v1/talks/by-country/{country}.json (NO, SE, DK, FI, IS, FO, GL, AX). description on meidän kirjoittamamme. title, päivämäärät, kesto, kanava ja puhujat tulevat alustalta osoitteesta source_url. Kenttä, jota alusta ei ilmoittanut, on null. embed on true vain, kun alustan oEmbed-vastaus sisältää soittimen. HTML-sivu lataa soittimen vasta klikkauksen jälkeen: YouTube osoitteen youtube-nocookie.com kautta, Vimeo osoitteen player.vimeo.com kautta. event_id ja calendar_event_id ovat sama tapahtumatunniste, kun esitelmä on linkitetty tapahtumaan. Tapahtuma on osoitteessa /api/v1/events/{id}.json (ja /api/v1/events/previous.json, jos se on jo mennyt), ja sivu on /calendar/{id}/. Tapahtuman talk_ids listaa nämä esitelmät. unlink_reason asetetaan, kun videosivu ei ilmoittanut päivää tai paikkaa, ja event_id on silloin null. speaker_ids ovat Kuka kukin on -tunnisteita samassa järjestyksessä kuin speakers. Henkilön tiedot osoitteessa /api/v1/orgchart/{id}.json listaavat nämä esitelmät ja esitelmäsivulla ilmoitetun mahdollisen taustaorganisaation.
Useita medioita, yksi uutinen#
Uutisella on yksi päämedia. Muut samasta tapahtumasta uutisoineet mediat ovat kentässä also_covered_by. sources listaa ensin päämedian ja sitten muut. Jokaisella medialla on outlet, outlet_name, url, title (kyseisen median otsikko), published, lang, country, source_type ja logo. source_type on national, regional (alueellinen ja paikallinen), official (oikeuslaitos ja viranomaiset: poliisi, syyttäjät, tuomioistuimet, valvojat) tai international. coverage.count on medioiden määrä. coverage.by_country ja coverage.by_source_type ovat palkkien määrät ja osuudet. Jokainen lähdetyyppi on mukana, myös nollan määrällä. html_url on uutisen sivu sivustollamme. url on päämedia. Kaupr on edelleen vain uutislähde.
Tapahtumat#
Tulevat ja menneet tapahtumat ovat osoitteessa /api/v1/events.json. Luma-kalenterit haetaan kunkin tapahtumalähteen julkisesta iCal-tilausosoitteesta (ics). Luman kaupunkisivuja, kategoriasivuja tai discover-API:a ei käytetä. Yksittäinen Luma-tapahtumasivu luetaan schema.org JSON-LD -muodossa. Eventbriten järjestäjät ja tapahtumapaikat luetaan v3-API:lla, kun palvelimella on EVENTBRITE_TOKEN. Tunniste ei ole tässä syötteessä eikä versionhallinnassa. Ilman sitä käytetään tapahtumasivun JSON-LD:tä. Sama nimi, päivämäärä ja paikka on yksi tapahtuma. Päättyneet tapahtumat jäävät syötteeseen. description.text on järjestäjän oma teksti, description.lang on tekstin kieli ja description.source_url on sivu, jolta teksti on peräisin. description.i18n sisältää käännöksen, jos meillä on sellainen. Kenttä on null, jos lähteessä ei ollut kuvausta. Saalistajakonferenssien listauksia ei käytetä lähteenä. Kaupr ei ole koskaan sponsori.
Kielet#
Englanti on oletuskenttä (summary, title, text). Julkaisemamme käännökset ovat kentissä summary_i18n, title_i18n, subtitle_i18n, note_i18n, text_i18n ja about_i18n avaimilla nn, nb, sv, da, fi ja is. Sivuston muut kielet käyttävät englanninkielistä kenttää, kunnes käännös julkaistaan. Uutisessa title on edelleen lähteen otsikko, title_en on englanninkielinen otsikkomme ja title_i18n otsikkomme pohjoismaisilla kielillä. Sivut näyttävät ensin sivun kielisen otsikon ja sen alla lähteen otsikon, jos ne eroavat. Kunkin median oma otsikko kentässä sources on median kielellä. Päivämäärät ovat ISO 8601 -muodossa.
/api/v1/languages.json listaa sivuston kaikki kielet kentillä code, native_name, english_name, rtl, html_lang ja home. /api/v1/geo-language.json on maan perusteella tehty kieliarvaus, jota käytetään ensimmäisellä käynnillä. IP-osoitteen maa saadaan tipworkerin kutsusta GET /api/geo (Cloudflare request.cf.country). Mitään ei tallenneta. Kielivalitsimen asettama nc_lang-eväste voittaa aina.
Lähteiden logot#
Jokaisella medialla osoitteessa /api/v1/sources.json on logo_url (absoluuttinen PNG- tai WebP-URL, ei koskaan SVG, tai null) ja logo (kind, file_url (alkuperäinen, SVG tai WebP), raster_url (sama kuin logo_url), source_url, author, license, license_url, credit, tai null). Jokaisella uutisella on source_logo_url, joten sovellus voi näyttää median logon otsikon vieressä. Logot ovat peräisin Wikimedia Commonsista (lisenssin kanssa) tai julkaisijan omalta sivustolta. Ne ovat julkaisijoiden tavaramerkkejä, ja niitä näytetään vain otsikon lähteen tunnistamiseksi. Logo on null, kunnes toimittaja on tarkistanut sen.
CORS#
GitHub Pages lähettää näille tiedostoille otsakkeen Access-Control-Allow-Origin: *, joten toisen sivuston sivu voi hakea ne fetch()-kutsulla. GitHub Pages ei käytä mukautettua otsaketiedostoa. Käytä .json-tiedostonimeä; hakemiston avaaminen ei palauta JSON-dataa.
Toimituksellista#
Allekirjoitus on The Nordic Crypto team. Kaupr (kaupr.io) on vain uutislähde eikä koskaan sponsori. Mikään täällä ei ole sijoitusneuvontaa.
Brändin tilit#
ios tiedostossa /api/v1/meta.json on julkinen TestFlight-kutsu Nordic Crypton iOS-sovellukseen. Sovellus ei ole App Storessa. apple_tv kertoo, että TestFlight-versio tukee erityisesti Apple TV:tä. apple_tv_i18n sisältää tämän lyhyen lauseen kaikilla sivuston kielillä. Brändin nimi on aina Nordic Crypto.
/api/v1/meta.json sisältää iOS-sovellusta varten kentän social. social.telegram on Nordic Crypton chat osoitteessa https://t.me/nordiccryptochat. social.x on brändin tili osoitteessa https://x.com/nordiccryptobot (@nordiccryptobot), myös kentässä urls.x. urls.telegram toistaa chatin URL:n. urls.rss on englanninkielinen uutissyöte osoitteessa /rss.xml. Jokaisen kielen etusivulla on oma rss.xml. urls.newsletter on tämän sivuston tilaussivu. label on lyhyt nimi (Telegram, X). name on linkin teksti englanniksi. name_i18n sisältää kielet nn, nb, sv, da, fi ja is. Sivuston muut kielet käyttävät kenttää name.
Selainilmoitukset#
Kun tiedostossa workers/push/public.json on Worker-URL, jokaisen sivun alareunan painike on Web Push. Siihen asti sivu kertoo, ettei palvelua ole otettu käyttöön, eikä kutsu Workeria. Tilaukset ovat Cloudflare Workerissa, eivät tässä staattisessa syötteessä. Julkaisun jälkeen kyseisen Workerin GET /api/push/feed.json listaa samat erät (otsikko, lyhyt tiivistelmä, URL, maa ja käännökset, kun niitä on). Yksi julkaisu on yksi erä. Dokumentissa lukee "apns": "not implemented": Apple Push Notification service ei kuulu toteutukseen. iOS-sovellus voi hakea syötettä säännöllisesti. Worker-URL asetetaan, kun workers/push/ on otettu käyttöön; se ei ole polku tällä sivustolla. Tilaukset eivät ole syötteessä. Tämän API:n /api/v1/news.json on edelleen täydellinen julkaistujen uutisten lista.
Endpointit#
Jokainen endpoint on tavallinen GET-pyyntö staattiseen JSON-tiedostoon.
| Polku | Palauttaa |
|---|---|
/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). |
Ei mukana#
Luonnokset, toimituksen jono, hylätyt uutiset, lukijoiden vinkit, uutiskirjeen tilaajien osoitteet, analytiikkatunniste ja yksityiset henkilötiedot eivät ole tässä syötteessä. Tuntematon tunniste palauttaa sivuston tavallisen 404-sivun, ei JSON-virhettä.