Get Coins

GET 
/coins

Gets information about coins

Request

Query Parameters

mint string[]

The mint addresses of the coins

owner_id string[]

The user IDs of artists with minted coins

ticker string[]

The tickers of the coins

query string

Search by the coin name or ticker

offset integer

Default value: 0

The number of items to skip. Useful for pagination (page number * limit)

limit integer

Possible values: >= 1 and <= 100

Default value: 50

The number of items to fetch

sort_method string

Possible values: [market_cap, volume, price, created_at, holder]

Default value: market_cap

Field to use for sorting the results

sort_direction string

Possible values: [asc, desc]

Default value: desc

The sort direction

Responses

200

Success

application/json

Schema

Schema

data

object[]

required

Array [

name stringrequired

The coin name

ticker string

The coin symbol

mint stringrequired

The coin mint address

decimals integerrequired

The number of decimals for the coin

owner_id stringrequired

The ID of the user associated with the coin

escrow_recipient string

The escrow recipient address for custom-created coins without DBCs

logo_uri string

URL to the coin's logo image

banner_image_url string

URL to the coin's banner image

description string

A longform description about the coin

website string

The official website for the coin

link_1 string

Generic link URL for the coin

link_2 string

Generic link URL for the coin

link_3 string

Generic link URL for the coin

link_4 string

Generic link URL for the coin

has_discord booleanrequired

Whether the coin has a Discord server

created_at stringrequired

The date and time when the coin was added to Audius.

address string

The SPL token mint address

symbol string

The token symbol

marketCap numberrequired

Market capitalization in USD

fdv numberrequired

Fully diluted valuation in USD

extensions

object

Token metadata and links

coingeckoId string

CoinGecko ID

description string

Token description

twitter string

Twitter URL

website string

Website URL

discord string

Discord invite URL

liquidity numberrequired

Current liquidity in USD

lastTradeUnixTime integerrequired

Unix timestamp of the last trade

lastTradeHumanTime stringrequired

ISO8601 time of the last trade

price numberrequired

Current price in USD

history24hPrice numberrequired

Price 24 hours ago in USD

priceChange24hPercent numberrequired

24h price change in percent

uniqueWallet24h integerrequired

Unique wallets traded in last 24h

uniqueWalletHistory24h integerrequired

Unique wallets traded in previous 24h

uniqueWallet24hChangePercent numberrequired

24h change in unique wallets (percent)

totalSupply numberrequired

Total supply of the token

circulatingSupply numberrequired

Circulating supply of the token

holder integerrequired

Number of holders

trade24h integerrequired

Number of trades in last 24h

tradeHistory24h integerrequired

Number of trades in previous 24h

trade24hChangePercent numberrequired

24h change in trade count (percent)

sell24h integerrequired

Number of sell trades in last 24h

sellHistory24h integerrequired

Number of sell trades in previous 24h

sell24hChangePercent numberrequired

24h change in sell trades (percent)

buy24h integerrequired

Number of buy trades in last 24h

buyHistory24h integerrequired

Number of buy trades in previous 24h

buy24hChangePercent numberrequired

24h change in buy trades (percent)

v24h numberrequired

24h trading volume (token units)

v24hUSD numberrequired

24h trading volume in USD

vHistory24h numberrequired

Previous 24h trading volume (token units)

vHistory24hUSD number

Previous 24h trading volume in USD

v24hChangePercent number

24h change in volume (percent)

vBuy24h number

24h buy volume (token units)

vBuy24hUSD number

24h buy volume in USD

vBuyHistory24h number

Previous 24h buy volume (token units)

vBuyHistory24hUSD number

Previous 24h buy volume in USD

vBuy24hChangePercent number

24h change in buy volume (percent)

vSell24h number

24h sell volume (token units)

vSell24hUSD number

24h sell volume in USD

vSellHistory24h number

Previous 24h sell volume (token units)

vSellHistory24hUSD number

Previous 24h sell volume in USD

vSell24hChangePercent number

24h change in sell volume (percent)

numberMarkets integer

Number of markets the token is traded on

totalVolume numberrequired

Total volume of coin traded (all time)

totalVolumeUSD numberrequired

Total volume of coin traded in USD (all time)

volumeBuy numberrequired

Total volume bought (all time)

volumeBuyUSD numberrequired

Total volume bought in USD (all time)

volumeSell numberrequired

Total volume sold (all time)

volumeSellUSD numberrequired

Total volume sold in USD (all time)

totalTrade integerrequired

Total number of trades (all time)

buy integerrequired

Total number of buys (all time)

sell integerrequired

Total number of sells (all time)

dynamicBondingCurve

object

required

Information about the dynamic bonding curve if one exists for the Coin

address stringrequired

Address of the bonding curve pool

price numberrequired

Current price in the pool's quote token (e.g., AUDIO)

priceUSD numberrequired

Current price in USD

curveProgress numberrequired

Progress along the bonding curve (0.0 - 1.0)

isMigrated boolean

Whether the bonding curve has been migrated

creatorQuoteFee numberrequired

Creator quote fee for the bonding curve

totalTradingQuoteFee numberrequired

Total trading quote fee accumulated

creatorWalletAddress stringrequired

Address of the pool creator's wallet

artist_fees

object

Information about the fees earned by the artist on the coin's trading.

unclaimed_fees number

Total unclaimed fees from all sources, in $AUDIO.

total_fees number

Total fees earned from all sources, in $AUDIO.

artist_locker

object

Information about the artist locker associated with the coin.

address string

The address of the artist locker.

locked number

The amount currently locked in the artist locker.

unlocked number

The amount currently unlocked in the artist locker.

claimable number

The amount claimable from the artist locker. Eg. the amount unlocked that hasn't already been claimed.

reward_pool

object

Information about the reward pool associated with the coin.

address string

The address of the reward pool.

balance number

The current balance of the reward pool.

]

Example (from schema)

{
  "data": [
    {
      "name": "Bonk Inu",
      "ticker": "$BONK",
      "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "decimals": 5,
      "owner_id": "7eP5n",
      "escrow_recipient": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "logo_uri": "https://arweave.net/hQiPZOsRZXGXBJd_82PhVdlM_hACsT_q6wqwf5cSY7I",
      "banner_image_url": "https://example.com/banner.png",
      "description": "The Official Bonk Inu token\nLorem ipsum dolor sit amet, consectetur adipiscing elit.",
      "website": "https://www.bonkcoin.com/",
      "link_1": "https://x.com/bear_token",
      "link_2": "https://instagram.com/bear_token",
      "link_3": "https://tiktok.com/@bear_token",
      "link_4": "https://bear-token.com",
      "has_discord": true,
      "created_at": "2023-10-01T12:00:00Z",
      "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "symbol": "BONK",
      "marketCap": 2625779824.994664,
      "fdv": 2625779824.994664,
      "extensions": {
        "coingeckoId": "bonk",
        "description": "The Official Bonk Inu token",
        "twitter": "https://twitter.com/bonk_inu",
        "website": "https://www.bonkcoin.com/",
        "discord": "https://discord.gg/ubqvDDFUhf"
      },
      "liquidity": 18977326.389274083,
      "lastTradeUnixTime": 1752620592,
      "lastTradeHumanTime": "2025-07-15T23:03:12",
      "price": 0.000029571022098881748,
      "history24hPrice": 0.000027195701160436288,
      "priceChange24hPercent": 8.73417796596848,
      "uniqueWallet24h": 20242,
      "uniqueWalletHistory24h": 21155,
      "uniqueWallet24hChangePercent": -4.315764594658473,
      "totalSupply": 88795707372386.03,
      "circulatingSupply": 88795707372386.03,
      "holder": 957291,
      "trade24h": 449987,
      "tradeHistory24h": 390400,
      "trade24hChangePercent": 15.263063524590164,
      "sell24h": 223845,
      "sellHistory24h": 191979,
      "sell24hChangePercent": 16.598690481771445,
      "buy24h": 226142,
      "buyHistory24h": 198421,
      "buy24hChangePercent": 13.970799461750522,
      "v24h": 2456470915352.043,
      "v24hUSD": 69961943.60091284,
      "vHistory24h": 1849367819551.6223,
      "vHistory24hUSD": 49529721.91224754,
      "v24hChangePercent": 32.82760137718911,
      "vBuy24h": 1267704208631.2197,
      "vBuy24hUSD": 35985775.23314727,
      "vBuyHistory24h": 926415751610.5529,
      "vBuyHistory24hUSD": 24916558.31987226,
      "vBuy24hChangePercent": 36.83966474310746,
      "vSell24h": 1188766706720.8232,
      "vSell24hUSD": 33976168.367765576,
      "vSellHistory24h": 922952067941.0695,
      "vSellHistory24hUSD": 24613163.592375275,
      "vSell24hChangePercent": 28.800481413161105,
      "numberMarkets": 317,
      "totalVolume": 158766463.26959822,
      "totalVolumeUSD": 20188521260.405678,
      "volumeBuy": 78227859.16098201,
      "volumeBuyUSD": 20188521260.405678,
      "volumeSell": 80538604.1086162,
      "volumeSellUSD": 20188521260.405678,
      "totalTrade": 258522892,
      "buy": 87829497,
      "sell": 170693395,
      "dynamicBondingCurve": {
        "address": "2AAsAwNPTNBk5N466xyPiwqdgbc5WLbDTdnn9gVuDKaN",
        "price": 0.0028402095736478586,
        "priceUSD": 0.000029571022098881748,
        "curveProgress": 0.75,
        "isMigrated": false,
        "creatorQuoteFee": 0.05,
        "totalTradingQuoteFee": 0.001,
        "creatorWalletAddress": "2AAsAwNPTNBk5N466xyPiwqdgbc5WLbDTdnn9gVuDKaN"
      },
      "artist_fees": {
        "unclaimed_fees": 2000000000,
        "total_fees": 4000000000
      },
      "artist_locker": {
        "address": "9bC8rd4qy4EQTHjvCoKFttk5W5km4tUFcVfASCDGro84",
        "locked": 499178082191780800,
        "unlocked": 821917808219178,
        "claimable": 821917808219178
      },
      "reward_pool": {
        "address": "6qUSoiMbTEZ4hpN3kuk5bjCRgcTJgUfXftVfTH1CSvZE",
        "balance": 1000000000
      }
    }
  ]
}

Loading...