GetCardanoWalletNFTSongs

Get Cardano Wallet NFT Songs

Allows to get all NFT Songs for all connected wallets of the requesting User.

Request

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

✅ Success Response

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": []
    }
]

❌ Error Responses

1. Unauthorized

Code: 401 UNAUTHORIZED

Condition: If {accessToken} is invalid or expired.