-
Notifications
You must be signed in to change notification settings - Fork 5
GetCardanoWalletNFTSongs
Walter Lara edited this page Jul 17, 2024
·
4 revisions
Allows to get all NFT Songs for all connected wallets of the requesting User.
URL: /v1/cardano/nft/songs
Method: GET
Path Parameters: None
Query Parameters:
Parameter | Type | Description | Requirement Type |
---|---|---|---|
legacy | boolean | Indicates if songs from legacy (non CIP-60 compliant) NFTs should be included. Default is false
|
Optional |
Headers:
Authorization: Bearer {accessToken}
Accept: application/json
Code: 200 OK
Headers:
Content-Type: application/json
Content:
Field | Type | Description | Condition |
---|---|---|---|
id | string | UUID of the Song. Generated based on the src field from the metadata. |
Always |
policyId | string | NFT Policy ID. | Always |
assetName | string | NFT Asset Name. | Always |
isStreamToken | boolean | Indicates if the asset is a NEWM Stream Token. | Always |
amount | integer | NFT amount in the specified wallet. | Always |
title | string | Song title. | Always |
imageUrl | string | NFT image file URL. | Always |
audioUrl | string | Song audio file URL. | Always |
duration | integer | Song duration in seconds, or -1 if unkonwn | Always |
artists | string array | Song artist names. | Always |
genres | string array | Song genres. | Always |
moods | string array | Song moods. | Always |
Content example:
[
{
"id": "d1822705-0de8-3d9e-b7d0-b8059c82b627",
"policyId": "46e607b3046a34c95e7c29e47047618dbf5e10de777ba56c590cfd5c",
"assetName": "NEWM_0",
"isStreamToken": true,
"amount": 16000,
"title": "Bigger Dreams",
"imageUrl": "https://arweave.net/CuPFY2Ln7yUUhJX09G530kdPf93eGhAVlhjrtR7Jh5w",
"audioUrl": "https://arweave.net/P141o0RDAjSYlVQgTDgHNAORQTkMYIVCprmD_dKMVss",
"duration": 240,
"artists": [
"MURS"
],
"genres": [
"Hip Hop",
"Rap"
],
"moods": [
"Feel Good"
]
},
{
"id": "ad95578f-2bb9-36e0-abee-c2469d83b0b6",
"policyId": "123da5e4ef337161779c6729d2acd765f7a33a833b2a21a063ef65a5",
"assetName": "SickCity432",
"isStreamToken": false,
"amount": 1,
"title": "What's In Yo Wallet?",
"imageUrl": "https://ipfs.io/ipfs/QmPEYCRebuK5tojA4YbXAv9ZkapakJL4YxZybTNceQ8Ymj",
"audioUrl": "https://ipfs.io/ipfs/QmZ5byw9CW2ChPWeoq6czT7SRxygj1a4RC1MMyTzsR1UUv",
"duration": 132,
"artists": [
"Richy Lifty"
],
"genres": [
"hip hop",
"rap"
],
"moods": []
}
]
Code: 401 UNAUTHORIZED
Condition: If {accessToken}
is invalid or expired.