Repo: https://github.com/nina-protocol/nina-indexer.
Public API endpoint: https://api.ninaprotocol.com/v1
API Explorer on Nina Dev
JS-SDK on NPM
Accounts
describe instances of Users on Nina and are created when a wallet interacts with the Nina program in any way.
An Account's publicKey
is the the address of the Solana wallet that owns the Account
.
Relations:
published
: Releases published by an Accountcollected
: Releases currently held by an Accountexchanges
: Exchanges exchanges opened, cancelled, or completed by an Accounthubs
: Hubs that an account is a collaborator onposts
: Posts that an account has publishedrevenueShares
: Releases that an Account has a revenue share on{- "accounts": [
- {
- "collected": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
], - "published": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
], - "hubs": [
- {
- "publicKey": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF",
- "handle": "ninas-picks",
- "data": {
- "displayName": "Nina's Picks",
- "description": "Nina's Picks is a collection of the best music from Nina.",
- "descriptionHtml": "<p>Nina's Picks is a collection of the best music from Nina.</p>"
}, - "datetime": "2020-01-01T00:00:00Z",
- "authority": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25"
}
], - "posts": [
- {
- "publicKey": "3Afmiq7pXRnxaSY3wH2fQqoHNoWPXBf6eSMPuQnPxRHE",
- "data": {
- "title": "Nina's Picks",
- "body": "Nina's Picks is a collection of the best music from Nina.",
- "bodyHtml": "Nina's Picks is a collection of the best music from Nina.",
- "reference": "B49JXQLs7RKCkX3PvtrXhuxE9EbmnJjfPSoqpQXLa3Kg"
}, - "datetime": "2020-01-01T00:00:00Z",
- "publisher": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25",
- "publishedThrough": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF"
}
], - "exchanges": [
- {
- "publicKey": "2w1LbxjmPRHjhFpfMuvhLVhqZrNpTfdLo9nYptvZD2YK",
- "isSale": true,
- "expectedAmount": "249.00",
- "initializerAmount": "1.00",
- "cancelled": false,
- "createdAt": "2020-01-01T00:00:00Z",
- "updatedAt": "2020-01-01T00:00:00Z",
- "completedBy": "EmQVguncDATg1m9mgZcfJ5aDbvg5u3QXPfvfesyYXAW5",
- "release": "E9KmAF9cXLE3kehLQf9j9XTQsAqCWEP9VL5W3KVNtcqo",
- "initializer": "HesfTj24Eatwy8vvra5UdhX1xJWLeqRM7QdDwjX1xmmk"
}
], - "revenueShares": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
]
}
], - "total": 100
}
publicKey required | string Example: 52xYtQzDaxeTGcz3WD37mAJgqVFAzR72EnGYaSHab5DQ The publicKey of the Account to be fetched |
{- "collected": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
], - "published": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
], - "hubs": [
- {
- "publicKey": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF",
- "handle": "ninas-picks",
- "data": {
- "displayName": "Nina's Picks",
- "description": "Nina's Picks is a collection of the best music from Nina.",
- "descriptionHtml": "<p>Nina's Picks is a collection of the best music from Nina.</p>"
}, - "datetime": "2020-01-01T00:00:00Z",
- "authority": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25"
}
], - "posts": [
- {
- "publicKey": "3Afmiq7pXRnxaSY3wH2fQqoHNoWPXBf6eSMPuQnPxRHE",
- "data": {
- "title": "Nina's Picks",
- "body": "Nina's Picks is a collection of the best music from Nina.",
- "bodyHtml": "Nina's Picks is a collection of the best music from Nina.",
- "reference": "B49JXQLs7RKCkX3PvtrXhuxE9EbmnJjfPSoqpQXLa3Kg"
}, - "datetime": "2020-01-01T00:00:00Z",
- "publisher": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25",
- "publishedThrough": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF"
}
], - "exchanges": [
- {
- "publicKey": "2w1LbxjmPRHjhFpfMuvhLVhqZrNpTfdLo9nYptvZD2YK",
- "isSale": true,
- "expectedAmount": "249.00",
- "initializerAmount": "1.00",
- "cancelled": false,
- "createdAt": "2020-01-01T00:00:00Z",
- "updatedAt": "2020-01-01T00:00:00Z",
- "completedBy": "EmQVguncDATg1m9mgZcfJ5aDbvg5u3QXPfvfesyYXAW5",
- "release": "E9KmAF9cXLE3kehLQf9j9XTQsAqCWEP9VL5W3KVNtcqo",
- "initializer": "HesfTj24Eatwy8vvra5UdhX1xJWLeqRM7QdDwjX1xmmk"
}
], - "revenueShares": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
]
}
publicKey required | string The publicKey of the Account to be fetched |
{- "collected": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
]
}
An Array of all Exhanges this Account has created or completed.
publicKey required | string The publicKey of the Account to be fetched |
{- "exchanges": [
- {
- "publicKey": "2w1LbxjmPRHjhFpfMuvhLVhqZrNpTfdLo9nYptvZD2YK",
- "isSale": true,
- "expectedAmount": "249.00",
- "initializerAmount": "1.00",
- "cancelled": false,
- "createdAt": "2020-01-01T00:00:00Z",
- "updatedAt": "2020-01-01T00:00:00Z",
- "completedBy": "EmQVguncDATg1m9mgZcfJ5aDbvg5u3QXPfvfesyYXAW5",
- "release": "E9KmAF9cXLE3kehLQf9j9XTQsAqCWEP9VL5W3KVNtcqo",
- "initializer": "HesfTj24Eatwy8vvra5UdhX1xJWLeqRM7QdDwjX1xmmk"
}
]
}
An Array of all Hubs this Account is a collaborator on.
publicKey required | string The publicKey of the Account to be fetched |
{- "hubs": [
- {
- "publicKey": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF",
- "handle": "ninas-picks",
- "data": {
- "displayName": "Nina's Picks",
- "description": "Nina's Picks is a collection of the best music from Nina.",
- "descriptionHtml": "<p>Nina's Picks is a collection of the best music from Nina.</p>"
}, - "datetime": "2020-01-01T00:00:00Z",
- "authority": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25"
}
]
}
An Array of all Posts this Account has published.
publicKey required | string The publicKey of the Account to be fetched |
{- "posts": [
- {
- "publicKey": "3Afmiq7pXRnxaSY3wH2fQqoHNoWPXBf6eSMPuQnPxRHE",
- "data": {
- "title": "Nina's Picks",
- "body": "Nina's Picks is a collection of the best music from Nina.",
- "bodyHtml": "Nina's Picks is a collection of the best music from Nina.",
- "reference": "B49JXQLs7RKCkX3PvtrXhuxE9EbmnJjfPSoqpQXLa3Kg"
}, - "datetime": "2020-01-01T00:00:00Z",
- "publisher": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25",
- "publishedThrough": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF"
}
]
}
An Array of all Releases this Account has published.
publicKey required | string The publicKey of the Account to be fetched |
{- "published": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
]
}
Exchanges
are instances of Secondary Market activity through the Nina program.
An Exchange
may describe an open, cancelled, or completed exchange.
If exchange.cancelled
is true
, the exchange
is cancelled and the on-chain Exchange account has been closed.
If exchange.completedBy
is not null the exchange
has been completed.
Cancelled and Completed Exchanges have had their on-chain accounts closed - you can no longer them on-chain.
{- "exchanges": [
- {
- "publicKey": "2w1LbxjmPRHjhFpfMuvhLVhqZrNpTfdLo9nYptvZD2YK",
- "isSale": true,
- "expectedAmount": "249.00",
- "initializerAmount": "1.00",
- "cancelled": false,
- "createdAt": "2020-01-01T00:00:00Z",
- "updatedAt": "2020-01-01T00:00:00Z",
- "completedBy": "EmQVguncDATg1m9mgZcfJ5aDbvg5u3QXPfvfesyYXAW5",
- "release": "E9KmAF9cXLE3kehLQf9j9XTQsAqCWEP9VL5W3KVNtcqo",
- "initializer": "HesfTj24Eatwy8vvra5UdhX1xJWLeqRM7QdDwjX1xmmk"
}
], - "total": 500
}
publicKey required | string The publicKey of the Exchange to be fetched |
{- "publicKey": "2w1LbxjmPRHjhFpfMuvhLVhqZrNpTfdLo9nYptvZD2YK",
- "isSale": true,
- "expectedAmount": "249.00",
- "initializerAmount": "1.00",
- "cancelled": false,
- "createdAt": "2020-01-01T00:00:00Z",
- "updatedAt": "2020-01-01T00:00:00Z",
- "completedBy": "EmQVguncDATg1m9mgZcfJ5aDbvg5u3QXPfvfesyYXAW5",
- "release": "E9KmAF9cXLE3kehLQf9j9XTQsAqCWEP9VL5W3KVNtcqo",
- "initializer": "HesfTj24Eatwy8vvra5UdhX1xJWLeqRM7QdDwjX1xmmk"
}
Hubs
are a Nina primitive that allow anyone to create a collection of Releases and Posts. Some examples of Hubs are:
Read more about Hubs here.
A Hub has:
{- "hubs": [
- {
- "publicKey": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF",
- "handle": "ninas-picks",
- "data": {
- "displayName": "Nina's Picks",
- "description": "Nina's Picks is a collection of the best music from Nina.",
- "descriptionHtml": "<p>Nina's Picks is a collection of the best music from Nina.</p>"
}, - "datetime": "2020-01-01T00:00:00Z",
- "authority": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25"
}
], - "total": 21
}
publicKeyOrHandle required | string Examples:
The publicKey or handle of the Hub to be fetched |
{- "hub": {
- "publicKey": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF",
- "handle": "ninas-picks",
- "data": {
- "displayName": "Nina's Picks",
- "description": "Nina's Picks is a collection of the best music from Nina.",
- "descriptionHtml": "<p>Nina's Picks is a collection of the best music from Nina.</p>"
}, - "datetime": "2020-01-01T00:00:00Z",
- "authority": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25"
}, - "collaborators": [
- {
- "publicKey": "string",
- "hubCollaboratorPublicKey": "string"
}
], - "releases": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
], - "posts": [
- {
- "publicKey": "3Afmiq7pXRnxaSY3wH2fQqoHNoWPXBf6eSMPuQnPxRHE",
- "data": {
- "title": "Nina's Picks",
- "body": "Nina's Picks is a collection of the best music from Nina.",
- "bodyHtml": "Nina's Picks is a collection of the best music from Nina.",
- "reference": "B49JXQLs7RKCkX3PvtrXhuxE9EbmnJjfPSoqpQXLa3Kg"
}, - "datetime": "2020-01-01T00:00:00Z",
- "publisher": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25",
- "publishedThrough": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF"
}
]
}
publicKeyOrHandle required | string Examples:
The publicKey of the Hub to be fetched |
{- "collaborators": [
- {
- "publicKey": "7Z4Bvx6kqLvRF6tseWG9dkj1Xy4G5hJs4BV78ecddG7P"
}
], - "publicKey": "BY2CWqiV5oUWvLcSfGhcg6a75mNG5uLKLDAKMmaYnuix"
}
publicKeyOrHandle required | string Examples:
The publicKey of the Hub to be fetched |
{- "posts": [
- {
- "publicKey": "3Afmiq7pXRnxaSY3wH2fQqoHNoWPXBf6eSMPuQnPxRHE",
- "data": {
- "title": "Nina's Picks",
- "body": "Nina's Picks is a collection of the best music from Nina.",
- "bodyHtml": "Nina's Picks is a collection of the best music from Nina.",
- "reference": "B49JXQLs7RKCkX3PvtrXhuxE9EbmnJjfPSoqpQXLa3Kg"
}, - "datetime": "2020-01-01T00:00:00Z",
- "publisher": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25",
- "publishedThrough": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF"
}
], - "publicKey": "BY2CWqiV5oUWvLcSfGhcg6a75mNG5uLKLDAKMmaYnuix"
}
publicKeyOrHandle required | string Examples:
The publicKey of the Hub to be fetched |
{- "releases": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
], - "publicKey": "BY2CWqiV5oUWvLcSfGhcg6a75mNG5uLKLDAKMmaYnuix"
}
{- "posts": [
- {
- "publicKey": "3Afmiq7pXRnxaSY3wH2fQqoHNoWPXBf6eSMPuQnPxRHE",
- "data": {
- "title": "Nina's Picks",
- "body": "Nina's Picks is a collection of the best music from Nina.",
- "bodyHtml": "Nina's Picks is a collection of the best music from Nina.",
- "reference": "B49JXQLs7RKCkX3PvtrXhuxE9EbmnJjfPSoqpQXLa3Kg"
}, - "datetime": "2020-01-01T00:00:00Z",
- "publisher": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25",
- "publishedThrough": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF"
}
], - "total": 21
}
publicKey required | string The publicKey of the Post to be fetched |
{- "post": {
- "publicKey": "3Afmiq7pXRnxaSY3wH2fQqoHNoWPXBf6eSMPuQnPxRHE",
- "data": {
- "title": "Nina's Picks",
- "body": "Nina's Picks is a collection of the best music from Nina.",
- "bodyHtml": "Nina's Picks is a collection of the best music from Nina.",
- "reference": "B49JXQLs7RKCkX3PvtrXhuxE9EbmnJjfPSoqpQXLa3Kg"
}, - "datetime": "2020-01-01T00:00:00Z",
- "publisher": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25",
- "publishedThrough": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF"
}, - "publisher": {
- "publicKey": "string"
}, - "publishedThroughHub": {
- "publicKey": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF",
- "handle": "ninas-picks",
- "data": {
- "displayName": "Nina's Picks",
- "description": "Nina's Picks is a collection of the best music from Nina.",
- "descriptionHtml": "<p>Nina's Picks is a collection of the best music from Nina.</p>"
}, - "datetime": "2020-01-01T00:00:00Z",
- "authority": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25"
}
}
Releases
are a Nina primitive that connects metadata and audio files hosted on Arweave to an account on Solana which handles provenance, purchases, and revenue shares.
Relations:
exchanges
: Exchanges for the Release
(open, cancelled, or completed)collectors
: Accounts that currently hold the Release
hubs
: Hubs that the Release
has been published or reposted torevenueShareRecipients
: Accounts that have a Revenue Share in the Release
(each Release
can have a maximum of 10 revenueShares
with 0-100% share always adding up to 100% across all revenueShares
){- "releases": [
- {
- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
], - "total": 500
}
publicKey required | string Example: 7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35 The publicKey of the Release to be fetched |
{- "publicKey": "7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35",
- "mint": "H6XNpJSQzGyaEaax8XbM2TMNCmgS8BiFZisffHYPgd4y",
- "metadata": {
- "name": "Lxrd_Ox - Take The Reigns",
- "symbol": 8,
- "description": "Celebrating the events of July 30, 2022. All proceeds to benefit Cozy Corner chicken finger summits.",
- "attributes": [ ],
- "collection": {
- "name": "Torn Hawk - For Nick & Frances (Nina)",
- "family": "Nina"
}, - "properties": {
- "artist": "Torn Hawk",
- "title": "For Nick & Frances",
- "date": "2022-08-15T16:33:35.439Z",
- "md5Digest": "5c28619f254b0cde1c11fa5ac7007ad4",
- "files": [
- {
- "track": 0,
- "track_title": "For Nick & Frances",
- "duration": null,
- "type": "audio/mpeg"
}
], - "category": "Audio"
}, - "descriptionHtml": "string"
}, - "datetime": "2022-08-15T16:33:37.000Z",
- "publishedThroughHub": "FXfR3cqeTZBWi3eGMwh3vFpR7teJYNqUiqfnnmRFPy1C",
- "publisher": "4nnJ47qxEoD54tbnhd9pFjDeit5qvjZDh5oA95QXT5fq"
}
publicKey required | string The publicKey of the Release to be fetch Hubs for |
{- "hubs": [
- {
- "publicKey": "Gwg6hGU3BaBfcgaidX46HxQ7R513bgAvxqfztUsL31KF",
- "handle": "ninas-picks",
- "data": {
- "displayName": "Nina's Picks",
- "description": "Nina's Picks is a collection of the best music from Nina.",
- "descriptionHtml": "<p>Nina's Picks is a collection of the best music from Nina.</p>"
}, - "datetime": "2020-01-01T00:00:00Z",
- "authority": "5JcXwSDJwtvDvuaTeChEXWGFDwjZDfUBPvtDKp9fbc25"
}
]
}
publicKey required | string The publicKey of the Release to be fetch Hubs for |
{- "exchanges": [
- {
- "publicKey": "2w1LbxjmPRHjhFpfMuvhLVhqZrNpTfdLo9nYptvZD2YK",
- "isSale": true,
- "expectedAmount": "249.00",
- "initializerAmount": "1.00",
- "cancelled": false,
- "createdAt": "2020-01-01T00:00:00Z",
- "updatedAt": "2020-01-01T00:00:00Z",
- "completedBy": "EmQVguncDATg1m9mgZcfJ5aDbvg5u3QXPfvfesyYXAW5",
- "release": "E9KmAF9cXLE3kehLQf9j9XTQsAqCWEP9VL5W3KVNtcqo",
- "initializer": "HesfTj24Eatwy8vvra5UdhX1xJWLeqRM7QdDwjX1xmmk"
}
]
}
Case insensitive Search
endpoint that will return data that matches the query from Hubs
, Releases
and Artists
Operation description markdown.
requestBody description
query | string The body of the search query |
{- "query": "Nina"
}
{- "artists": [
- {
- "name": "Torn Hawk",
- "publicKey": "J1Uk2DNkcBaCmfzrXbe2TN5MQYNpszhvWaYrSNh5bkFX"
}
], - "releases": [
- {
- "artist": "Torn Hawk",
- "title": "string",
- "image": "\"https://www.arweave.net/9iaOiHKGXNNVXH2_txoFeP4Da4P3VvjAwGS4szE3Uco\"",
- "publicKey": "\"7tufjgdTJ2mzgnHLctmUd6Hz3ze68dtR3Ekp1ch5rU35\""
}
], - "hubs": [
- {
- "handle": "tornhawkcity-",
- "publicKey": "\"7Pc1WR8Rxt9UAgphNUA4jd8TXRFWuQhHyAG4jEhzbFkY\"",
}
]
}