← Back to Tools

For developers

Otomato SDK — Integrate DeFi alerts into your app

Drop-in alert engine for any on-chain product. Position detection, threshold monitoring, multi-channel delivery. TypeScript SDK, REST API, and webhooks.

installnpm
npm install @otomato/sdk

Package name to be confirmed at launch. The REST API works today.

example.tstypescript
import { Otomato } from '@otomato/sdk'

const otomato = new Otomato({ apiKey: process.env.OTOMATO_API_KEY })

// Detect what a wallet is exposed to.
const positions = await otomato.detectPositions({
  address: '0xUserWallet',
  chains: ['ethereum', 'arbitrum', 'base', 'hyperevm'],
})

// Subscribe to portfolio-aware alerts for that wallet.
await otomato.subscribe({
  address: '0xUserWallet',
  channels: ['webhook'],
  webhookUrl: 'https://your-app.example.com/alerts',
})

// Your endpoint receives signed payloads only when something matters.
// { type: 'aave.health_factor.low', position: { ... }, severity: 'critical' }

What the SDK gives you

The Otomato SDK is the same engine that powers our app. You get portfolio-aware position detection, threshold monitoring, and multi-channel delivery in one integration. No glue code, no per-protocol indexers, no Telegram bot to babysit.

Automatic position detection

Pass a wallet address. Get back a structured list of positions across supported protocols. No per-protocol indexing on your side.

Threshold monitoring

Health factor, rate change, depeg, maturity, limit fill. We track the metrics that matter and fire when thresholds cross.

Multi-channel delivery

Push notification, in-app, email, Telegram, or webhook. Configure per user or per alert type.

Low-noise by default

Built-in cooldowns and severity logic. Your users get the same calm signal quality our app users get.

Multi-chain out of the box

Ethereum, Arbitrum, Base, and HyperEVM supported today. New chains and protocols ship continuously.

TypeScript SDK and REST

Use the typed SDK if you are in a Node or TypeScript stack. Use the REST API and webhooks from any backend.

How it fits in your stack

Three steps from API key to your first alert. The integration is intentionally thin so you can ship in hours, not weeks.

  1. 1

    Get an API key

    Request access. We provision a key tied to your team and your usage limits.

  2. 2

    Register your users

    Pass wallet addresses, the channels you want, and the alert types you care about. The SDK handles the rest.

  3. 3

    Receive alerts

    Webhooks fire when something matters. Or let us deliver directly to your users via push, in-app, email, or Telegram.

Who is building with it

Most teams that want embedded alerts inside their product hit the same wall. Indexing protocol positions is brittle, every chain has its own quirks, and notification delivery turns into a third backend nobody wants to own. The Otomato SDK is the answer to all three problems in one integration.

DEXs and aggregators

Limit order fills, slippage warnings, and pool changes delivered inside your app instead of via X.

Lending protocols

Health factor and rate alerts native in your dashboard, with the same severity logic we use for Aave and Morpho.

Portfolio trackers and wallets

Add portfolio-aware alerts as a feature without building the monitoring infrastructure from scratch.

Yield platforms

Maturity reminders, implied rate changes, and depeg alerts for the underlying assets your users farm.

See it in production

Build with Otomato

Want early access to the SDK or a technical walkthrough? Try Otomato first to see the engine in action, then talk to us about integrating it.

Try Otomato