The CoinMarketCal connector lets your AI agent act in each user's CoinMarketCal account. Each user connects their own CoinMarketCal API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 8 tools.
- Tools
- 8
- What they doRead · write · destructive
- 8 · 0 · 08 read0 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the CoinMarketCal connection
In AgentKit > Connections, create a CoinMarketCal connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'coinmarketcal'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize CoinMarketCal:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'coinmarketcal_categories_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "coinmarketcal"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize CoinMarketCal:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="coinmarketcal_categories_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their CoinMarketCal credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcoinmarketcal_categories_listList every CoinMarketCal event category with its count of upcoming events.Read-onlyList Event Categories
List every CoinMarketCal event category with its count of upcoming events. Returns the categories with id, name and event counts for your plan's window. Not paginated. Use this to get category IDs for coinmarketcal_events_list.
Inputs
This tool takes no inputs.
coinmarketcal_coin_getGet one coin from CoinMarketCal by its slug.Read-onlyGet Coin
Get one coin from CoinMarketCal by its slug. Returns the coin with slug, symbol, name, rank, tracking status and event counts. Unknown slugs return 404. Use this to check a coin before filtering events by it.
Inputs
slugstringrequired- Lowercase coin slug, from coinmarketcal_coins_list. Example: bitcoin.
coinmarketcal_coins_listList the coins in the CoinMarketCal database, ordered by rank, optionally searched by name or symbol.Read-onlyList Coins
List the coins in the CoinMarketCal database, ordered by rank, optionally searched by name or symbol. Returns data (coins with slug, symbol, name, rank and event counts) and meta.cursor for paging. Use this to find a coin slug for coinmarketcal_events_list or coinmarketcal_coin_get.
Inputs
cursorstring- Opaque cursor from the previous response's meta.cursor, to get the next page. A null meta.cursor means there are no more pages. Example: eyJvZmZzZXQiOjUwfQ.
limitinteger- Page size, from 1 to 200. Example: 50.
qstring- Case-insensitive text to match in coin name or symbol. Example: sol.
trackedboolean- true for coins CoinMarketCal actively covers, false for coins outside coverage; omit for both. Example: true.
coinmarketcal_event_cancellations_listList CoinMarketCal events that were permanently removed, ordered by removal time.Read-onlyList Removed Events
List CoinMarketCal events that were permanently removed, ordered by removal time. Returns data (records with the event ID and cancelledAt) and meta.cursor for paging. Use this to drop removed events from a local copy of the calendar.
Inputs
cursorstring- Opaque cursor from the previous response's meta.cursor, to get the next page. A null meta.cursor means there are no more pages. Example: eyJvZmZzZXQiOjUwfQ.
limitinteger- Page size, from 1 to 100. Example: 50.
sincestring- Earliest removal time, as an RFC 3339 timestamp or YYYY-MM-DD date. Defaults to 90 days ago. Example: 2026-10-01.
coinmarketcal_event_getGet the full details of one CoinMarketCal event by its ID.Read-onlyGet Crypto Event
Get the full details of one CoinMarketCal event by its ID. Returns the event with title, description, date, dateType, isEstimated, categories, coins and plan-dependent fields such as impact, sources and proof. Removed events return 410 and unknown ones 404. Use this after coinmarketcal_events_list to read one event.
Inputs
idstringrequired- Event ID exactly as returned by coinmarketcal_events_list. Example: evt_01JQ8Z4S2M9Y7K3P6D1A.
coinmarketcal_events_listList upcoming and past cryptocurrency events (releases, listings, upgrades, conferences and more) from the CoinMarketCal calendar, filtered by coin, category, date range or keyword.Read-onlyList Crypto Events
List upcoming and past cryptocurrency events (releases, listings, upgrades, conferences and more) from the CoinMarketCal calendar, filtered by coin, category, date range or keyword. Returns data (events with id, slug, title, description, date, dateType, isEstimated, categories, coins and plan-dependent fields such as impact and sources) and meta.cursor for paging. Use this to find events. Use coinmarketcal_event_get for one event's full details. The date window and some filters depend on your plan.
Inputs
categoriesstring- Comma-separated category IDs from coinmarketcal_categories_list. Standard plan and higher; the Free plan gets 403. Example: release,exchange.
coinsstring- Comma-separated coin slugs (preferred) or tickers. Get slugs from coinmarketcal_coins_list. Example: bitcoin,ethereum.
cursorstring- Opaque cursor from the previous response's meta.cursor, to get the next page. A null meta.cursor means there are no more pages. Example: eyJvZmZzZXQiOjUwfQ.
fromstring- Inclusive earliest event date (ISO 8601). Defaults to today; how far back you can go depends on your plan. Example: 2026-11-16.
impact_minnumber- Minimum impact score, 0.0 to 10.0. Elite plan and higher. Example: 7.5.
keywordstring- Case-insensitive text to search event titles and descriptions for. Example: mainnet.
limitinteger- Page size, from 1 to 100. Example: 50.
sort_bystring- Sort order: date_asc (default, soonest first), date_desc, created_desc, created_desc_and_updated_desc or impact_desc (Elite plan and higher). Example: date_asc.one of
date_ascdate_desccreated_desccreated_desc_and_updated_descimpact_desc tostring- Inclusive latest event date (ISO 8601). Defaults to today plus your plan's window (7 days on Free, 90 on Standard). Example: 2026-12-31.
coinmarketcal_events_snapshot_getGet the current daily snapshot of the complete CoinMarketCal events catalog.Read-onlyGet Events Catalog Snapshot
Get the current daily snapshot of the complete CoinMarketCal events catalog. Returns generatedAt, expiresAt, format (csv.gz), rowCount and a private downloadUrl valid for 15 minutes. Use this to bulk-load the whole catalog. Use coinmarketcal_events_list for filtered queries.
Inputs
This tool takes no inputs.
coinmarketcal_usage_getGet this month's request counters for your CoinMarketCal API key.Read-onlyGet API Usage
Get this month's request counters for your CoinMarketCal API key. Returns tier, periodYm, requestCount, monthlyQuota, remaining and quotaResetAt. Use this to check the remaining quota before many requests.
Inputs
This tool takes no inputs.
No tools match.