Skip to main content
Upload a CSV or insert rows through the API to create a table only your organization can query. Join it with Allium data in any query, such as a list of wallets against balances or token contracts against stablecoin supply. Uploading needs the admin or user role in your organization.

Upload a CSV

1

Open Your Data

In Allium App, open Library > Your Data and choose Upload Data.
2

Name the table and choose a file

Enter a table name and choose a CSV with a header row. Without a name, the table takes the file’s name.
Upload Data dialog with the table name stablecoin_watchlist and a CSV file uploaded
3

Upload

Choose Upload. The table is ready to query once its rows are ingested.
Preview of the stablecoin_watchlist table with chain, token_address and segment columns

A watchlist of stablecoin contracts with a segment column

Column names are lowercased, and any character other than a letter or number becomes an underscore. Column types are inferred from the data: dates and times load as timestamps, numbers as numbers, and everything else as text.

Add rows

Insert Rows on a table’s page adds rows from another CSV or through the API. Overwrite replaces every row in the table instead, and can’t be undone. Each upload’s status and row count stay in the table’s upload history.
Upload history for stablecoin_watchlist with one completed job

Insert rows through the API

Send rows as a list of objects. The first request to a new table name creates the table, and "overwrite": true replaces its rows. Requests need an API key.
The upload dialog has the same request in Python, Go, Rust and TypeScript, with your key filled in.

Query your table

Your tables live in your organization’s database, at ORG_DB__<organization id>.default.<table>. In the query editor, the schema browser lists them under Your Uploaded Tables and inserts the full name.
Query editor schema browser listing stablecoin_watchlist under Your Uploaded Tables
Join the watchlist with stablecoin supply to get each contract’s latest circulating supply:
Query joining stablecoin_watchlist with stablecoins.core.supply_daily, returning six rows from USDT to USDG

Rename or delete a table

Rename or delete a table from its page. Deleting a table drops it and every row in it.