Search
K

Syntax / Formulas

Get started with you first =ART() formula!
Using the ART function

Pulling Live Data

=ART("SYMBOL", "METRIC_NAME")
Examples:
  • =ART("BTC", "PRICE") pulls the latest Bitcoin price
  • =ART("ETH", "MC") pulls the latest Ethereum market cap
  • =ART("SOL", "TVL") pulls the latest Solana TVL
  • =ART("SOL", "DAU") pulls the latest Solana daily active address count
  • =ART("MATIC", "FEES") pulls the latest Polygon fees

Pulling Historical Data

=ART("SYMBOL", "METRIC_NAME", "DATE")
Examples:
  • =ART("BTC", "PRICE", "2022-10-10") pulls the Bitcoin price on 2022-10-10 (midnight UTC time)
  • =ART("ETH", "MC", "2022-10-10") pulls the Ethereum market cap on 2022-10-10
For performance reasons, if you're a large amount of historical data, we recommend using the ARTRANGE function below.
This will also reduce the total number of calls that count towards your daily limit in Google Sheets.

Pulling a Range of Historical Data

=ARTRANGE("SYMBOL", "METRIC_NAME", "STARTDATE", "ENDDATE")
Example:
  • =ARTRANGE("BTC", "PRICE", "2022-01-01", "2022-10-01") pulls the Bitcoin price from 2022-01-01 to 2022-10-01 in ascending order

To pull in descending order, add the param "DESC".

=ARTRANGE("SYMBOL", "METRIC_NAME", "STARTDATE", "ENDDATE", "DESC")
Example:
  • =ARTRANGE("BTC", "PRICE", "2022-01-01", "2022-10-01", "DESC") pulls the Bitcoin price from 2022-10-01 to 2022-01-01 in descending order (so 2022-10-01 is on top).

Pulling Lots of Data

=ARTRANGE(<cells containing symbols>,<cells containing metric names>,"DATE")
=ART and =ARTRANGE both support pulling multiple symbols, metrics, and dates all at once so you can fetch hundreds of datapoints in one go--this is great for keeping your spreadsheet performant.
Examples:

Pulling multiple symbols and metrics for a single date:

  • =ARTRANGE(B6:B10,C5:I5,B4) (see a live example here)
  • =ART(B6:B10,C5:I5,B4)

Pulling multiple metrics and dates for a single symbol:

  • =ARTRANGE(B3,C5:I5,B43,B6,"DESC") (see a live example here)
  • =ART(B3,C5:I5,B43,B6,"DESC")

Pulling multiple symbols and dates for a single metric:

  • =ARTRANGE(C5:F5,B3,B43,B6,"DESC") (see a live example here)
  • =ART(C5:F5,B3,B43,B6,"DESC")
NOTE: you can only pick 2 out of the 3 (symbol, metric, date) as a range of cells. Otherwise, the data output would be three-dimensional and would not output correctly in GSheet or Excel.

Duplicate symbols

In case of duplicate symbols, use the coingecko ID in ART formulas.
Example:
  • =ART("degate", "PRICE") pulls the DeGate (symbol: DG) price
  • =ART("decentral-games", "PRICE") pulls the Decentral Games (symbol: DG) price
The coingecko ID can be found in the Coingecko token page, in API id field.