Data-API fra Nordic Crypto

Bitcoin Lightning-node#

Nordic Crypto drifter en Bitcoin Lightning-node. Aliaset er Nordic Crypto. Implementasjonen er LND, i lettklientmodus med Neutrino. Ingen konto og ingen API-nøkkel.

Statuslinjen er skrevet inn i denne statiske siden og oppdaterer seg ikke selv. Live-status: Amboss og 1ML.

Node-URI. Kopier en linje. Første linje er IPv4. Andre linje er samme node på IPv6, [2a01:4f8:c01e:36d9::1]:9735.

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

Offentlig nøkkel.

0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9

Innbetalingsadresse på kjeden.

bc1p7zgqhev2zzn45mefzq59gq983379lr0rsymhl558rza9k05y7vsq9mglx7

Electrum-servere (BCH og Nexa)#

Nordic Crypto drifter Rostrum-baserte Electrum-servere for Bitcoin Cash og Nexa. Lommebøker og apper kan hente beholdninger, transaksjoner, UTXO-er, tokens og siste blokk fra dem, og kringkaste transaksjoner. Ingen konto og ingen API-nøkkel.

Nettleseren din spør hver server om versjon og siste blokk når siden åpnes. Svartid er tiden forespørselen om siste blokk tar.

De snakker Electrum-protokollen (JSON-RPC) på standardportene: WebSocket med TLS (wss) på 20004 for Nexa og 50004 for Bitcoin Cash, og TLS over TCP på 20002 for Nexa og 50002 for Bitcoin Cash. Ukrypterte porter tilbys ikke. I et klientbibliotek oppgir du vert, port og skjema (wss eller tcp_tls). Metodene står i protokolldokumentasjonen til Rostrum.

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

Serverne kjører egne fullnoder (Bitcoin Cash Node og Nexa), så svarene avhenger ikke av en tredjepart. En klient som ikke gjør SPV-sjekker, stoler likevel på oss når det gjelder hva kjeden inneholder. Det gis ingen oppetidsgaranti. Ha en ekstra server i listen, og gå videre hvis en ikke svarer innen noen sekunder.

Start her#

• Oversikt — alle endepunkter og eksempel-URL-er.
• OpenAPI (også som YAML).
• llms.txt — instruksjoner i klartekst.
• API-katalog (RFC 9727-linkset; kopi som .json).

Hent nyheter og et 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

Absolutte URL-er bruker det offentlige nettstedet, fra domeneroten: https://nordiccrypto.no/api/v1/news.json.

Spørre etter nye saker#

/api/v1/news/latest.json inneholder de 25 nyeste publiserte sakene, med bare id, published, country, source, source_name, language_code, own_story, overskriftene (title, title_en, title_i18n) og lenkene (url, html_url, api_url). Verdiene er de samme som i news.json, i samme rekkefølge (nyeste først). Filen holder seg liten uansett hvor langt arkivet vokser, så en app eller en push-server kan spørre den med noen minutters mellomrom. Send If-None-Match med den siste ETag; GitHub Pages svarer 304 Not Modified så lenge filen er uendret. Sammenlign id-ene med dem du har sett; generated_at endres ved hver bygging.

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

Markedspriser#

Priser fra nordiske børser er markedsdata, ikke investeringsråd. /api/v1/markets.json lister hvert handelspar med symbol, base, kvote, siste pris, kjøps- og salgskurs når børsen publiserer dem, børsens id, navn og land, fetched_at, kilde-URL og volum når børsen har publisert det. volume_base er basisaktivumet uten oppgitt tidsvindu (Firi). volume_base_24h og volume_quote_24h gjelder de siste 24 timene (NBX). Manglende volum er null, ikke 0. Kvotevalutaene er NOK, SEK, DKK og EUR. Én børs: /api/v1/markets/{exchange}.json (firi, nbx, coinmotion). Ett aktivum: /api/v1/markets/by-asset/{symbol}.json. Handelsplasser uten offentlig ticker står under skipped og får ingen oppdiktet pris.

/api/v1/markets/aggregated.json har én rad per handelspar. BTC-NOK blir ikke slått sammen med BTC-EUR. last er det aritmetiske gjennomsnittet av publiserte sistepriser. mid er gjennomsnittet av (bid+ask)/2 og blandes ikke inn i last. price er lik last når det finnes en sistepris, ellers mid. min og max bruker den samme serien. Det er ingen VWAP. Volum summeres bare innenfor samme felt og samme par. logo_url er en SVG fra cryptocurrency-icons (CC0 1.0) når settet har aktivumet, servert på /api/v1/markets/logos/{symbol}.svg, og ellers null. Filen per aktivum gjentar aggregated og logoen.

Byggingen henter dataene fra børsene. .github/workflows/markets-refresh.yml skriver JSON-en på gh-pages på nytt omtrent én gang i timen, inkludert den aggregerte filen og ikonene. Markedssiden laster denne filen på nytt, og oppdaterer Firi og Coinmotion i nettleseren fordi de API-ene sender Access-Control-Allow-Origin: *. Det gjør ikke NBX, så de radene følger filen. Det samme dokumentet 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øksstatistikk#

Samlede besøk og sidevisninger fra Cloudflare Web Analytics (uten informasjonskapsler). /api/v1/stats.json har radene daily, weekly (ISO) og monthly med bare visits og pageviews. Dager regnes i UTC. Filen er tom til Web Analytics-nettstedet og oppdateringstokenet er satt opp. .github/workflows/stats-refresh.yml skriver den på nytt på gh-pages omtrent én gang i døgnet.

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

Foredrag#

Offentlige foredrag om bitcoin, kryptovaluta og blokkjede holdt i Norge, Sverige, Danmark, Finland, Island, Færøyene, Grønland og Åland ligger i /api/v1/talks.json, nyeste først. Ett foredrag: /api/v1/talks/{id}.json. Ett land: /api/v1/talks/by-country/{country}.json (NO, SE, DK, FI, IS, FO, GL, AX). description er skrevet av oss. title, datoer, varighet, kanal og foredragsholdere kommer fra plattformen på source_url. Et felt plattformen ikke oppga, er null. embed er true bare når plattformens oEmbed-svar inneholder en spiller. HTML-siden laster spilleren først etter et klikk: YouTube via youtube-nocookie.com, Vimeo via player.vimeo.com. event_id og calendar_event_id er samme arrangements-id når foredraget er koblet til et arrangement. Arrangementet ligger på /api/v1/events/{id}.json (og /api/v1/events/previous.json når det er passert), og siden er /calendar/{id}/. talk_ids på arrangementet lister disse foredragene. unlink_reason settes når videosiden ikke oppga dag eller sted, og event_id er da null. speaker_ids er id-er fra «Hvem er hvem» i samme rekkefølge som speakers. Personen, på /api/v1/orgchart/{id}.json, lister disse foredragene og eventuell tilknytning som foredragssiden oppga.

Flere medier, én sak#

En sak har ett hovedmedium. Andre medier som dekket den samme hendelsen, står i also_covered_by. sources lister hovedmediet først, deretter de andre. Hvert medium har outlet, outlet_name, url, title (mediets egen overskrift), published, lang, country, source_type og logo. source_type er national, regional (regionalt og lokalt), official (rettsvesen og offentlige etater: politi, påtalemyndighet, domstoler, tilsyn) eller international. coverage.count er antall medier. coverage.by_country og coverage.by_source_type er antall og andeler til søylene. Alle kildetyper er med, også de med 0. html_url er vår side for saken. url er hovedmediet. Kaupr er fortsatt bare en nyhetskilde.

Arrangementer#

Kommende og tidligere arrangementer ligger i /api/v1/events.json. Luma-kalendere hentes fra den offentlige iCal-adressen for abonnement på hver arrangementskilde (ics). Lumas bysider, kategorisider og discover-API brukes ikke. En enkelt arrangementsside på Luma leses som schema.org JSON-LD. Arrangører og lokaler på Eventbrite leses med v3-API-et når serveren har EVENTBRITE_TOKEN. Det tokenet er ikke i denne strømmen og er ikke sjekket inn. Uten det brukes JSON-LD fra arrangementssiden. Samme tittel, dato og sted regnes som ett arrangement. Avsluttede arrangementer blir værende i strømmen. description.text er arrangørens egen tekst, description.lang er språket i teksten, og description.source_url er siden den kommer fra. description.i18n inneholder en oversettelse der vi har en. Feltet er null når kilden ikke hadde noen beskrivelse. Oppføringer fra useriøse konferansearrangører brukes ikke som kilde. Kaupr er aldri sponsor.

Språk#

Engelsk er standardfeltet (summary, title, text). Oversettelser vi har publisert, ligger i summary_i18n, title_i18n, subtitle_i18n, note_i18n, text_i18n og about_i18n, med nøklene nn, nb, sv, da, fi og is. Andre språk på nettstedet bruker det engelske feltet til en oversettelse er publisert. I en nyhetssak er title fortsatt kildens overskrift, title_en er vår engelske overskrift og title_i18n er vår overskrift på de nordiske språkene. Sidene viser overskriften på sidens språk først og kildens overskrift under når de er forskjellige. Hvert medies egen overskrift, i sources, står på mediets språk. Datoer følger ISO 8601.

/api/v1/languages.json lister alle språkene på nettstedet med code, native_name, english_name, rtl, html_lang og home. /api/v1/geo-language.json er gjetningen fra land til språk som brukes ved første besøk. Landet fra IP-adressen kommer fra tipworker GET /api/geo (Cloudflare request.cf.country). Ingenting lagres. Informasjonskapselen nc_lang, som settes av språkvelgeren, vinner alltid.

Kildelogoer#

Hvert medium i /api/v1/sources.json har logo_url (absolutt PNG- eller WebP-URL, aldri SVG, eller null) og logo (kind, file_url (originalen, SVG eller WebP), raster_url (samme som logo_url), source_url, author, license, license_url, credit, eller null). Hver nyhetssak har source_logo_url, slik at en app kan vise mediets logo ved siden av overskriften. Logoene kommer fra Wikimedia Commons (med lisens) eller utgiverens eget nettsted. De er utgivernes varemerker og vises bare for å identifisere kilden til en overskrift. En logo forblir null til redaktøren har kontrollert den.

CORS#

GitHub Pages sender Access-Control-Allow-Origin: * på disse filene, så en side på et annet nettsted kan hente dem med fetch(). GitHub Pages bruker ikke egendefinerte header-filer. Bruk filnavnet med .json; å åpne en mappe gir ikke JSON-en.

Redaksjonelt#

Avsender er The Nordic Crypto team. Kaupr (kaupr.io) er bare en nyhetskilde og er aldri sponsor. Ingenting her er investeringsråd.

Merkevarekontoer#

ios i /api/v1/meta.json er den offentlige TestFlight-invitasjonen til iOS-appen fra Nordic Crypto. Appen finnes ikke i App Store. apple_tv sier at TestFlight-versjonen særlig støtter Apple TV. apple_tv_i18n har den korte setningen på alle språkene på nettstedet. Merkenavnet er alltid Nordic Crypto.

/api/v1/meta.json inneholder social for iOS-appen. social.telegram er Nordic Crypto-chatten på https://t.me/nordiccryptochat. social.x er merkevarekontoen på https://x.com/nordiccryptobot (@nordiccryptobot), også oppført som urls.x. urls.telegram gjentar chat-URL-en. urls.rss er den engelske saksstrømmen på /rss.xml. Hver språkforside har sin egen rss.xml. urls.newsletter er påmeldingssiden på dette nettstedet. label er kortnavnet (Telegram, X). name er lenketeksten på engelsk. name_i18n har nn, nb, sv, da, fi og is. Andre språk på nettstedet bruker name.

Varsler i nettleseren#

Når workers/push/public.json har en Worker-URL, er knappen nederst på hver side Web Push. Inntil da sier siden at tjenesten ikke er slått på, og kaller ingen Worker. Abonnementene ligger på en Cloudflare Worker, ikke i denne statiske strømmen. Etter en publisering lister GET /api/push/feed.json på den Workeren de samme puljene (tittel, kort sammendrag, URL, land og oversettelser når vi har dem). Én publisering er én pulje. Dokumentet sier "apns": "not implemented": Apple Push Notification service er utenfor omfanget. En iOS-app kan spørre strømmen jevnlig. Worker-URL-en settes når workers/push/ er distribuert; den er ikke en sti på dette nettstedet. Abonnementer er ikke i strømmen. Dette API-ets /api/v1/news.json er fortsatt den fullstendige listen over publiserte saker.

Endepunkter#

Hvert endepunkt er en enkel GET av en statisk JSON-fil.

Ikke inkludert#

Utkast, redaksjonskøen, avviste saker, tips fra lesere, adressene til nyhetsbrevabonnenter, analysetokenet og private personopplysninger er ikke i denne strømmen. En ukjent id gir en vanlig 404 fra nettstedet, ikke en JSON-feil.

Feltnavnene i versjon 1 består. Nye felt kan komme til. En endring som bryter kompatibiliteten, vil få en ny sti.