Coins

Coins represent individual cryptocurrencies tracked in MyHold. Use the coin tools to search for assets, retrieve details by public ID or CoinMarketCap slug, and add new coins to the platform.

Slug lookup

Every CoinMarketCap coin has a unique human-readable slug (e.g. bitcoin, ethereum, solana). Use get-coin-by-slug when you know the slug but not the internal coin ID.

MCP Tools#

AI agents can interact with Coins through the MyHold MCP server:

ToolDescription
search-coinsSearch for available cryptocurrencies by name or symbol.
get-coinGet full details and latest quote for a coin by its public ID.
get-coin-by-slugGet full details and latest quote for a coin by its CoinMarketCap slug (e.g. "bitcoin", "ethereum").
add-coinAdd a new coin to the platform by CoinMarketCap UCID or slug.

Lookup by Slug#

Each coin has a CoinMarketCap slug — a lowercase, hyphen-separated identifier that is stable over time. Use get-coin-by-slug to fetch coin details when you know the slug but not the internal ID.

CoinSlug
Bitcoinbitcoin
Ethereumethereum
Solanasolana
Binance Coinbinancecoin
USD Coinusd-coin

💡 Slug normalisation

Slugs are case-insensitive and trimmed automatically. Passing Bitcoin or bitcoin returns the same result as bitcoin.

Response Fields#

Both get-coin and get-coin-by-slug return the same coin object with an attached latestQuote block.

Coin object

FieldTypeDescription
idstringInternal public ID (used in all other MCP tools)
namestringFull coin name
symbolstringTicker symbol (e.g. BTC, ETH)
slugstringCoinMarketCap slug
ucidnumberCoinMarketCap numeric ID
logoUrlstring | nullURL of the coin logo image

latestQuote block

FieldTypeDescription
pricenumber | nullCurrent price in USD
volume24hnumber | null24-hour trading volume in USD
percentChange24hnumber | null% price change over the last 24 hours
percentChange7dnumber | null% price change over the last 7 days
marketCapnumber | nullMarket capitalisation in USD

Next Steps#

For API details, visit the API documentation.