Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to CoinMarketCal

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the CoinMarketCal connection

    In AgentKit > Connections, create a CoinMarketCal connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. 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.actions
    const connector = 'coinmarketcal'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'coinmarketcal_categories_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • coinmarketcal_categories_listList every CoinMarketCal event category with its count of upcoming events.Read-only

    List 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-only

    Get 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-only

    List 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-only

    List 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-only

    Get 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-only

    List 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-only

    Get 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-only

    Get 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.