Get Trending Winners
GET/tracks/trending/winners
Gets weekly trending winners from the trending_results table. Returns track objects for the specified week. Defaults to the most recent week with data when no week is provided.
Request
Query Parameters
week date
Target week in YYYY-MM-DD format. Defaults to the most recent week with data.
user_id string
The user ID of the user making the request
Responses
- 200
- 400
- 500
Success
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
Array [
]
]
Array [
]
Array [
]
Array [
]
Array [
]
Array [
]
Array [
]
Array [
]
- tip_gate
- follow_gate
- purchase_gate
- token_gate
Array [
]
- tip_gate
- follow_gate
- purchase_gate
- token_gate
Array [
]
]
latest_chain_block integerrequired
latest_indexed_block integerrequired
latest_chain_slot_plays integerrequired
latest_indexed_slot_plays integerrequired
signature stringrequired
timestamp stringrequired
version
object
required
service stringrequired
version stringrequired
data
object[]
artwork
object
required
150x150 string
480x480 string
1000x1000 string
mirrors string[]
description string
genre stringrequired
id stringrequired
track_cid string
preview_cid string
orig_file_cid string
orig_filename string
is_original_available booleanrequired
mood string
release_date date
remix_of
object
required
tracks
object[]
parent_track_id stringrequired
user
object
required
album_count integerrequired
artist_pick_track_id string
artist_coin_badge
object
required
mint string
logo_uri string
banner_image_url string
ticker string
The coin symbol/ticker
coin_flair_mint string
bio string
cover_photo
object
640x string
2000x string
mirrors string[]
followee_count integerrequired
follower_count integerrequired
handle stringrequired
id stringrequired
is_verified booleanrequired
twitter_handle string
instagram_handle string
tiktok_handle string
verified_with_twitter booleanrequired
verified_with_instagram booleanrequired
verified_with_tiktok booleanrequired
website string
donation string
location string
name stringrequired
playlist_count integerrequired
profile_picture
object
150x150 string
480x480 string
1000x1000 string
mirrors string[]
repost_count integerrequired
track_count integerrequired
is_deactivated booleanrequired
is_available booleanrequired
erc_wallet stringrequired
spl_wallet stringrequired
spl_usdc_wallet stringrequired
spl_usdc_payout_wallet string
supporter_count integerrequired
supporting_count integerrequired
total_audio_balance integerrequired
wallet stringrequired
The user's Ethereum wallet address for their account
balance stringrequired
associated_wallets_balance stringrequired
total_balance stringrequired
waudio_balance stringrequired
associated_sol_wallets_balance stringrequired
blocknumber integerrequired
created_at stringrequired
is_storage_v2 booleanrequired
creator_node_endpoint string
current_user_followee_follow_count integerrequired
does_current_user_follow booleanrequired
does_current_user_subscribe booleanrequired
does_follow_current_user booleanrequired
handle_lc stringrequired
updated_at stringrequired
cover_photo_sizes string
cover_photo_cids
object
640x string
2000x string
mirrors string[]
cover_photo_legacy string
profile_picture_sizes string
profile_picture_cids
object
150x150 string
480x480 string
1000x1000 string
mirrors string[]
profile_picture_legacy string
has_collectibles booleanrequired
playlist_library
object
contents
object[]
allow_ai_attribution booleanrequired
profile_type string
has_remix_author_reposted booleanrequired
has_remix_author_saved booleanrequired
repost_count integerrequired
favorite_count integerrequired
comment_count integerrequired
tags string
title stringrequired
user
object
required
album_count integerrequired
artist_pick_track_id string
artist_coin_badge
object
required
mint string
logo_uri string
banner_image_url string
ticker string
The coin symbol/ticker
coin_flair_mint string
bio string
cover_photo
object
640x string
2000x string
mirrors string[]
followee_count integerrequired
follower_count integerrequired
handle stringrequired
id stringrequired
is_verified booleanrequired
twitter_handle string
instagram_handle string
tiktok_handle string
verified_with_twitter booleanrequired
verified_with_instagram booleanrequired
verified_with_tiktok booleanrequired
website string
donation string
location string
name stringrequired
playlist_count integerrequired
profile_picture
object
150x150 string
480x480 string
1000x1000 string
mirrors string[]
repost_count integerrequired
track_count integerrequired
is_deactivated booleanrequired
is_available booleanrequired
erc_wallet stringrequired
spl_wallet stringrequired
spl_usdc_wallet stringrequired
spl_usdc_payout_wallet string
supporter_count integerrequired
supporting_count integerrequired
total_audio_balance integerrequired
wallet stringrequired
The user's Ethereum wallet address for their account
balance stringrequired
associated_wallets_balance stringrequired
total_balance stringrequired
waudio_balance stringrequired
associated_sol_wallets_balance stringrequired
blocknumber integerrequired
created_at stringrequired
is_storage_v2 booleanrequired
creator_node_endpoint string
current_user_followee_follow_count integerrequired
does_current_user_follow booleanrequired
does_current_user_subscribe booleanrequired
does_follow_current_user booleanrequired
handle_lc stringrequired
updated_at stringrequired
cover_photo_sizes string
cover_photo_cids
object
640x string
2000x string
mirrors string[]
cover_photo_legacy string
profile_picture_sizes string
profile_picture_cids
object
150x150 string
480x480 string
1000x1000 string
mirrors string[]
profile_picture_legacy string
has_collectibles booleanrequired
playlist_library
object
contents
object[]
allow_ai_attribution booleanrequired
profile_type string
duration integerrequired
is_downloadable booleanrequired
play_count integerrequired
permalink stringrequired
is_streamable boolean
ddex_app string
playlists_containing_track integer[]
pinned_comment_id integer
album_backlink
object
playlist_id integerrequired
playlist_name stringrequired
permalink stringrequired
access
object
required
stream booleanrequired
download booleanrequired
blocknumber integerrequired
The blocknumber this track was last updated
create_date string
cover_art_sizes stringrequired
cover_art_cids
object
150x150 string
480x480 string
1000x1000 string
created_at stringrequired
credits_splits string
isrc string
license string
iswc string
field_visibility
object
required
mood booleanrequired
tags booleanrequired
genre booleanrequired
share booleanrequired
play_count booleanrequired
remixes booleanrequired
followee_reposts
object[]
required
repost_item_id stringrequired
repost_type stringrequired
user_id stringrequired
has_current_user_reposted booleanrequired
is_scheduled_release booleanrequired
is_unlisted booleanrequired
has_current_user_saved booleanrequired
followee_favorites
object[]
required
favorite_item_id stringrequired
favorite_type stringrequired
user_id stringrequired
created_at stringrequired
route_id stringrequired
stem_of
object
category stringrequired
parent_track_id integerrequired
track_segments
object[]
required
duration numberrequired
multihash stringrequired
updated_at stringrequired
user_id stringrequired
is_delete booleanrequired
cover_art string
is_available booleanrequired
ai_attribution_user_id integer
allowed_api_keys string[]
audio_upload_id string
preview_start_seconds number
bpm number
is_custom_bpm boolean
musical_key string
is_custom_musical_key boolean
audio_analysis_error_count integer
comments_disabled boolean
ddex_release_ids
object
artists
object[]
resource_contributors
object[]
nullable
name stringrequired
Possible values: non-empty
Contributor name
roles string[]required
Possible values: >= 1
Contributor roles
sequence_number integer
Sequence number for ordering
indirect_resource_contributors
object[]
nullable
name stringrequired
Possible values: non-empty
Contributor name
roles string[]required
Possible values: >= 1
Contributor roles
sequence_number integer
Sequence number for ordering
rights_controller
object
nullable
DDEX rights controller
name stringrequired
Possible values: non-empty
roles string[]required
Possible values: >= 1
rights_share_unknown string
Optional
copyright_line
object
nullable
year stringrequired
Possible values: >= 4 characters and <= 4 characters
Copyright year (4 characters)
text stringrequired
Possible values: non-empty
Copyright text
producer_copyright_line
object
nullable
year stringrequired
Possible values: >= 4 characters and <= 4 characters
Copyright year (4 characters)
text stringrequired
Possible values: non-empty
Copyright text
parental_warning_type stringnullable
is_stream_gated booleanrequired
Whether or not the owner has restricted streaming behind an access gate
stream_conditions
object
oneOf
tip_user_id integerrequired
Must tip the given user ID to unlock
follow_user_id integerrequired
Must follow the given user ID to unlock
usdc_purchase
object
required
Must pay the total price and split to the given addresses to unlock
price integerrequired
The price in USDC needed to unlock
splits
object[]
required
user_id integerrequired
percentage numberrequired
token_gate
object
required
Must hold an NFT of the given collection to unlock
token_mint stringrequired
The mint of the token needed to unlock
token_amount integerrequired
The amount of the token needed to unlock
is_download_gated booleanrequired
Whether or not the owner has restricted downloading behind an access gate
download_conditions
object
oneOf
tip_user_id integerrequired
Must tip the given user ID to unlock
follow_user_id integerrequired
Must follow the given user ID to unlock
usdc_purchase
object
required
Must pay the total price and split to the given addresses to unlock
price integerrequired
The price in USDC needed to unlock
splits
object[]
required
user_id integerrequired
percentage numberrequired
token_gate
object
required
Must hold an NFT of the given collection to unlock
token_mint stringrequired
The mint of the token needed to unlock
token_amount integerrequired
The amount of the token needed to unlock
cover_original_song_title string
cover_original_artist string
is_owned_by_user booleanrequired
Indicates whether the track is owned by the user for MRI sake
stream
object
required
url string
mirrors string[]required
download
object
required
url string
mirrors string[]required
preview
object
required
url string
mirrors string[]required
{
"latest_chain_block": 0,
"latest_indexed_block": 0,
"latest_chain_slot_plays": 0,
"latest_indexed_slot_plays": 0,
"signature": "string",
"timestamp": "string",
"version": {
"service": "string",
"version": "string"
},
"data": [
{
"artwork": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"description": "string",
"genre": "string",
"id": "string",
"track_cid": "string",
"preview_cid": "string",
"orig_file_cid": "string",
"orig_filename": "string",
"is_original_available": true,
"mood": "string",
"release_date": "2026-02-21",
"remix_of": {
"tracks": [
{
"parent_track_id": "string",
"user": {
"album_count": 0,
"artist_pick_track_id": "string",
"artist_coin_badge": {
"mint": "string",
"logo_uri": "string",
"banner_image_url": "string",
"ticker": "string"
},
"coin_flair_mint": "string",
"bio": "string",
"cover_photo": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"followee_count": 0,
"follower_count": 0,
"handle": "string",
"id": "string",
"is_verified": true,
"twitter_handle": "string",
"instagram_handle": "string",
"tiktok_handle": "string",
"verified_with_twitter": true,
"verified_with_instagram": true,
"verified_with_tiktok": true,
"website": "string",
"donation": "string",
"location": "string",
"name": "string",
"playlist_count": 0,
"profile_picture": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"repost_count": 0,
"track_count": 0,
"is_deactivated": true,
"is_available": true,
"erc_wallet": "string",
"spl_wallet": "string",
"spl_usdc_wallet": "string",
"spl_usdc_payout_wallet": "string",
"supporter_count": 0,
"supporting_count": 0,
"total_audio_balance": 0,
"wallet": "string",
"balance": "string",
"associated_wallets_balance": "string",
"total_balance": "string",
"waudio_balance": "string",
"associated_sol_wallets_balance": "string",
"blocknumber": 0,
"created_at": "string",
"is_storage_v2": true,
"creator_node_endpoint": "string",
"current_user_followee_follow_count": 0,
"does_current_user_follow": true,
"does_current_user_subscribe": true,
"does_follow_current_user": true,
"handle_lc": "string",
"updated_at": "string",
"cover_photo_sizes": "string",
"cover_photo_cids": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"cover_photo_legacy": "string",
"profile_picture_sizes": "string",
"profile_picture_cids": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"profile_picture_legacy": "string",
"has_collectibles": true,
"playlist_library": {
"contents": [
{}
]
},
"allow_ai_attribution": true,
"profile_type": "string"
},
"has_remix_author_reposted": true,
"has_remix_author_saved": true
}
]
},
"repost_count": 0,
"favorite_count": 0,
"comment_count": 0,
"tags": "string",
"title": "string",
"user": {
"album_count": 0,
"artist_pick_track_id": "string",
"artist_coin_badge": {
"mint": "string",
"logo_uri": "string",
"banner_image_url": "string",
"ticker": "string"
},
"coin_flair_mint": "string",
"bio": "string",
"cover_photo": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"followee_count": 0,
"follower_count": 0,
"handle": "string",
"id": "string",
"is_verified": true,
"twitter_handle": "string",
"instagram_handle": "string",
"tiktok_handle": "string",
"verified_with_twitter": true,
"verified_with_instagram": true,
"verified_with_tiktok": true,
"website": "string",
"donation": "string",
"location": "string",
"name": "string",
"playlist_count": 0,
"profile_picture": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"repost_count": 0,
"track_count": 0,
"is_deactivated": true,
"is_available": true,
"erc_wallet": "string",
"spl_wallet": "string",
"spl_usdc_wallet": "string",
"spl_usdc_payout_wallet": "string",
"supporter_count": 0,
"supporting_count": 0,
"total_audio_balance": 0,
"wallet": "string",
"balance": "string",
"associated_wallets_balance": "string",
"total_balance": "string",
"waudio_balance": "string",
"associated_sol_wallets_balance": "string",
"blocknumber": 0,
"created_at": "string",
"is_storage_v2": true,
"creator_node_endpoint": "string",
"current_user_followee_follow_count": 0,
"does_current_user_follow": true,
"does_current_user_subscribe": true,
"does_follow_current_user": true,
"handle_lc": "string",
"updated_at": "string",
"cover_photo_sizes": "string",
"cover_photo_cids": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"cover_photo_legacy": "string",
"profile_picture_sizes": "string",
"profile_picture_cids": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"profile_picture_legacy": "string",
"has_collectibles": true,
"playlist_library": {
"contents": [
{}
]
},
"allow_ai_attribution": true,
"profile_type": "string"
},
"duration": 0,
"is_downloadable": true,
"play_count": 0,
"permalink": "string",
"is_streamable": true,
"ddex_app": "string",
"playlists_containing_track": [
0
],
"pinned_comment_id": 0,
"album_backlink": {
"playlist_id": 0,
"playlist_name": "string",
"permalink": "string"
},
"access": {
"stream": true,
"download": true
},
"blocknumber": 0,
"create_date": "string",
"cover_art_sizes": "string",
"cover_art_cids": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string"
},
"created_at": "string",
"credits_splits": "string",
"isrc": "string",
"license": "string",
"iswc": "string",
"field_visibility": {
"mood": true,
"tags": true,
"genre": true,
"share": true,
"play_count": true,
"remixes": true
},
"followee_reposts": [
{
"repost_item_id": "string",
"repost_type": "string",
"user_id": "string"
}
],
"has_current_user_reposted": true,
"is_scheduled_release": true,
"is_unlisted": true,
"has_current_user_saved": true,
"followee_favorites": [
{
"favorite_item_id": "string",
"favorite_type": "string",
"user_id": "string",
"created_at": "string"
}
],
"route_id": "string",
"stem_of": {
"category": "string",
"parent_track_id": 0
},
"track_segments": [
{
"duration": 0,
"multihash": "string"
}
],
"updated_at": "string",
"user_id": "string",
"is_delete": true,
"cover_art": "string",
"is_available": true,
"ai_attribution_user_id": 0,
"allowed_api_keys": [
"string"
],
"audio_upload_id": "string",
"preview_start_seconds": 0,
"bpm": 0,
"is_custom_bpm": true,
"musical_key": "string",
"is_custom_musical_key": true,
"audio_analysis_error_count": 0,
"comments_disabled": true,
"ddex_release_ids": {},
"artists": [
{}
],
"resource_contributors": [
{
"name": "string",
"roles": [
"string"
],
"sequence_number": 0
}
],
"indirect_resource_contributors": [
{
"name": "string",
"roles": [
"string"
],
"sequence_number": 0
}
],
"rights_controller": {
"name": "string",
"roles": [
"string"
],
"rights_share_unknown": "string"
},
"copyright_line": {
"year": "string",
"text": "string"
},
"producer_copyright_line": {
"year": "string",
"text": "string"
},
"parental_warning_type": "string",
"is_stream_gated": true,
"stream_conditions": {
"tip_user_id": 0
},
"is_download_gated": true,
"download_conditions": {
"tip_user_id": 0
},
"cover_original_song_title": "string",
"cover_original_artist": "string",
"is_owned_by_user": true,
"stream": {
"url": "string",
"mirrors": [
"string"
]
},
"download": {
"url": "string",
"mirrors": [
"string"
]
},
"preview": {
"url": "string",
"mirrors": [
"string"
]
}
}
]
}
Bad request
Server error
Loading...