Sign in
tracks

Creates a new track

post/tracks

Query parameters

user_idstring required

The user ID of the user making the request

Request body

track_idstring

Optional track ID (will be generated if not provided)

titlestring required

Track title

genrestring required

Music genre. Any string up to 100 characters is accepted. Known/canonical values (shown as autocomplete suggestions in clients): Electronic, Rock, Metal, Alternative, Hip-Hop/Rap, Experimental, Punk, Folk, Pop, Ambient, Soundtrack, World, Jazz, Acoustic, Funk, R&B/Soul, Devotional, Classical, Reggae, Podcasts, Country, Spoken Word, Comedy, Blues, Kids, Audiobooks, Latin, Lo-Fi, Hyperpop, Dancehall, Techno, Trap, House, Tech House, Deep House, Disco, Electro, Jungle, Progressive House, Hardstyle, Glitch Hop, Trance, Future Bass, Future House, Tropical House, Downtempo, Drum & Bass, Dubstep, Jersey Club, Vaporwave, Moombahton.

descriptionstring nullable

Track description

mood'Peaceful' | 'Romantic' | 'Sentimental' | 'Tender' | 'Easygoing' | 'Yearning' | 'Sophisticated' | 'Sensual' | 'Cool' | 'Gritty' | 'Melancholy' | 'Serious' | 'Brooding' | 'Fiery' | 'Defiant' | 'Aggressive' | 'Rowdy' | 'Excited' | 'Energizing' | 'Empowering' | 'Stirring' | 'Upbeat' | 'Other'

Music mood

bpmnumber nullable

Beats per minute (tempo)

musical_keystring nullable

Musical key of the track

tagsstring nullable

Comma-separated tags

licensestring nullable

License type

isrcstring nullable

International Standard Recording Code

iswcstring nullable

International Standard Musical Work Code

release_datestring date

Release date

track_cidstring required

CID for the track audio file (required)

orig_file_cidstring

CID for the original track file

orig_filenamestring

Original filename of the track

cover_art_sizesstring

CID for the track cover art

preview_cidstring

CID for the track preview

preview_start_secondsnumber float

Preview start time in seconds

durationnumber float

Track duration in seconds

is_downloadableboolean

Whether the track is downloadable

is_unlistedboolean

Whether the track is unlisted

is_stream_gatedboolean nullable

Whether streaming is restricted behind an access gate

access_authoritiesstring[] nullable

Wallet addresses that can sign to authorize stream access (programmable distribution). When empty or omitted, the track is public and validator/creator nodes can serve it.

allowed_api_keysstring[] nullable

API keys allowed to stream this track

placement_hostsstring

Placement hosts for the track

ddex_appstring nullable

DDEX application identifier

ddex_release_idsobject nullable

DDEX release identifiers

artistsobject[] nullable

DDEX resource contributors / artists

parental_warning_typestring nullable

Parental warning type

cover_original_song_titlestring nullable

Original song title for cover tracks

cover_original_artiststring nullable

Original artist for cover tracks

is_owned_by_userboolean

Whether the track is owned by the user

territory_codesstring[] nullable

Territory codes for distribution

no_ai_useboolean

Whether AI use is prohibited

Example request

{
  "track_id": "x5pJ3Az",
  "title": "My New Track",
  "stream_conditions": {
    "usdc_purchase": {
      "splits": [
        {
          "user_id": 1234
        }
      ]
    }
  },
  "download_conditions": {
    "usdc_purchase": {
      "splits": [
        {
          "user_id": 1234
        }
      ]
    }
  },
  "remix_of": {
    "tracks": [
      {
        "parent_track_id": "x5pJ3Az"
      }
    ]
  }
}

Response

Track created successfully

transaction_hashstring

The blockchain transaction hash

block_hashstring

The blockchain block hash

block_numberinteger

The blockchain block number/height

track_idstring

The ID of the created track

Changes