@pipedream/coingecko 0.0.1 → 0.2.0

package/actions/get-coin/get-coin.mjs

@@ -0,0 +1,84 @@
+import app from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-get-coin",
+  name: "Get Coin",
+  description: "Get current data for a coin by its ID, including price, market cap, volume, community data, and developer data. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/coins-id)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+    coinId: {
+      propDefinition: [
+        app,
+        "coinId",
+      ],
+    },
+    localization: {
+      type: "boolean",
+      label: "Include Localization",
+      description: "Include all localized language data in the response.",
+      optional: true,
+    },
+    tickers: {
+      type: "boolean",
+      label: "Include Tickers",
+      description: "Include ticker and exchange data in the response.",
+      optional: true,
+    },
+    marketData: {
+      type: "boolean",
+      label: "Include Market Data",
+      description: "Include market data (price, market cap, volume, etc.) in the response.",
+      optional: true,
+    },
+    communityData: {
+      type: "boolean",
+      label: "Include Community Data",
+      description: "Include community data (Reddit, Twitter, Telegram) in the response.",
+      optional: true,
+    },
+    developerData: {
+      type: "boolean",
+      label: "Include Developer Data",
+      description: "Include developer/GitHub data (forks, stars, commits) in the response.",
+      optional: true,
+    },
+    sparkline: {
+      type: "boolean",
+      label: "Include Sparkline",
+      description: "Include 7-day sparkline price data in the response.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const {
+      coinId,
+      localization,
+      tickers,
+      marketData,
+      communityData,
+      developerData,
+      sparkline,
+    } = this;
+    const response = await this.app.getCoin({
+      $,
+      coinId,
+      params: {
+        localization,
+        tickers,
+        market_data: marketData,
+        community_data: communityData,
+        developer_data: developerData,
+        sparkline,
+      },
+    });
+    $.export("$summary", `Successfully retrieved data for ${response.name} (${response.symbol?.toUpperCase()})`);
+    return response;
+  },
+};

package/actions/get-coin-history/get-coin-history.mjs

@@ -0,0 +1,49 @@
+import app from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-get-coin-history",
+  name: "Get Coin History",
+  description: "Get historical data (price, market cap, and volume) for a coin on a specific date. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/coins-id-history)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+    coinId: {
+      propDefinition: [
+        app,
+        "coinId",
+      ],
+    },
+    date: {
+      type: "string",
+      label: "Date",
+      description: "The date to retrieve historical data for, in `dd-mm-yyyy` format (e.g. `30-12-2023`).",
+    },
+    localization: {
+      type: "boolean",
+      label: "Include Localization",
+      description: "Include localized language data in the response.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const {
+      coinId, date, localization,
+    } = this;
+    const response = await this.app.getCoinHistory({
+      $,
+      coinId,
+      params: {
+        date,
+        localization,
+      },
+    });
+    $.export("$summary", `Successfully retrieved historical data for ${coinId} on ${date}`);
+    return response;
+  },
+};

package/actions/get-coin-value/get-coin-value.mjs

@@ -0,0 +1,95 @@
+import app from "../../coingecko.app.mjs";
+import { parseStringList } from "../../common/utils.mjs";
+
+export default {
+  key: "coingecko-get-coin-value",
+  name: "Get Coin Value",
+  description: "Get the current price of one or more cryptocurrencies in any supported currencies. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/simple-price)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+    vsCurrencies: {
+      type: "string[]",
+      label: "Target Currencies",
+      description: "List of target currencies to convert to (e.g. `usd,eur,btc`).",
+      propDefinition: [
+        app,
+        "vsCurrency",
+      ],
+    },
+    ids: {
+      type: "string[]",
+      label: "Coin IDs",
+      description: "List of coin IDs (e.g. `bitcoin,ethereum`)",
+      optional: true,
+      propDefinition: [
+        app,
+        "coinId",
+      ],
+    },
+    includeMarketCap: {
+      type: "boolean",
+      label: "Include Market Cap",
+      description: "Include market cap data in the response.",
+      optional: true,
+    },
+    include24hrVol: {
+      type: "boolean",
+      label: "Include 24h Volume",
+      description: "Include 24-hour trading volume in the response.",
+      optional: true,
+    },
+    include24hrChange: {
+      type: "boolean",
+      label: "Include 24h Change",
+      description: "Include 24-hour price change percentage in the response.",
+      optional: true,
+    },
+    includeLastUpdatedAt: {
+      type: "boolean",
+      label: "Include Last Updated At",
+      description: "Include the last updated UNIX timestamp in the response.",
+      optional: true,
+    },
+    precision: {
+      type: "string",
+      label: "Precision",
+      description: "Decimal precision for price values. Use `full` for full precision or a number from `0` to `18`.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const {
+      ids,
+      vsCurrencies,
+      includeMarketCap,
+      include24hrVol,
+      include24hrChange,
+      includeLastUpdatedAt,
+      precision,
+    } = this;
+    const response = await this.app.getCoinPrice({
+      $,
+      params: {
+        vs_currencies: parseStringList(vsCurrencies),
+        ids: parseStringList(ids),
+        include_market_cap: includeMarketCap,
+        include_24hr_vol: include24hrVol,
+        include_24hr_change: include24hrChange,
+        include_last_updated_at: includeLastUpdatedAt,
+        precision,
+      },
+    });
+    const coinCount = Object.keys(response).length;
+    $.export("$summary", `Successfully retrieved prices for ${coinCount} coin${coinCount === 1
+      ? ""
+      : "s"}`);
+    return response;
+  },
+};

package/actions/get-exchange-rates/get-exchange-rates.mjs

@@ -0,0 +1,24 @@
+import app from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-get-exchange-rates",
+  name: "Get Exchange Rates",
+  description: "Get BTC-to-currency exchange rates for currencies recognized by CoinGecko. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/exchange-rates)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const response = await this.app.getExchangeRates({
+      $,
+    });
+    $.export("$summary", `Successfully retrieved ${Object.keys(response.rates).length} exchange rates`);
+    return response;
+  },
+};

package/actions/get-global-defi-market-overview/get-global-defi-market-overview.mjs

@@ -0,0 +1,24 @@
+import app from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-get-global-defi-market-overview",
+  name: "Get Global DeFi Market Overview",
+  description: "Get the current DeFi market data from the top 100 cryptocurrencies, including DeFi market cap, trading volume, and top coin dominance. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/global-defi)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const response = await this.app.getGlobalDefiMarket({
+      $,
+    });
+    $.export("$summary", "Successfully retrieved global DeFi market overview");
+    return response;
+  },
+};

package/actions/get-global-market/get-global-market.mjs

@@ -0,0 +1,24 @@
+import app from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-get-global-market",
+  name: "Get Global Market",
+  description: "Get global cryptocurrency market data including total market cap, total volume, market cap percentage, and more. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/crypto-global)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const response = await this.app.getGlobalMarket({
+      $,
+    });
+    $.export("$summary", "Successfully retrieved global market data");
+    return response;
+  },
+};

package/actions/list-coin-tickers/list-coin-tickers.mjs

@@ -0,0 +1,88 @@
+import app from "../../coingecko.app.mjs";
+import { parseStringList } from "../../common/utils.mjs";
+
+export default {
+  key: "coingecko-list-coin-tickers",
+  name: "List Coin Tickers",
+  description: "List trading tickers for a specified coin, including exchange info, price, volume, and trust score. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/coins-id-tickers)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+    coinId: {
+      propDefinition: [
+        app,
+        "coinId",
+      ],
+    },
+    exchangeIds: {
+      type: "string[]",
+      label: "Exchange IDs",
+      description: "Filter tickers by exchange. Select one or more exchanges.",
+      optional: true,
+      propDefinition: [
+        app,
+        "exchangeId",
+      ],
+    },
+    includeExchangeLogo: {
+      type: "boolean",
+      label: "Include Exchange Logo",
+      description: "Include the exchange logo URL in the response.",
+      optional: true,
+    },
+    page: {
+      type: "integer",
+      label: "Page",
+      description: "Page number for paginated results.",
+      optional: true,
+    },
+    order: {
+      type: "string",
+      label: "Order",
+      description: "Sort order for tickers.",
+      optional: true,
+      options: [
+        "trust_score_desc",
+        "trust_score_asc",
+        "volume_desc",
+        "volume_asc",
+      ],
+    },
+    depth: {
+      type: "boolean",
+      label: "Include Depth",
+      description: "Include 2% orderbook depth (cost to move up/down) in the response.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const {
+      coinId,
+      exchangeIds,
+      includeExchangeLogo,
+      page,
+      order,
+      depth,
+    } = this;
+    const response = await this.app.getCoinTickers({
+      $,
+      coinId,
+      params: {
+        exchange_ids: parseStringList(exchangeIds),
+        include_exchange_logo: includeExchangeLogo,
+        page,
+        order,
+        depth,
+      },
+    });
+    const count = response.tickers?.length ?? 0;
+    $.export("$summary", `Successfully retrieved ${count} tickers for ${coinId}`);
+    return response;
+  },
+};

package/actions/list-coins/list-coins.mjs

@@ -0,0 +1,34 @@
+import app from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-list-coins",
+  name: "List Coins",
+  description: "List all supported coins with their ID, name, and symbol on CoinGecko. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/coins-list)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+    includePlatform: {
+      type: "boolean",
+      label: "Include Platform",
+      description: "Include platform contract addresses (e.g. Ethereum, Solana) for each coin.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { includePlatform } = this;
+    const response = await this.app.listCoins({
+      $,
+      params: {
+        include_platform: includePlatform,
+      },
+    });
+    $.export("$summary", `Successfully retrieved ${response.length} coins`);
+    return response;
+  },
+};

package/actions/list-markets/list-markets.mjs

@@ -0,0 +1,40 @@
+import app from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-list-markets",
+  name: "List Markets",
+  description: "Search for coins, exchanges, NFTs, and categories on CoinGecko. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/search-data)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+    query: {
+      type: "string",
+      label: "Query",
+      description: "The search query string (e.g. `bitcoin`, `eth`).",
+    },
+  },
+  async run({ $ }) {
+    const {
+      app,
+      query,
+    } = this;
+    const response = await app.search({
+      $,
+      params: {
+        query,
+      },
+    });
+    const coinsCount = response.coins?.length ?? 0;
+    const exchangesCount = response.exchanges?.length ?? 0;
+    const nftsCount = response.nfts?.length ?? 0;
+    const total = coinsCount + exchangesCount + nftsCount;
+    $.export("$summary", `Successfully retrieved ${total} results for "${query}"`);
+    return response;
+  },
+};

package/actions/list-trending-coins/list-trending-coins.mjs

@@ -0,0 +1,25 @@
+import app from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-list-trending-coins",
+  name: "List Trending Coins",
+  description: "List the top-7 trending coins on CoinGecko based on search volume in the last 24 hours. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/trending-search)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const response = await this.app.getTrending({
+      $,
+    });
+    const coins = response.coins ?? [];
+    $.export("$summary", `Successfully retrieved ${coins.length} trending coins`);
+    return coins;
+  },
+};

package/actions/list-trending-nfts/list-trending-nfts.mjs

@@ -0,0 +1,25 @@
+import app from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-list-trending-nfts",
+  name: "List Trending NFTs",
+  description: "List the top-7 trending NFTs on CoinGecko based on the highest trading volume in the last 24 hours. [See the documentation](https://docs.coingecko.com/v3.0.1/reference/trending-search)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+  },
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const response = await this.app.getTrending({
+      $,
+    });
+    const nfts = response.nfts ?? [];
+    $.export("$summary", `Successfully retrieved ${nfts.length} trending NFTs`);
+    return nfts;
+  },
+};

package/actions/list-vs-currency-options/list-vs-currency-options.mjs

@@ -0,0 +1,24 @@
+import coingecko from "../../coingecko.app.mjs";
+
+export default {
+  key: "coingecko-list-vs-currency-options",
+  name: "List vs Currency Options",
+  description: "Retrieves available options for the vs Currency field.",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    coingecko,
+  },
+  async run({ $ }) {
+    const options = await coingecko.propDefinitions.vsCurrency.options.call(this.coingecko);
+    $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
+      ? ""
+      : "s"}`);
+    return options;
+  },
+};

package/coingecko.app.mjs

@@ -1,11 +1,148 @@
+import { axios } from "@pipedream/platform";
+
 export default {
   type: "app",
   app: "coingecko",
-  propDefinitions: {},
+  propDefinitions: {
+    coinId: {
+      type: "string",
+      label: "Coin ID",
+      description: "The coin ID (e.g. `bitcoin`, `ethereum`). Use the **List Coins** action to find the ID of the coin you want to use.",
+    },
+    vsCurrency: {
+      type: "string",
+      label: "vs Currency",
+      description: "The target currency to convert to (e.g. `usd`, `eur`, `btc`). [See supported currencies](https://docs.coingecko.com/v3.0.1/reference/simple-supported-currencies)",
+      async options() {
+        const currencies = await this.getSupportedCurrencies();
+        return currencies.map((currency) => ({
+          label: currency.toUpperCase(),
+          value: currency,
+        }));
+      },
+    },
+    exchangeId: {
+      type: "string",
+      label: "Exchange ID",
+      description: "The exchange identifier (e.g. `binance`, `gdax`). [See exchanges list](https://docs.coingecko.com/v3.0.1/reference/exchanges-list)",
+      async options() {
+        const exchanges = await this.listExchanges();
+        return exchanges.map(({
+          id, name,
+        }) => ({
+          label: name,
+          value: id,
+        }));
+      },
+    },
+  },
   methods: {
-    // this.$auth contains connected account data
-    authKeys() {
-      console.log(Object.keys(this.$auth));
+    _isProduction() {
+      return this.$auth.environment === "production";
+    },
+    getUrl(path) {
+      const subdomain = this._isProduction()
+        ? "pro-api"
+        : "api";
+      return `https://${subdomain}.coingecko.com/api/v3${path}`;
+    },
+    _apiKeyHeader() {
+      return this._isProduction()
+        ? "x-cg-pro-api-key"
+        : "x-cg-demo-api-key";
+    },
+    getHeaders(headers) {
+      return {
+        [this._apiKeyHeader()]: this.$auth.api_key,
+        ...headers,
+      };
+    },
+    _makeRequest({
+      $ = this, path, headers, ...opts
+    }) {
+      return axios($, {
+        url: this.getUrl(path),
+        headers: this.getHeaders(headers),
+        ...opts,
+      });
+    },
+    getGlobalMarket(opts = {}) {
+      return this._makeRequest({
+        path: "/global",
+        ...opts,
+      });
+    },
+    getExchangeRates(opts = {}) {
+      return this._makeRequest({
+        path: "/exchange_rates",
+        ...opts,
+      });
+    },
+    getGlobalDefiMarket(opts = {}) {
+      return this._makeRequest({
+        path: "/global/decentralized_finance_defi",
+        ...opts,
+      });
+    },
+    search(opts = {}) {
+      return this._makeRequest({
+        path: "/search",
+        ...opts,
+      });
+    },
+    listCoins(opts = {}) {
+      return this._makeRequest({
+        path: "/coins/list",
+        ...opts,
+      });
+    },
+    getCoinTickers({
+      coinId, ...opts
+    } = {}) {
+      return this._makeRequest({
+        path: `/coins/${coinId}/tickers`,
+        ...opts,
+      });
+    },
+    getTrending(opts = {}) {
+      return this._makeRequest({
+        path: "/search/trending",
+        ...opts,
+      });
+    },
+    listExchanges(opts = {}) {
+      return this._makeRequest({
+        path: "/exchanges/list",
+        ...opts,
+      });
+    },
+    getSupportedCurrencies(opts = {}) {
+      return this._makeRequest({
+        path: "/simple/supported_vs_currencies",
+        ...opts,
+      });
+    },
+    getCoinPrice(opts = {}) {
+      return this._makeRequest({
+        path: "/simple/price",
+        ...opts,
+      });
+    },
+    getCoinHistory({
+      coinId, ...opts
+    } = {}) {
+      return this._makeRequest({
+        path: `/coins/${coinId}/history`,
+        ...opts,
+      });
+    },
+    getCoin({
+      coinId, ...opts
+    } = {}) {
+      return this._makeRequest({
+        path: `/coins/${coinId}`,
+        ...opts,
+      });
     },
   },
-};
+};

package/common/utils.mjs

@@ -0,0 +1,36 @@
+/**
+ * Parses a value into a comma-separated string, handling the different
+ * formats a user may provide:
+ *   - Array:                ["usd", "eur"]      → "usd,eur"
+ *   - JSON array string:    '["usd","eur"]'      → "usd,eur"
+ *   - Comma-separated str:  "usd,eur"            → "usd,eur"
+ *   - Single string:        "usd"                → "usd"
+ *   - Nullish:              null / undefined      → undefined
+ *
+ * @param {string|string[]|null|undefined} value
+ * @returns {string|undefined}
+ */
+export function parseStringList(value) {
+  if (value === null || value === undefined) return undefined;
+
+  if (Array.isArray(value)) {
+    return value.join(",");
+  }
+
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed.startsWith("[")) {
+      try {
+        const parsed = JSON.parse(trimmed);
+        if (Array.isArray(parsed)) {
+          return parsed.join(",");
+        }
+      } catch (_) {
+        // not valid JSON — fall through and return as-is
+      }
+    }
+    return trimmed;
+  }
+
+  return String(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/coingecko",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Pipedream CoinGecko Components",
   "main": "coingecko.app.mjs",
   "keywords": [
@@ -11,5 +11,8 @@
   "author": "Pipedream <support@pipedream.com> (https://pipedream.com/)",
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@pipedream/platform": "^3.2.5"
   }
 }