GetMultiChainNFTSongs

Get Multi-Chain NFT Songs

This endpoint returns a list of music NFT songs that the authenticated user owns or has access to across supported blockchains (currently Cardano and Ethereum).

Request

URL: /v1/nft/songs

Method: GET

Path Parameters: None

Query Parameters: None

Headers:

Authorization: Bearer {accessToken}

Accept: application/json

✅ Success Response

Code: 200 OK

Headers:

Content-Type: application/json

Content:

Array of song objects.

Song Object:

Field	Type	Description	Condition
id	string (UUID)	Internal song ID	Always
title	string	Song title	Always
imageUrl	string	Cover art URL	Always
audioUrl	string	Audio file URL	Always
duration	integer	Seconds (-1 = unknown)	Always
artists	string[]	Artist names	Always
genres	string[]	Genres	Always
moods	string[]	Moods/vibes	Always
allocations	object[]	Wallet allocations (see bellow)	Always
amount	integer	Quantity held (≥1)	Always
chainMetadata	object	Chain-specific data (see below)	Always

Allocation Object:

Field	Type	Description	Condition
id	string (UUID)	Wallet connection ID	Always
amount	integer	Quantity held (≥1)	Always

CardanoChainMetadata Object:

Field	Type	Description	Condition
chain	string	"Cardano"	Always
fingerprint	string	Asset fingerprint	Always
policyId	string	Policy ID	Always
assetName	string	Asset name (hex/UTF-8)	Always
isStreamToken	boolean	true for NEWM stream tokens	Always

EthereumChainMetadata Object:

Field	Type	Description	Condition
chain	string	"Ethereum"	Always
contractAddress	string	Contract Address	Always
tokenType	string	Token Type (e.g, "ERC721")	Always
tokenId	string	Token ID	Always

Content example:

[
   {
      "id":"cf42d678-e7e7-3986-9cca-3f2d42461c5f",
      "title":"Daisuke",
      "imageUrl":"https://asset1effvlkkw02m9ft3ymlkfld8mhlq05wc2hal5du.newm.nftcdn.io/image?...",
      "audioUrl":"https://asset1effvlkkw02m9ft3ymlkfld8mhlq05wc2hal5du.newm.nftcdn.io/files/0?...",
      "duration":200,
      "artists":[
         "Danketsu",
         "Mirai Music",
         "NSTASIA"
      ],
      "genres":[
         "Pop",
         "House",
         "Tribal"
      ],
      "moods":[
         "Spiritual"
      ],
      "amount":1000000,
      "allocations":[
         {
            "id":"170c0a9b-0216-4429-b8a5-15a094dd2e38",
            "amount":400000
         },
         {
            "id":"2556cf60-c924-40f0-89c5-2eabbe07d1c1",
            "amount":600000
         }
      ],
      "chainMetadata":{
         "chain":"Cardano",
         "fingerprint":"asset1effvlkkw02m9ft3ymlkfld8mhlq05wc2hal5du",
         "policyId":"46e607b3046a34c95e7c29e47047618dbf5e10de777ba56c590cfd5c",
         "assetName":"NEWM_5",
         "isStreamToken":true
      }
   },
   {
      "id":"4faf291f-060d-318a-a1d9-3e64288127c4",
      "title":"A Little Rain Must Fall",
      "imageUrl":".../107.png",
      "audioUrl":".../A%20Little%20Rain%20Must%20Fall.mp3",
      "duration":-1,
      "artists":[
         "Violetta Zironi"
      ],
      "genres":[
         
      ],
      "moods":[
         
      ],
      "amount":1,
      "allocations":[
         {
            "id":"f524574f-4377-48da-80eb-f116d0d05c76",
            "amount":1
         }
      ],
      "chainMetadata":{
         "chain":"Ethereum",
         "contractAddress":"0x328B49C56a8A15fb34aB3eCD8883Fac5F9512453",
         "tokenType":"ERC721",
         "tokenId":"107"
      }
   }
]

❌ Error Responses

1. Unauthorized

Code: 401 UNAUTHORIZED

Condition: If {accessToken} is invalid or expired.