https://github.com/moohan/octopusr
Package for interacting with the Octopus Energy API
https://github.com/moohan/octopusr
Last synced: 3 months ago
JSON representation
Package for interacting with the Octopus Energy API
- Host: GitHub
- URL: https://github.com/moohan/octopusr
- Owner: Moohan
- License: other
- Created: 2022-02-08T17:16:51.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-07T09:09:42.000Z (3 months ago)
- Last Synced: 2025-04-10T16:45:27.637Z (3 months ago)
- Language: R
- Homepage: https://moohan.github.io/octopusR/
- Size: 5.31 MB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codemeta: codemeta.json
Awesome Lists containing this project
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# octopusR
[](https://www.repostatus.org/#active)
[](https://CRAN.R-project.org/package=octopusR)
[](https://github.com/Moohan/octopusR/actions/workflows/R-CMD-check.yaml)
[](https://app.codecov.io/gh/Moohan/octopusR?branch=main)
[](https://github.com/Moohan/octopusR/actions?query=workflow%3Apkgcheck)
[](https://scorecard.dev/viewer/?uri=github.com/Moohan/octopusR)
[](https://www.bestpractices.dev/projects/10198)
octopusR is an R package that provides access to the [Octopus Energy REST API](https://developer.octopus.energy/rest). With octopusR, you can easily retrieve data from the Octopus Energy API and use it in your R projects, or Shiny dashboards.
If you find this package useful, why not [sponsor me on GitHub](https://github.com/sponsors/Moohan) or sign up for an Octopus Energy account with [my referral code (jolly-bloom-201)](https://share.octopus.energy/jolly-bloom-201)!
## Installation
octopusR can be installed from CRAN.
```r
install.packages("octopusR")
```
If you would like the development version, it can be installed from GitHub, using the `{remotes}` package:
```r
# Install remotes if needed
if (!require("remotes")) install.packages("remotes")
remotes::install_github("moohan/octopusR")
```
## Usage
To use most functions in octopusR, you will need an API key from Octopus Energy, you can find this on the [developer dashboard](https://octopus.energy/dashboard/developer/). Once you have your API key, you can use `set_api_key()` to interactively input and store the API key for the session:
```r
library(octopusR)
# Set your API key
set_api_key()
```
Once you have authenticated with the API, you may also want to set your electric and/or gas meter details.
```r
# Set details for your electricity meter
set_meter_details(meter_type = "electricity")
# Set details for your gas meter
set_meter_details(meter_type = "gas")
```
You can use the other functions in the package to interact with the API. For example, you can use the `get_consumption()` function to retrieve data about your energy usage:
```{r setup, include=FALSE}
library(octopusR)
set_api_key(api_key = octopusR:::testing_key())
set_meter_details(
meter_type = "electricity",
mpan_mprn = octopusR:::testing_meter("electricity")[["mpan_mprn"]],
serial_number = octopusR:::testing_meter("electricity")[["serial_number"]]
)
```
```{r get_consumption}
# Get data about your energy usage
energy_usage <- get_consumption(meter_type = "elec")
# View the data
head(energy_usage)
```
For more information and examples, see the [package documentation](https://moohan.github.io/octopusR/) and the [Octopus Energy API documentation](https://developer.octopus.energy/docs/api/).
## Contributing
If you have suggestions for improving octopusR, or if you have found a
bug, please [open an issue](https://github.com/Moohan/octopusR/issues).
Contributions in the form of pull requests are also welcome. See the
[guide to contributing](https://moohan.github.io/octopusR/CONTRIBUTING.html) for more details.
### Code of Conduct
Please note that the octopusR project is released with a [Contributor
Code of
Conduct](https://moohan.github.io/octopusR/CODE_OF_CONDUCT.html). By
contributing to this project, you agree to abide by its terms.
## License
octopusR is licensed under the MIT License. See LICENSE for more information.