Developer docs

Oimo developer docs

Oimo records the published prices and terms of service of AI and cloud providers. Connect your systems in two ways:

Webhooks: a signed POST to your endpoint when a price, a resource or a terms document changes.
The price history API: GET /v1/prices/history with a read-only API key returns every reviewed price, pinned to an instant you choose.

The base URL is https://oimo.com. All requests and deliveries use HTTPS and JSON.

Quickstart

From sign-up to a verified webhook and a first API call in five steps.

Open https://oimo.com and choose Sign in. If you have no account yet, create one on the sign-in page.

2. Create a workspace

Webhooks, API keys and teammates belong to a workspace. Choose Manage workspaces, then Create workspace. You become its admin; invite teammates under Members & invitations.

3. Create a webhook

Open Connect → Webhooks and choose New webhook.
Enter a name and your endpoint URL (it must be https://).
Tick the events you want (start with Price changes) and the providers, or All providers.
Choose Create webhook. The signing secret (whsec_…) is shown when the webhook is created: store it with your receiver. You can reveal it again from the webhook's Settings with Reveal signing secret.
Open the webhook's Settings and choose Send test event. A signed webhook.test event goes out with the next delivery run (within 5 minutes). Its attempts appear under Deliveries.

Your receiver must verify the signature and answer with a 2xx status within 5 seconds. A minimal Node.js receiver:

shell

npm install express standardwebhooks

receiver.mjs

import express from "express";
import { Webhook } from "standardwebhooks";

const webhook = new Webhook(process.env.OIMO_WEBHOOK_SECRET);
const app = express();

app.post("/hooks/oimo", express.raw({ type: "application/json", limit: "5mb" }), (req, res) => {
  let event;
  try {
    event = webhook.verify(req.body, req.headers);
  } catch {
    return res.status(400).send("invalid signature");
  }
  console.log(event.type, event.id);
  res.sendStatus(204);
});

app.listen(3000);

4. Create an API key

Open Connect → API keys, name the key after the system that will use it and choose Create key. The key is shown once. Keys can read; they cannot change anything.

5. Read price history