> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.cloudquant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# R SDK Getting Started

> Installation guide and prerequisites for using the CloudQuant Data Liberator R API.

# R SDK getting started

The CloudQuant Data Liberator R package provides functions for querying datasets and converting results to R DataFrames.

## Required security files

Place the following files from your Downloads ZIP in your working directory:

* **`liberator.json`** — Contains your Username and Token
* **`liberator.pfx`** — Security certificate (only required for releases prior to 2.0)

<Note>
  As of release version 2.0, `liberator.pfx` is no longer required. If you are on a release prior to 2.0, you must also include `liberator.pfx` in your working directory.
</Note>

## Quick start

### Query and get DataFrame

```r theme={null}
res = liberator::get_dataframe(liberator::query(
    symbols="AAPL",
    name="daily_bars",
    as_of="2025-01-01",
    back_to="2024-12-01"
))

print(res)
```

### Function reference

The `get_dataframe` function accepts a query result and converts it into a DataFrame:

```r theme={null}
get_dataframe <- function(res, muts_order_batches=TRUE)
```

You can send debug output to stderr:

```r theme={null}
print(liberator::get_dataframe(liberator::query(
    name="daily_bars",
    symbols="AAPL",
    as_of="2019-09-15",
    back_to="2019-09-10",
    debug_stream=stderr()
)))
```