Practical overview
When it fits
Use the SDK when a JavaScript project needs documented read access to Nina Protocol data through the Nina API.
Who it is for
- JavaScript developers building tools or interfaces around Nina Protocol data
- Developers exploring release, artist, collector or hub information
Documented uses
- Fetch all Nina releases or retrieve one release with account data
- Look up collectors and their collections for a release
- Load a hub with its releases, collaborators and posts
- Search artists, releases and hubs
Requirements & limits
- The SDK provides fetch and search interfaces; transaction and publishing operations are described as future work.
- The README documents installation with either npm or Yarn and initialization with
Nina.client.init(). - The repository identifies JavaScript as its primary language and Apache-2.0 as its license.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the SDK and initialize its client
Add the Nina Protocol JavaScript SDK to a project and initialize its client before using its documented query interfaces.
Before you start
- A JavaScript project
- npm or Yarn
Steps
Install the package with the command below or
yarn add @nina-protocol/js-sdk.npm install @nina-protocol/js-sdkImport
Ninafrom@nina-protocol/js-sdk.Call
Nina.client.init().
Expected outcome
The package is installed and the SDK client is initialized for the documented fetch and search calls.
Guide limitations
- These steps cover setup only; the README documents fetching data, while write operations are described as future work.
Fetch and search Nina Protocol data
Use documented SDK calls to retrieve a release, hub data or search results after initializing the client.
Before you start
- The SDK installed and
Nina.client.init()called - A release identifier for release-specific lookups or a hub handle for a hub lookup
Steps
Call
Nina.Release.fetchAll()to fetch Nina releases.For a specific release, call
Nina.Release.fetch(releaseId, true)orNina.Release.fetchCollectors(releaseId, true)to include collector data and collections.Call
Nina.Hub.fetch(handle)to retrieve a hub with its releases, collaborators and posts.Call
Nina.Search.withQuery(query)to search artists, releases and hubs.
Expected outcome
The documented calls return release, collector, hub or search data from Nina Protocol.
Guide limitations
- The documented interfaces fetch data; they do not perform purchases, publish releases or repost releases to hubs.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- nina-protocol/js-sdk · Official homepage title · retained in its source language

