API ya data ya Nordic Crypto
Mlisho wa umma wa JSON wa tovuti hii, kwa programu na zana nyingine. Hakuna akaunti wala ufunguo wa API. Hutengenezwa upya kila tovuti inapojengwa.
Nodi ya Bitcoin Lightning#
Nordic Crypto inaendesha nodi ya Bitcoin Lightning. Jina la utani ni Nordic Crypto. Utekelezaji ni LND, katika hali ya mteja mwepesi wa Neutrino. Hakuna akaunti wala ufunguo wa API.
| Nodi | Hali | Utekelezaji |
|---|---|---|
| Bitcoin Nordic Crypto | inalandanisha / njia bado hazijafunguliwa | LND (mteja mwepesi wa Neutrino) |
URI ya nodi. Nakili mstari. Mstari wa kwanza ni IPv4. Mstari wa pili ni nodi hiyo hiyo kwenye IPv6, [2a01:4f8:c01e:36d9::1]:9735.
0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9@91.99.122.75:9735 0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9@[2a01:4f8:c01e:36d9::1]:9735
Ufunguo wa umma.
0225974bb701101a5d4352dcae0f76aa9c1388e482a666e892f462e0e0e4217dd9
Anwani ya amana kwenye mnyororo.
bc1p7zgqhev2zzn45mefzq59gq983379lr0rsymhl558rza9k05y7vsq9mglx7
Seva za Electrum (BCH na Nexa)#
Nordic Crypto huendesha seva za Electrum za Rostrum kwa Bitcoin Cash na Nexa. Pochi na programu zinaweza kusoma salio, miamala, UTXO, tokeni na bloku ya hivi karibuni kutoka kwazo, na kutangaza miamala. Hakuna akaunti wala ufunguo wa API.
| Seva | Hali | Urefu wa bloku | Muda wa kujibu | Toleo |
|---|---|---|---|---|
Bitcoin Cashwss://electrum-bch.nordiccrypto.no:50004 | – | – | – | – |
Nexawss://electrum-nexa.nordiccrypto.no:20004 | – | – | – | – |
Zinatumia itifaki ya Electrum (JSON-RPC) kwenye milango ya kawaida: WebSocket yenye TLS (wss) kwenye 20004 kwa Nexa na 50004 kwa Bitcoin Cash, na TLS juu ya TCP kwenye 20002 kwa Nexa na 50002 kwa Bitcoin Cash. Milango isiyosimbwa haitolewi. Katika maktaba ya mteja, weka mwenyeji, mlango na mpango (wss au tcp_tls). Mbinu zimeorodheshwa katika nyaraka za itifaki ya Rostrum.
websocat wss://electrum-bch.nordiccrypto.no:50004
{"id":1,"method":"blockchain.headers.subscribe","params":[]}
Seva hizi huendesha nodi zao kamili (Bitcoin Cash Node na Nexa), kwa hiyo majibu yake hayategemei mtu wa tatu. Mteja asiyefanya ukaguzi wa SPV bado anatuamini kuhusu kilichomo kwenye mnyororo. Hakuna hakikisho la upatikanaji. Weka seva ya pili kwenye orodha yako na uhamie huko ikiwa moja haijibu ndani ya sekunde chache.
Anza hapa#
- Faharasa — kila endpoint na mifano ya URL.
- OpenAPI (pia kama YAML).
- llms.txt — maelekezo kwa lugha rahisi.
- Katalogi ya API (linkset ya RFC 9727; nakala ya .json).
Pata habari na jarida#
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 kamili hutumia tovuti ya umma, kwenye mzizi wa kikoa: https://nordiccrypto.no/api/v1/news.json.
Kuuliza habari mpya#
/api/v1/news/latest.json ina habari 25 mpya zaidi zilizochapishwa, ikiwa na id, published, country, source, source_name, language_code, own_story pekee, vichwa (title, title_en, title_i18n) na viungo (url, html_url, api_url). Thamani ni zile zile za news.json, kwa mpangilio ule ule (mpya kwanza). Faili inabaki ndogo hata kumbukumbu ikiongezeka, ili programu au seva ya push iweze kuiuliza kila dakika chache. Tuma If-None-Match pamoja na ETag ya mwisho; GitHub Pages hujibu 304 Not Modified wakati faili haijabadilika. Linganisha id na zile ulizoziona; generated_at hubadilika kila ujenzi.
curl -fsS https://nordiccrypto.no/api/v1/news/latest.json
Bei za soko#
Bei za masoko ya Nordiki ni data ya soko, si ushauri wa uwekezaji. /api/v1/markets.json huorodhesha kila jozi pamoja na alama, sarafu ya msingi, sarafu ya bei, bei ya mwisho, bei ya kununua na kuuza soko linapozichapisha, kitambulisho, jina na nchi ya soko, fetched_at, URL ya chanzo, na kiasi cha biashara soko linapokichapisha. volume_base ni kiasi katika rasilimali ya msingi bila kipindi maalum (Firi). volume_base_24h na volume_quote_24h ni saa 24 zilizopita (NBX). Kiasi kisichopatikana ni null, si sifuri. Sarafu za bei ni NOK, SEK, DKK na EUR. Soko moja: /api/v1/markets/{exchange}.json (firi, nbx, coinmotion). Rasilimali moja: /api/v1/markets/by-asset/{symbol}.json. Majukwaa yasiyo na ticker ya umma yameorodheshwa chini ya skipped na hayapewi bei ya kubuni.
/api/v1/markets/aggregated.json ina safu moja kwa kila jozi. BTC-NOK haichukuliwi wastani pamoja na BTC-EUR. last ni wastani wa hesabu wa bei za mwisho zilizochapishwa. mid ni wastani wa (bid+ask)/2 na haichanganywi na last. price ni sawa na last ikiwa kuna bei ya mwisho, vinginevyo mid. min na max hutumia mfululizo huo huo. Hakuna VWAP. Kiasi hujumlishwa tu ndani ya sehemu moja na jozi moja. logo_url ni SVG kutoka cryptocurrency-icons (CC0 1.0) ikiwa seti hiyo ina rasilimali hiyo, inayotolewa kwenye /api/v1/markets/logos/{symbol}.svg, na null vinginevyo. Faili la kila rasilimali hurudia aggregated na nembo.
Ujenzi huchukua data kutoka kwa masoko. .github/workflows/markets-refresh.yml huandika upya JSON kwenye gh-pages takriban mara moja kwa saa, pamoja na faili la jumla na aikoni. Ukurasa wa masoko hupakia upya faili hili, na husasisha Firi na Coinmotion ndani ya kivinjari kwa sababu API zao hutuma Access-Control-Allow-Origin: *. NBX haifanyi hivyo, kwa hiyo safu zake hufuata faili. Hati hiyo hiyo kwenye tawi la 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
Takwimu za wageni#
Jumla ya ziara na kurasa zilizotazamwa kutoka Cloudflare Web Analytics (bila vidakuzi). /api/v1/stats.json ina safu za daily, weekly (ISO) na monthly zenye visits na pageviews pekee. Siku ni kwa saa za UTC. Faili hili ni tupu hadi tovuti ya Web Analytics na tokeni ya kusasisha vimesanidiwa. .github/workflows/stats-refresh.yml huliandika upya kwenye gh-pages takriban mara moja kwa siku.
curl -fsS https://nordiccrypto.no/api/v1/stats.json
Mihadhara#
Mihadhara ya umma kuhusu bitcoin, sarafu za kidijitali na blockchain iliyofanyika Norwe, Uswidi, Denmaki, Ufini, Aisilandi, Visiwa vya Faroe, Greenland na Åland iko kwenye /api/v1/talks.json, mipya kwanza. Mhadhara mmoja: /api/v1/talks/{id}.json. Nchi moja: /api/v1/talks/by-country/{country}.json (NO, SE, DK, FI, IS, FO, GL, AX). description imeandikwa na sisi. title, tarehe, muda, chaneli na wazungumzaji hutoka kwenye jukwaa lililo kwenye source_url. Sehemu ambayo jukwaa halikutaja ni null. embed ni true tu ikiwa jibu la oEmbed la jukwaa hilo lina kicheza video. Ukurasa wa HTML hupakia kicheza video baada ya kubofya tu: YouTube kupitia youtube-nocookie.com, Vimeo kupitia player.vimeo.com. event_id na calendar_event_id ni kitambulisho kimoja cha tukio pale mhadhara umeunganishwa. Tukio hilo liko kwenye /api/v1/events/{id}.json (na /api/v1/events/previous.json likiwa limepita) na ukurasa wake ni /calendar/{id}/. talk_ids kwenye tukio huorodhesha mihadhara hiyo. unlink_reason huwekwa wakati ukurasa wa video haukutaja siku au mahali, na hapo event_id ni null. speaker_ids ni vitambulisho vya “Nani ni nani” kwa mpangilio ule ule wa speakers. Mtu huyo, kwenye /api/v1/orgchart/{id}.json, huorodhesha mihadhara hiyo na uhusiano wowote ambao ukurasa wa mhadhara ulitaja.
Vyombo vingi, habari moja#
Habari ina chombo kimoja kikuu. Vyombo vingine vilivyoripoti tukio hilo hilo viko kwenye also_covered_by. sources huorodhesha chombo kikuu kwanza, kisha vingine. Kila chombo kina outlet, outlet_name, url, title (kichwa cha habari cha chombo hicho), published, lang, country, source_type na logo. source_type ni national, regional (kikanda na kienyeji), official (haki na rasmi: polisi, waendesha mashtaka, mahakama, wasimamizi) au international. coverage.count ni idadi ya vyombo. coverage.by_country na coverage.by_source_type ni idadi na asilimia za grafu za pau. Kila aina ya chanzo ipo, hata ikiwa na idadi sifuri. html_url ni ukurasa wetu wa habari hiyo. url ni chombo kikuu. Kaupr inabaki kuwa chanzo cha habari tu.
Matukio#
Matukio yajayo na yaliyopita yako kwenye /api/v1/events.json. Kalenda za Luma huchukuliwa kutoka URL ya umma ya iCal ya kujisajili kwenye kila chanzo cha matukio (ics). Kurasa za miji, kurasa za kategoria na API ya discover ya Luma hazitumiki. Ukurasa wa tukio moja la Luma husomwa kama JSON-LD ya schema.org. Waandaaji na kumbi za Eventbrite husomwa kwa API v3 seva inapokuwa na EVENTBRITE_TOKEN. Tokeni hiyo haimo kwenye mlisho huu na haijahifadhiwa kwenye hazina. Bila hiyo, JSON-LD ya ukurasa wa tukio hutumika. Kichwa, tarehe na ukumbi uleule ni tukio moja. Matukio yaliyokwisha hubaki kwenye mlisho. description.text ni maneno ya mwandaaji mwenyewe, description.lang ni lugha ya maandishi hayo, na description.source_url ni ukurasa yalikotoka. description.i18n ina tafsiri pale tunapokuwa nayo. Sehemu hii ni null ikiwa chanzo hakikuwa na maelezo. Matangazo ya makongamano ya kinyonyaji si chanzo. Kaupr kamwe si mfadhili.
Lugha#
Kiingereza ndiyo sehemu chaguo-msingi (summary, title, text). Tafsiri tulizochapisha ziko kwenye summary_i18n, title_i18n, subtitle_i18n, note_i18n, text_i18n na about_i18n, kwa funguo nn, nb, sv, da, fi na is. Lugha nyingine za tovuti hutumia sehemu ya Kiingereza hadi tafsiri ichapishwe. Kwenye habari, title hubaki kichwa cha chanzo, title_en ni kichwa chetu cha Kiingereza na title_i18n ni kichwa chetu katika lugha za Nordiki za tovuti. Kurasa huonyesha kichwa cha lugha ya ukurasa kwanza na kichwa cha chanzo chini yake vinapotofautiana. Kichwa cha kila chombo, ndani ya sources, hubaki katika lugha ya chombo hicho. Tarehe zinafuata ISO 8601.
/api/v1/languages.json huorodhesha kila lugha ya tovuti pamoja na code, native_name, english_name, rtl, html_lang na home. /api/v1/geo-language.json ni ukisiaji wa lugha kulingana na nchi unaotumika katika ziara ya kwanza. Nchi ya IP hutoka kwa tipworker GET /api/geo (Cloudflare request.cf.country). Hakuna kinachohifadhiwa. Kidakuzi cha nc_lang, kinachowekwa na kibadilisha lugha, hushinda kila mara.
Nembo za vyanzo#
Kila chombo kwenye /api/v1/sources.json kina logo_url (URL kamili ya PNG au WebP, kamwe si SVG, au null) na logo (kind, file_url (asili, SVG au WebP), raster_url (sawa na logo_url), source_url, author, license, license_url, credit, au null). Kila habari ina source_logo_url, ili programu iweze kuonyesha nembo ya chombo kando ya kichwa cha habari. Nembo hutoka Wikimedia Commons (pamoja na leseni) au tovuti ya mchapishaji mwenyewe. Ni alama za biashara za wachapishaji, zinazoonyeshwa tu kutambulisha chanzo cha kichwa cha habari. Nembo hubaki null hadi mhariri aikague.
CORS#
GitHub Pages hutuma Access-Control-Allow-Origin: * kwa faili hizi, kwa hiyo ukurasa wa tovuti nyingine unaweza kuzipata kwa fetch(). GitHub Pages haitumii faili maalum la vichwa. Tumia jina la faili lenye .json; kufungua saraka hakurudishi JSON.
Uhariri#
Sahihi ni The Nordic Crypto team. Kaupr (kaupr.io) ni chanzo cha habari tu na kamwe si mfadhili. Hakuna kilichopo hapa ambacho ni ushauri wa uwekezaji.
Akaunti za chapa#
ios katika /api/v1/meta.json ni mwaliko wa umma wa TestFlight wa programu ya iOS ya Nordic Crypto. Haipo kwenye App Store. apple_tv inasema toleo la TestFlight linaunga mkono hasa Apple TV. apple_tv_i18n ina sentensi hiyo fupi katika kila lugha ya tovuti. Jina la chapa daima ni Nordic Crypto.
/api/v1/meta.json ina social kwa programu ya iOS. social.telegram ni gumzo la Nordic Crypto kwenye https://t.me/nordiccryptochat. social.x ni akaunti ya chapa kwenye https://x.com/nordiccryptobot (@nordiccryptobot), pia imeorodheshwa kama urls.x. urls.telegram hurudia URL ya gumzo. urls.rss ni mlisho wa habari wa Kiingereza kwenye /rss.xml. Ukurasa wa mwanzo wa kila lugha una rss.xml yake. urls.newsletter ni ukurasa wa kujisajili kwenye tovuti hii. label ni jina fupi (Telegram, X). name ni maandishi ya kiungo kwa Kiingereza. name_i18n ina nn, nb, sv, da, fi na is. Lugha nyingine za tovuti hutumia name.
Arifa za kivinjari#
Wakati workers/push/public.json ina URL ya Worker, kitufe kilicho chini ya kila ukurasa ni Web Push. Hadi hapo, ukurasa husema huduma haijawashwa na hauiti Worker yoyote. Usajili huhifadhiwa kwenye Cloudflare Worker, si kwenye mlisho huu tuli. Baada ya kuchapisha, GET /api/push/feed.json kwenye Worker hiyo huorodhesha makundi yale yale (kichwa, muhtasari mfupi, URL, nchi, na tafsiri tunapokuwa nazo). Uchapishaji mmoja ni kundi moja. Hati inasema "apns": "not implemented": Apple Push Notification service haimo kwenye wigo. Programu ya iOS inaweza kukagua mlisho mara kwa mara. URL ya Worker huwekwa wakati workers/push/ inapozinduliwa; si njia kwenye tovuti hii. Usajili haumo kwenye mlisho. /api/v1/news.json ya API hii inabaki kuwa orodha kamili ya habari zilizochapishwa.
Endpoints#
Kila endpoint ni GET rahisi ya faili tuli la JSON.
| Njia | Hurudisha |
|---|---|
/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). |
Visivyojumuishwa#
Rasimu, foleni ya mhariri, habari zilizokataliwa, taarifa kutoka kwa wasomaji, anwani za wanaojisajili kwenye jarida, tokeni ya uchanganuzi na data binafsi hazimo kwenye mlisho huu. Kitambulisho kisichojulikana hurudisha ukurasa wa kawaida wa 404 wa tovuti, si hitilafu ya JSON.