Data-API fra Nordic Crypto

Bitcoin Lightning-node#

Nordic Crypto driver en Bitcoin Lightning-node. Aliaset er Nordic Crypto. Implementeringen er LND, i letklienttilstand med Neutrino. Ingen konto og ingen API-nøgle.

Statuslinjen er skrevet ind på denne statiske side og opdaterer ikke sig selv. Livestatus: Amboss og 1ML.

Node-URI. Kopiér en linje. Første linje er IPv4. Anden linje er den 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øgle.

0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9

Indbetalingsadresse på kæden.

bc1p7zgqhev2zzn45mefzq59gq983379lr0rsymhl558rza9k05y7vsq9mglx7

Electrum-servere (BCH og Nexa)#

Nordic Crypto driver Rostrum-baserede Electrum-servere til Bitcoin Cash og Nexa. Wallets og apps kan hente saldi, transaktioner, UTXO'er, tokens og seneste blok fra dem og udsende transaktioner. Ingen konto og ingen API-nøgle.

Din browser spørger hver server om version og seneste blok, når siden åbnes. Svartid er tiden for forespørgslen om seneste blok.

De taler 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. Ukrypterede porte tilbydes ikke. I et klientbibliotek angiver du vært, port og skema (wss eller tcp_tls). Metoderne står i Rostrums protokoldokumentation.

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

Serverne kører deres egne fuldnoder (Bitcoin Cash Node og Nexa), så svarene afhænger ikke af en tredjepart. En klient, der ikke laver SPV-tjek, stoler stadig på os med hensyn til, hvad kæden indeholder. Der er ingen oppetidsgaranti. Hav en ekstra server på listen, og gå videre, hvis en ikke svarer inden for få sekunder.

Start her#

• Oversigt — alle endpoints og eksempel-URL'er.
• OpenAPI (også som YAML).
• llms.txt — vejledning i almindeligt sprog.
• API-katalog (RFC 9727-linkset; kopi som .json).

Hent nyheder og et nyhedsbrev#

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 bruger det offentlige site, fra domænets rod: https://nordiccrypto.no/api/v1/news.json.

Spørg efter nye historier#

/api/v1/news/latest.json indeholder de 25 nyeste publicerede historier, kun med id, published, country, source, source_name, language_code, own_story, overskrifterne (title, title_en, title_i18n) og linkene (url, html_url, api_url). Værdierne er de samme som i news.json, i samme rækkefølge (nyeste først). Filen forbliver lille, uanset hvor langt arkivet vokser, så en app eller en push-server kan spørge den med nogle minutters mellemrum. Send If-None-Match med den seneste ETag; GitHub Pages svarer 304 Not Modified, så længe filen er uændret. Sammenlign id’er med dem, du har set; generated_at ændres ved hvert byg.

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

Markedspriser#

Priser fra nordiske kryptobørser er markedsdata, ikke investeringsrådgivning. /api/v1/markets.json viser hvert handelspar med symbol, base, kvote, seneste pris, købs- og salgskurs, når børsen offentliggør dem, børsens id, navn og land, fetched_at, kilde-URL og volumen, når børsen har offentliggjort den. volume_base er basisaktivet uden angivet tidsvindue (Firi). volume_base_24h og volume_quote_24h dækker de seneste 24 timer (NBX). Manglende volumen er null, ikke nul. Kvotevalutaerne er NOK, SEK, DKK og EUR. Én børs: /api/v1/markets/{exchange}.json (firi, nbx, coinmotion). Ét aktiv: /api/v1/markets/by-asset/{symbol}.json. Handelssteder uden offentlig ticker står under skipped og får ikke en opdigtet pris.

/api/v1/markets/aggregated.json har én række pr. handelspar. BTC-NOK lægges ikke sammen med BTC-EUR. last er det aritmetiske gennemsnit af offentliggjorte seneste priser. mid er gennemsnittet af (bid+ask)/2 og blandes ikke ind i last. price er lig med last, når der findes en seneste pris, ellers mid. min og max bruger samme serie. Der er ingen VWAP. Volumen summeres kun inden for samme felt og samme par. logo_url er en SVG fra cryptocurrency-icons (CC0 1.0), når samlingen indeholder aktivet, serveret på /api/v1/markets/logos/{symbol}.svg, og ellers null. Filen pr. aktiv gentager aggregated og logoet.

Buildet henter data fra børserne. .github/workflows/markets-refresh.yml genskriver JSON'en på gh-pages cirka én gang i timen, inklusive den aggregerede fil og ikonerne. Markedssiden genindlæser filen og opdaterer Firi og Coinmotion i browseren, fordi de API'er sender Access-Control-Allow-Origin: *. Det gør NBX ikke, så de rækker følger filen. Det samme 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øgsstatistik#

Samlede besøg og sidevisninger fra Cloudflare Web Analytics (uden cookies). /api/v1/stats.json har rækkerne daily, weekly (ISO) og monthly med kun visits og pageviews. Dage regnes i UTC. Filen er tom, indtil Web Analytics-sitet og opdateringstokenet er sat op. .github/workflows/stats-refresh.yml genskriver den på gh-pages cirka én gang i døgnet.

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

Foredrag#

Offentlige foredrag om bitcoin, kryptovaluta og blockchain holdt i Norge, Sverige, Danmark, Finland, Island, Færøerne, Grønland og Åland findes i /api/v1/talks.json, nyeste først. Ét foredrag: /api/v1/talks/{id}.json. Ét land: /api/v1/talks/by-country/{country}.json (NO, SE, DK, FI, IS, FO, GL, AX). description er skrevet af os. title, datoer, varighed, kanal og talere kommer fra platformen på source_url. Et felt, platformen ikke oplyste, er null. embed er true, kun når platformens oEmbed-svar indeholder en afspiller. HTML-siden indlæser først afspilleren efter et klik: 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 findes på /api/v1/events/{id}.json (og /api/v1/events/previous.json, når det er overstået), og siden er /calendar/{id}/. talk_ids på arrangementet viser de foredrag. unlink_reason sættes, når videosiden ikke oplyste dag eller sted, og event_id er så null. speaker_ids er id'er fra "Hvem er hvem" i samme rækkefølge som speakers. Personen, på /api/v1/orgchart/{id}.json, viser de foredrag og eventuel tilknytning, som foredragssiden oplyste.

Flere medier, én historie#

En historie har ét primært medie. Andre medier, der dækkede samme begivenhed, står i also_covered_by. sources viser det primære medie først og derefter de andre. Hvert medie 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 (retsvæsen og myndigheder: politi, anklagemyndighed, domstole, tilsyn) eller international. coverage.count er antallet af medier. coverage.by_country og coverage.by_source_type er antal og andele til søjlerne. Alle kildetyper er med, også dem med nul. html_url er vores side for historien. url er det primære medie. Kaupr er stadig kun en nyhedskilde.

Arrangementer#

Kommende og tidligere arrangementer findes i /api/v1/events.json. Luma-kalendere hentes fra den offentlige iCal-adresse til abonnement på hver arrangementskilde (ics). Lumas bysider, kategorisider og discover-API bruges ikke. En enkelt arrangementsside på Luma læses som schema.org JSON-LD. Arrangører og spillesteder på Eventbrite læses med v3-API'et, når serveren har EVENTBRITE_TOKEN. Det token er ikke i feedet og er ikke committet. Uden det bruges JSON-LD fra arrangementssiden. Samme titel, dato og sted er ét arrangement. Afsluttede arrangementer bliver i feedet. description.text er arrangørens egen tekst, description.lang er tekstens sprog, og description.source_url er den side, den kommer fra. description.i18n indeholder en oversættelse, hvor vi har en. Feltet er null, når kilden ikke havde en beskrivelse. Opslag fra useriøse konferencearrangører bruges ikke som kilde. Kaupr er aldrig sponsor.

Sprog#

Engelsk er standardfeltet (summary, title, text). Oversættelser, vi har offentliggjort, ligger i summary_i18n, title_i18n, subtitle_i18n, note_i18n, text_i18n og about_i18n med nøglerne nn, nb, sv, da, fi og is. Sitets øvrige sprog bruger det engelske felt, indtil en oversættelse er offentliggjort. I en nyhed er title stadig kildens overskrift, title_en vores engelske overskrift og title_i18n vores overskrift på de nordiske sprog. Siderne viser overskriften på sidens sprog først og kildens overskrift nedenunder, når de er forskellige. Hvert medies egen overskrift i sources står på mediets sprog. Datoer følger ISO 8601.

/api/v1/languages.json viser alle sitets sprog med code, native_name, english_name, rtl, html_lang og home. /api/v1/geo-language.json er gættet fra land til sprog ved første besøg. Landet fra IP-adressen kommer fra tipworker GET /api/geo (Cloudflare request.cf.country). Intet gemmes. Cookien nc_lang, som sættes af sprogvælgeren, vinder altid.

Kildelogoer#

Hvert medie i /api/v1/sources.json har logo_url (absolut PNG- eller WebP-URL, aldrig 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 nyhed har source_logo_url, så en app kan vise mediets logo ved siden af overskriften. Logoerne kommer fra Wikimedia Commons (med licens) eller udgiverens eget site. De er udgivernes varemærker og vises kun for at identificere kilden til en overskrift. Et logo forbliver null, indtil redaktøren har tjekket det.

CORS#

GitHub Pages sender Access-Control-Allow-Origin: * på disse filer, så en side på et andet site kan hente dem med fetch(). GitHub Pages anvender ikke egne header-filer. Brug filnavnet med .json; åbner man en mappe, får man ikke JSON'en.

Redaktionelt#

Afsender er The Nordic Crypto team. Kaupr (kaupr.io) er kun en nyhedskilde og er aldrig sponsor. Intet her er investeringsrådgivning.

Brandets konti#

ios i /api/v1/meta.json er den offentlige TestFlight-invitation til iOS-appen fra Nordic Crypto. Appen findes ikke i App Store. apple_tv siger, at TestFlight-versionen især understøtter Apple TV. apple_tv_i18n har den korte sætning på alle sitets sprog. Brandnavnet er altid Nordic Crypto.

/api/v1/meta.json indeholder social til iOS-appen. social.telegram er chatten for Nordic Crypto på https://t.me/nordiccryptochat. social.x er brandets konto på https://x.com/nordiccryptobot (@nordiccryptobot), også angivet som urls.x. urls.telegram gentager chat-URL'en. urls.rss er det engelske nyhedsfeed på /rss.xml. Hver sprogforside har sin egen rss.xml. urls.newsletter er tilmeldingssiden på dette site. label er det korte navn (Telegram, X). name er linkteksten på engelsk. name_i18n har nn, nb, sv, da, fi og is. Sitets øvrige sprog bruger name.

Browsernotifikationer#

Når workers/push/public.json har en Worker-URL, er knappen nederst på hver side Web Push. Indtil da siger siden, at tjenesten ikke er slået til, og kalder ingen Worker. Abonnementerne ligger på en Cloudflare Worker, ikke i dette statiske feed. Efter en udgivelse viser GET /api/push/feed.json på den Worker de samme portioner (titel, kort resumé, URL, land og oversættelser, når vi har dem). Én udgivelse er én portion. Dokumentet siger "apns": "not implemented": Apple Push Notification service er uden for rammerne. En iOS-app kan hente feedet med jævne mellemrum. Worker-URL'en sættes, når workers/push/ er udrullet; den er ikke en sti på dette site. Abonnementer er ikke i feedet. Dette API's /api/v1/news.json er stadig den fulde liste over offentliggjorte nyheder.

Endpoints#

Hvert endpoint er en simpel GET af en statisk JSON-fil.

Ikke inkluderet#

Kladder, redaktionskøen, afviste historier, tips fra læsere, nyhedsbrevsabonnenters adresser, analysetokenet og private personoplysninger er ikke i feedet. Et ukendt id giver en almindelig 404 fra sitet, ikke en JSON-fejl.

Feltnavnene i version 1 består. Nye felter kan komme til. En ændring, der bryder kompatibiliteten, vil få en ny sti.