Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Coinranking

Scalekit connector
Open markdown

The Coinranking connector lets your AI agent act in each user's Coinranking account. Each user connects their own Coinranking API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.

Tools
59
What they doRead · write · destructive
59 · 0 · 059 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 Coinranking connection

    In AgentKit > Connections, create a Coinranking 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 = 'coinranking'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Coinranking:', 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: 'coinranking_assets_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Coinranking 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
  • coinranking_assets_listList non-crypto and derivative assets in groups: fiat currencies, wrapped and staked tokens, commodities, indices and stocks.Read-only

    List Assets

    List non-crypto and derivative assets in groups: fiat currencies, wrapped and staked tokens, commodities, indices and stocks. Returns status and data with fiat, wrapped, staked, commodities, indices, stocks. Use types to pick groups.

    Inputs

    cursorstring
    Cursor for pagination. Use the nextCursor value from the previous response to get the next grouped page, or previousCursor to navigate back. One cursor advances every selected asset-type array. Use it with the same types and limit values as the request that created it. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
    limitinteger
    Limit used for pagination. It applies separately to every selected asset-type array. For example, a limit of 10 can return up to 10 fiat currencies and 10 stocks in the same response. The maximum is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
    reference_currency_uuidstring
    UUID of the currency in which all prices, market caps, volumes, sparklines, and all-time-high prices are calculated. Defaults to US Dollar, but you can use any supported reference currency. You can find UUIDs in the dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
    typesarray
    Asset types to include. By default, all asset types are selected. The response always includes every asset-type array; arrays that were not requested are returned empty. Example: ["fiat", "wrapped"]
  • coinranking_bitcoin_dominance_history_getGet Bitcoin's share of the total market cap over a time period.Read-only

    Get Bitcoin Dominance History

    Get Bitcoin's share of the total market cap over a time period. Returns status and data with timestamp, percentage, marketCap. Use this to track BTC dominance. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

    Inputs

    reference_currency_uuidstring
    UUID of coin (either fiat or crypto), in which all the market caps are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
    time_periodstring
    Timeperiod where the percentage and marketCap are based on The maximum timePeriod is 1y for Free, 5y for Basic, and all for Startup and higher plans. These historical windows apply to both preview and production requests. Defaults to 24h. Example: 24h.one of 1h3h12h24h7d30d3m1y3y5yall
  • coinranking_blockchain_getGet one blockchain by name with its total number of coins.Read-only

    Get Blockchain

    Get one blockchain by name with its total number of coins. Returns status and data with blockchain; items include name, totalCoins. Use coinranking_blockchains_list for valid names. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

    Inputs

    blockchainstringrequired
    Name of the blockchain you want to request. You can find a list of all possible values by making a request to blockchains endpoint. Example: ethereum.
  • coinranking_blockchains_listList the blockchains Coinranking supports.Read-only

    List Blockchains

    List the blockchains Coinranking supports. Returns status and data with blockchains. Use the names with coinranking_blockchain_get or coinranking_coin_by_contract_get. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

    Inputs

    This tool takes no inputs.

  • coinranking_coin_atr_getGet a coin's 14-period Average True Range, a volatility measure in the reference currency.Read-only

    Get Coin ATR

    Get a coin's 14-period Average True Range, a volatility measure in the reference currency. Returns status and data with startingAt, atr. Choose interval to set the candle size. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

    Inputs

    uuidstringrequired
    Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
    intervalstring
    Candle size each data point is based on. If omitted, a default is picked from time_period. Allowed intervals depend on time_period: 1h minute or 5minutes; 3h and 12h up to hour; 24h up to 8hours; 7d hour to day; 30d hour to week; 3m hour to month; 1y and longer day to month. Example: 8hours.one of minute5minuteshour8hoursdayweekmonth
    reference_currency_uuidstring
    UUID of coin (either fiat or crypto), in whose terms the price is measured before the ATR is calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint The returned atr is a price in this currency, so this choice sets both the calculation and the units it comes back in. The conversion happens before the calculation, so the ATR of a coin priced in Bitcoin is a genuinely different series from its ATR priced in US Dollars — not a rescaling of it. Example: 5k-_VTxqtCEI.
    time_periodstring
    The time period for which the ATR data is returned. The number of data points and the default interval are determined by the time period. Example: 24h.one of 1h3h12h24h7d30d3m1y3y5y10yall
  • coinranking_coin_blockchains_listList the blockchains a coin is issued on, with contract references and block explorer links.Read-only

    List Coin Blockchains

    List the blockchains a coin is issued on, with contract references and block explorer links. Returns status and data with total, issuanceBlockchains; items include name, referenceName, reference, blockExplorerUrl, migratedToReference, migrationDate. Use this to find a token's contract on each chain. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

    Inputs

    uuidstringrequired
    Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
    cursorstring
    Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
    limitinteger
    Limit. Used for pagination. Defaults to 50. Example: 50.
  • coinranking_coin_by_contract_getFind the Coinranking coin for a token contract address on a given blockchain.Read-only

    Get Coin By Contract Address

    Find the Coinranking coin for a token contract address on a given blockchain. Returns status and data with coin; items include UUID, name, symbol, contractAddresses, coinrankingUrl. Use this to turn a contract address into a coin UUID. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

    Inputs

    addressstringrequired
    Address of the token you want to request. This is the same address as is used on the blockchain the token is minted on. For example, the Tether (USDT) contract address on Ethereum is 0xdac17f958d2ee523a2206206994597c13d831ec7. In our case, the address is case-insensitive. Example: 0xdac17f958d2ee523a2206206994597c13d831ec7.
    blockchainstringrequired
    Name of the blockchain you want to request. You can find a list of all possible values by making a request to our blockchains endpoint. Example: ethereum.
  • coinranking_coin_by_external_id_getLook up a Coinranking coin by its CoinGecko or CoinMarketCap ID and get its full details.Read-only

    Get Coin By CoinGecko Or CMC ID

    Look up a Coinranking coin by its CoinGecko or CoinMarketCap ID and get its full details. Returns status and data with coin; items include uuid, symbol, name, description, color, iconUrl, websiteUrl, links, supply. Use this to map IDs from other data providers to Coinranking. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

    Inputs

    providerstringrequired
    The external data provider to resolve the coin from. Example: coingecko.one of coingeckocoinmarketcap
    provider_idstringrequired
    The ID of the coin on the external provider's platform. Example (CoinGecko): bitcoin, ethereum, tether Example (CoinMarketCap): 1 (Bitcoin), 1027 (Ethereum). Example: bitcoin.
    reference_currency_uuidstring
    UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
    time_periodstring
    Time period where the change and sparkline are based on The maximum timePeriod is 1y for Free and 5y for all paid plans. This endpoint supports up to five years of data. These limits apply to both preview and production requests. Defaults to 24h. Example: 24h.one of 1h3h12h24h7d30d3m1y3y5y