← Integrations
Allium logo

Allium

Live blockchain data on your home screen. Track token prices and Allium Explorer query results from 150+ chains without opening an app.

Free access, no subscription needed

Allium's public-access tier covers the Realtime Developer APIs for any registered user. Once you paste an API key, the Token Price module returns live data immediately across chains including Ethereum, Solana, Base, Arbitrum, and Optimism. You configure each widget by pasting a contract address; Allium resolves the token symbol automatically, so your widget title reads the ticker rather than a raw hex string. The free tier is sufficient for token price data.

Bring Explorer query results to your lock screen

If you write SQL in Allium Explorer, the Query module converts saved query results into glanceable widget tiles. Paste a saved query UUID, run the query at least once in the Allium app or on a schedule, and PulseKit reads the most recently completed run. The module does not trigger new query executions; it reads Allium's cached result, so your query cadence and unit budget stay under your control. A paid Allium subscription is required for Explorer API access.

Track your plan budget without logging in

The API Usage module surfaces your Explorer and Developer unit consumption against your current-period allocation, along with a percentage-used figure for each. Legacy credit-based plans are also supported. Useful when you run recurring queries and want a heads-up before you approach your allocation ceiling. Like the Query module, this requires a paid Allium plan; free-tier keys receive a permission error with a clear message.

How to get your Allium API key

Allium credentials:

  1. Sign in at app.allium.so. The free public-access tier unlocks the Realtime Developer APIs for token prices and wallet portfolio.
  2. Go to Settings, then Profile, then API, and click Create API Key. Allium issues one API key per user.
  3. Copy the key, which is shown once, and paste it below.

The Allium Query and API Usage modules need a paid Allium subscription. On the free tier they return permission errors.

Security

How we protect your credentials

Your Allium API key is sealed on this device with AES-256-GCM before it ever leaves your iPhone. Only your device holds the unwrap secret, stored in the iOS Keychain. The PulseKit backend wraps that already-encrypted payload again with its STORAGE_SECRET and writes the double-envelope blob to Postgres, so the server never sees your plaintext key at rest. Each fetch request includes a one-time unwrap secret that decrypts the inner envelope only long enough to call Allium. The key is scoped to this device, can be revoked from PulseKit at any time, and is never written to logs.

What you can track

Pick the metrics you care about and pin them as widgets.

Token Price

Latest USD price + 24h OHLC + 24h volume + 24h change for a token. Symbol auto-derived from the contract address.

  • 29
    Price
  • 82
    Open
  • 64
    High
  • 16
    Low
  • 32
    Close
  • 38
    24h Volume
  • 18
    24h Change

Allium Query

Paid Allium plan only. Surface the first row of any saved Allium Explorer query — numeric column titles become metric names. Free public-access keys return permission errors.

    API Usage

    Paid Allium plan only. Tracks plan consumption — Explorer + Developer units (or legacy Credits). Free public-access keys return permission errors.

    • 35
      Explorer units used
    • 77
      Explorer units allocated
    • 48
      Explorer units remaining
    • 47
      % Explorer used
    • 18
      Developer units used
    • 34
      Developer units allocated
    • 95
      Developer units remaining
    • 74
      % Developer used
    • 59
      Credits used
    • 82
      Credits included
    • 32
      Credits remaining
    • 46
      % Credits used

    Numbers shown are illustrative — your widgets show your live data.

    Who uses this

    • Crypto traders

      You hold or trade tokens across multiple chains and want to know whether a position is up or down without unlocking your phone. Configure one Token Price widget per token, paste the contract address, select the chain, and the home screen shows live price and 24-hour change. The free Allium tier is sufficient; no paid subscription required.

    • On-chain analysts

      You run periodic SQL in Allium Explorer to track protocol metrics, wallet cohorts, or custom on-chain signals. The Query module reads your last completed run and surfaces numeric columns as named metric tiles. Schedule your query in Allium on whatever cadence fits your workflow; the widget always shows the freshest cached result without burning additional units on refresh.

    • Allium subscribers

      You run query-heavy analysis sessions and want to know your Explorer and Developer unit balance before you start. The Usage module shows units consumed, units remaining, and percentage used for the current allocation period, visible from your home screen without opening the Allium settings page. Legacy credit-based plans are also tracked.

    FAQs

    Do I need a paid Allium subscription to use this integration?

    The Token Price module works with Allium's free public-access tier. Sign up at app.allium.so, generate an API key under Settings > Profile > API, and token price data is available immediately. The Allium Query and API Usage modules require a paid Allium subscription; free-tier keys receive a permission error for those modules.

    How do I configure a Token Price widget?

    Paste the token contract address (0x-prefixed for EVM chains, or a base58 address for Solana) and select the blockchain network. Allium resolves the token symbol from the contract automatically, so the widget title shows the ticker. If the token is not indexed by Allium, the title falls back to "Token" and price data is shown where available.

    How does the Allium Query module work?

    The Query module reads the most recent completed run of a saved Allium Explorer query. Paste the query UUID, run the query at least once in the Allium app, and PulseKit fetches the first result row on each refresh. Every numeric column becomes a metric tile. The module does not trigger new executions; it displays Allium's last cached result.

    Which blockchain networks are supported for token prices?

    Allium indexes token prices on Ethereum, Solana, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, Unichain, Worldchain, and additional networks. Paste the contract address and select the chain in widget setup. If the chain is not indexed or the token has no recent trades, Allium returns an error that surfaces directly in the widget.

    How often does data refresh on my home screen?

    PulseKit fetches Allium data on demand when the app or a widget refreshes. The Token Price module pulls 24 hours of 1-hour candle data on each fetch to produce price, OHLC, and volume metrics. Historical readings are retained for 30 days and displayed as sparkline charts inside the PulseKit app.

    Is my Allium API key stored securely?

    Your API key is encrypted with AES-256-GCM on your device before it leaves your iPhone. The PulseKit backend wraps that payload again with its own storage secret, so the server never holds your plaintext key at rest. Each data fetch decrypts only long enough to call Allium. You can revoke access in PulseKit settings at any time without affecting your Allium account.

    Can I track multiple tokens from different chains at once?

    Yes. Each Token Price widget is configured independently with its own contract address and chain. Each widget maintains its own 30-day chart history. Add as many widgets as you want to your home screen or lock screen; each one fetches and tracks its token separately with no data shared between them.

    Allium logo

    Add Allium widgets to your iPhone

    Install PulseKit, paste your credentials, pick a widget.

    Download