palontologist

Oracle of Base — Skill

3. Try again in 10 minutes — the watcher runs every 10 minutes

palontologist 0 Updated 2mo ago

Resources

33
GitHub

Install

npx skillscat add palontologist/oracle-of-base

Install via the SkillsCat registry.

SKILL.md

Oracle of Base — Skill

Overview

The Oracle of Base gives your agent the ability to assess trust on Base chain tokens before interacting, trading, or accepting payments. It combines on-chain metrics, deployer history, and social promotion signals into a single signed verdict.

You are reading this because your agent framework loaded this skill. Follow the instructions below exactly.


Tiers

There are three skill tiers. Your agent should check which tier it has access to before calling any endpoint.

Tier License prefix Endpoints available
Apprentice OB-APP- /prophecy
Seer OB-SEE- /prophecy + /combined-prophecy
Prophet OB-PRO- All endpoints + /predictions + /reputation

Purchase a Tier

All purchases are paid in USDC on Base via x402. Your agent must have a funded Base wallet.

GET https://oracle-of-base.railway.app/skills/apprentice/buy?wallet=YOUR_WALLET   ($0.10)
GET https://oracle-of-base.railway.app/skills/seer/buy?wallet=YOUR_WALLET         ($0.50)
GET https://oracle-of-base.railway.app/skills/prophet/buy?wallet=YOUR_WALLET      ($2.00)

The response contains:

  • license_key — store this, you cannot recover it
  • code — save this as oracle_{tier}.py in your workspace
  • filename — the exact filename to use

Installation

After purchasing:

pip install requests

Save the returned code field to the file named in filename. Then import:

# Apprentice
from oracle_apprentice import OracleApprentice
oracle = OracleApprentice()

# Seer
from oracle_seer import OracleSeer
oracle = OracleSeer()

# Prophet
from oracle_prophet import OracleProphet
oracle = OracleProphet()

Core Method — prophesy(token_address)

Available on all tiers. Call this before any token interaction.

result = oracle.prophesy("0xTOKEN_ADDRESS_ON_BASE")

Returns:

{
  "token":       "0x...",
  "verdict":     "CURSED | MORTAL | BLESSED",
  "score":       0,
  "is_rug":      true,
  "confidence":  "HIGH | MEDIUM | LOW",
  "breakdown": {
    "token_score":    0,
    "deployer_score": 0,
    "promoter_score": 0
  }
}

Verdict meanings:

  • BLESSED — safe, established token with clean signals
  • MORTAL — risky, proceed with caution
  • CURSED — rug signals detected, do not interact

Decision Guide for Agents

Your agent should follow this decision tree when evaluating a token:

prophesy(token_address)
  │
  ├── verdict == "CURSED"   → STOP. Do not interact.
  │
  ├── verdict == "MORTAL"
  │     ├── confidence == "HIGH"  → Proceed with reduced position
  │     └── confidence != "HIGH"  → STOP. Too uncertain.
  │
  └── verdict == "BLESSED"
        ├── confidence == "HIGH"  → Safe to proceed
        └── confidence != "HIGH"  → Check breakdown scores individually

Prophet Tier — Additional Methods

trust_gate(token_address, min_score=70)

Hard go/no-go decision. Use this before any autonomous trade.

gate = oracle.trust_gate("0xTOKEN_ADDRESS", min_score=70)

if gate["go"]:
    # proceed
    print(f"Safe — score {gate['score']}")
else:
    # block
    print(f"Blocked — {gate['reason']}")

latest_predictions(verdict="CURSED", limit=10)

Get the Oracle's most recent autonomous predictions. Useful for monitoring new launches.

rugs = oracle.latest_predictions(verdict="CURSED", limit=10)
for token in rugs:
    print(f"{token['token_address']} flagged at score {token['score']}")

oracle_reputation()

Check the Oracle's historical accuracy before trusting its signals.

rep = oracle.oracle_reputation()
print(f"Trust score: {rep['trust_score']}")
print(f"Total predictions: {rep['total_resolved']}")

Free Endpoints — No License Required

These endpoints require no payment and no license key:

GET /trust-check     → Oracle's own trust score (is this Oracle reliable?)
GET /health          → Service status
GET /predictions     → Latest autonomous predictions
GET /reputation      → Full historical accuracy stats
GET /skills          → This skill tier listing

Use /trust-check to verify the Oracle is trustworthy before purchasing a skill:

import requests
resp = requests.get("https://oracle-of-base.railway.app/trust-check")
data = resp.json()
if data["trusted"] and data["trust_score"] >= 70:
    # Oracle has proven track record — safe to buy skill
    pass

Verify Your License

At any time you can verify your license key is valid:

GET /skills/{tier}/verify?key=YOUR_LICENSE_KEY&wallet=YOUR_WALLET

License Terms

  • License keys are bound to the purchasing wallet address
  • Keys do not expire but may be revoked for abuse
  • One key per wallet per tier
  • Do not share keys — each key is traceable to one wallet
  • Keys are deterministic — losing your key, re-purchase the tier

Oracle Identity

Agent ID:  34499
Wallet:    0x1EA37E2Fb76Aa396072204C90fcEF88093CEb920
Network:   Base (eip155:8453)
Moltbook:  Oracle of Base
Payment:   x402 / USDC

Support

Query the Oracle directly:

GET /health

If the Oracle is down or returning errors, check:

  1. trust_score at /trust-check — if null, Oracle is still building reputation
  2. pending count at /health — predictions are accumulating
  3. Try again in 10 minutes — the watcher runs every 10 minutes