Live data (oracles)

An oracle is a live-data connection the model can call while it answers: web search, news, weather, stocks, crypto, maps and image generation. You switch one on by listing it in the tools array of a normal chat-completion request; the model decides when to call it, Oraicle runs the lookup, and the result is folded into the answer. Nothing to host on your side.

Request

Add a tools array with one object per oracle you want the model to be able to use. type is the oracle’s name from the table below.

{
  "model": "openai/gpt-oss-120b",
  "messages": [{ "role": "user", "content": "What's the weather in Tokyo right now?" }],
  "tools": [{ "type": "weather" }]
}

Several can be on at once — [{ "type": "web" }, { "type": "news" }] — and the model uses whichever the question needs. The regular OpenAI function tools keep working alongside them.

Which models can call oracles

Tool calling depends on the model. The chat’s model picker marks the models that drive oracles reliably (⚡); a model without tool support may ignore the tools array and answer from memory.

The seven oracles

type	Billed	What it does
web	$0.005 / query	Fresh results from the live web
news	$0.001 / request	Latest headlines on any topic
weather	$0.001 / request	Current conditions for any location
stocks	$0.001 / request	Live quotes and market data
crypto	$0.001 / request	Live coin prices and 24h moves
maps	$0.001 / request	Addresses, places and geocoding
images	$0.005 / image	Generate an image from a description (kept 7 days under an unguessable link)

Billing

Each oracle call is billed once, at the amount in the table, on top of the model’s own tokens — and only when the lookup succeeds. A failed or empty lookup costs nothing beyond the tokens. There is no subscription: the same prepaid wallet pays for tokens and lookups alike.

Prices shown here mirror what billing charges; the live table is on oraicle.me/pricing.

Daily limit on web search and news

Web search and news run on budgets every account shares, so each account can make up to 10 web searches and 20 news searches a day, counted from midnight UTC across all of its keys and agents. Past that, the search is not made and costs nothing: the model is told that the account has used today’s searches, and answers without them. The count starts again at midnight UTC. The other five oracles have no daily limit.