Get Latest Listings with CoinMarketCap API on New Scraping Completed from WebScraper.IO API

Pipedream makes it easy to connect APIs for CoinMarketCap, WebScraper.IO and 2,500+ other apps remarkably fast.

Trigger workflow on

New Scraping Completed from the WebScraper.IO API

Next, do this

Get Latest Listings with the CoinMarketCap API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a WebScraper.IO trigger and CoinMarketCap action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Scraping Completed trigger
1. Connect your WebScraper.IO account
2. Configure timer
Configure the Get Latest Listings action
1. Connect your CoinMarketCap account
2. Optional- Configure start
3. Optional- Configure limit
4. Optional- Configure volume24hMin
5. Optional- Configure Convert
6. Optional- Configure Convert ID
7. Optional- Select a sort
8. Optional- Select a sortDir
9. Optional- Select a cryptocurrencyType
10. Optional- Select one or more Supplemental Fields
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Scraping Completed on WebScraper.IO

Description:Emit new event when a page scraping job has completed. [See the docs here](https://webscraper.io/documentation/web-scraper-cloud/api)

Version:0.0.1

Key:webscraper_io-new-scraping-completed

View on GitHub

WebScraper.IO Overview#

The WebScraper.IO API allows you to programmatically perform web scraping tasks, extracting structured data from websites. With the API, you can automate the gathering of web content for analysis, monitoring, and integration with other data sources. In Pipedream, you can leverage this API to build workflows that process, analyze, and act on the data you scrape without writing code for backend infrastructure.

Trigger Code#

import common from "../common/base.mjs";

export default {
  ...common,
  key: "webscraper_io-new-scraping-completed",
  name: "New Scraping Completed",
  description: "Emit new event when a page scraping job has completed. [See the docs here](https://webscraper.io/documentation/web-scraper-cloud/api)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    async emitHistoricalEvents({ limit }) {
      const jobs = await this.getScrapingJobs();
      if (!(jobs?.length > 0)) {
        return;
      }
      jobs.reverse().slice(0, limit)
        .forEach((job) => this.emitEvent(job));
    },
    isRelevant(job, previousIds) {
      return job.status === "finished" && !previousIds[job.id];
    },
    emitEvent(job) {
      const meta = this.generateMeta(job);
      this.$emit(job, meta);
    },
    generateMeta(job) {
      return {
        id: job.id,
        summary: job.sitemap_name,
        ts: job.time_created,
      };
    },
    async getScrapingJobs() {
      const jobs = [];
      const previousIds = this._getPreviousIds();

      const results = await this.webscraper.paginate(this.webscraper.getScrapingJobs);
      for (const job of results) {
        if (this.isRelevant(job, previousIds)) {
          previousIds[job.id] = true;
          jobs.push(job);
        }
      }

      this._setPreviousIds(previousIds);

      return jobs;
    },
  },
  async run() {
    const jobs = await this.getScrapingJobs();
    jobs.forEach((job) => this.emitEvent(job));
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
WebScraper.IO	`webscraper`	`app`	This component uses the WebScraper.IO app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

WebScraper.IO uses API keys for authentication. When you connect your WebScraper.IO account, Pipedream securely stores the keys so you can easily authenticate to WebScraper.IO APIs in both code and no-code steps.

" To retrieve your API token,

Navigate to your Web Scraper account and sign in
Go to “Account Info” > “API settings”"

About WebScraper.IO#

Making web data extraction easy and accessible for everyone.

Action#

Get Latest Listings on CoinMarketCap

Description:Returns a paginated list of all active cryptocurrencies with latest market data. [See the documentation](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest)

Version:0.1.2

Key:coinmarketcap-latest-listings

View on GitHub

CoinMarketCap Overview#

The CoinMarketCap API delivers real-time and historical cryptocurrency market data, including price, volume, market cap, and much more, for over 9,000 cryptocurrencies. With this data, you can track crypto trends, compare currency performance, or integrate up-to-date information into apps, widgets, or websites. Pipedream's platform enables developers to create automated workflows that can harness the vast array of data from CoinMarketCap to trigger actions, notify stakeholders, or power analytics dashboards.

Action Code#

// legacy_hash_id: a_rJiLNE
import coinmarketcap from "../../coinmarketcap.app.mjs";

export default {
  key: "coinmarketcap-latest-listings",
  name: "Get Latest Listings",
  description:
    "Returns a paginated list of all active cryptocurrencies with latest market data. [See the documentation](https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest)",
  version: "0.1.2",
  type: "action",
  props: {
    coinmarketcap,
    start: {
      type: "integer",
      description:
        "Optionally offset the start (1-based index) of the paginated list of items to return.",
      optional: true,
    },
    limit: {
      type: "integer",
      description:
        "Optionally specify the number of results to return. Use this parameter and the \"start\" parameter to determine your own pagination size.",
      optional: true,
    },
    volume24hMin: {
      type: "integer",
      description:
        "Optionally specify a threshold of minimum 24 hour USD volume to filter results by.",
      optional: true,
    },
    convert: {
      propDefinition: [
        coinmarketcap,
        "convert",
      ],
    },
    convertId: {
      propDefinition: [
        coinmarketcap,
        "convertId",
      ],
    },
    sort: {
      type: "string",
      description: "What field to sort the list of cryptocurrencies by.",
      optional: true,
      options: [
        "market_cap",
        "name",
        "symbol",
        "date_added",
        "market_cap_strict",
        "price",
        "circulating_supply",
        "total_supply",
        "max_supply",
        "num_market_pairs",
        "volume_24h",
        "percent_change_1h",
        "percent_change_24h",
        "percent_change_7d",
        "market_cap_by_total_supply_strict",
        "volume_7d",
        "volume_30d",
      ],
    },
    sortDir: {
      type: "string",
      description:
        "The direction in which to order cryptocurrencies against the specified sort.",
      optional: true,
      options: [
        "asc",
        "desc",
      ],
    },
    cryptocurrencyType: {
      type: "string",
      description: "The type of cryptocurrency to include.",
      optional: true,
      options: [
        "all",
        "coins",
        "tokens",
      ],
    },
    aux: {
      propDefinition: [
        coinmarketcap,
        "aux",
      ],
      options: [
        "num_market_pairs",
        "cmc_rank",
        "date_added",
        "tags",
        "platform",
        "max_supply",
        "circulating_supply",
        "total_supply",
        "market_cap_by_total_supply",
        "volume_24h_reported",
        "volume_7d",
        "volume_7d_reported",
        "volume_30d",
        "volume_30d_reported",
      ],
    },
  },
  async run({ $ }) {
    const response = await this.coinmarketcap._makeRequest({
      $,
      url: "/v1/cryptocurrency/listings/latest",
      params: {
        start: this.start,
        limit: this.limit,
        volume_24h_min: this.volume24hMin,
        convert: this.convert,
        convert_id: this.convertId,
        sort: this.sort,
        sort_dir: this.sortDir,
        cryptocurrency_type: this.cryptocurrencyType,
        aux: this.aux?.join?.(),
      },
    });
    $.export("$summary", "Successfully retrieved listings");
    return response;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
CoinMarketCap	`coinmarketcap`	`app`	This component uses the CoinMarketCap app.
start	`start`	`integer`	Optionally offset the start (1-based index) of the paginated list of items to return.
limit	`limit`	`integer`	Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
volume24hMin	`volume24hMin`	`integer`	Optionally specify a threshold of minimum 24 hour USD volume to filter results by.
Convert	`convert`	`string`	Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found at https://coinmarketcap.com/api/documentation/v1/#section/Standards-and-Conventions. Each conversion is returned in its own "quote" object.
Convert ID	`convertId`	`string`	Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: Convert ID = `1,2781` would replace Convert = `BTC,USD` in your query. This parameter cannot be used when Convert is used.
sort	`sort`	`string`	Select a value from the drop down menu:`market_capnamesymboldate_addedmarket_cap_strictpricecirculating_supplytotal_supplymax_supplynum_market_pairsvolume_24hpercent_change_1hpercent_change_24hpercent_change_7dmarket_cap_by_total_supply_strictvolume_7dvolume_30d`
sortDir	`sortDir`	`string`	Select a value from the drop down menu:`ascdesc`
cryptocurrencyType	`cryptocurrencyType`	`string`	Select a value from the drop down menu:`allcoinstokens`
Supplemental Fields	`aux`	`string[]`	Select a value from the drop down menu:`num_market_pairscmc_rankdate_addedtagsplatformmax_supplycirculating_supplytotal_supplymarket_cap_by_total_supplyvolume_24h_reportedvolume_7dvolume_7d_reportedvolume_30dvolume_30d_reported`