Robinhood Chain API for AI agents

AI agents and LLM assistants are asked Robinhood Chain questions all the time: “is this token safe”, “what is it worth”, “who holds it”, “what launched on Pons today”. They can only answer from data they can fetch. The Crius API gives an agent a small set of tools that return compact JSON with plain decimal numbers, human-unit amounts and the block each answer reflects, plus errors that explain themselves. An agent can start without a key, and the OpenAPI document turns into tool definitions directly.

Tools to give an agent

Expose a handful of tools rather than every endpoint. Models choose better from five clear tools than from thirty.

• GET/search name or symbol → address. Every other tool takes an address, so this comes first.
• GET/token/{address} the one-call summary: price, market cap, liquidity, holders, launchpad, LP lock, links.
• GET/token/{address}/security “is it safe”: score, risk, flags, taxes, honeypot.
• GET/token/{address}/price the cheapest call, for price questions and loops.
• GET/token/{address}/candles history questions (“how did it do this week”).
• GET/v1/status a freshness check before answering “right now” questions.

Add top traders, holders or token lists when your agent’s job needs them (holders and traders need a Free key).

Suggested architecture

Each tool call costs what the endpoint costs: 1 credit for search, profile, price and security, 2 for candles. An agent answering 2,000 questions a day with about four calls each uses roughly 8,000 to 16,000 credits a day, within the Free plan’s 1,000,000 a month.

Errors an agent can explain

curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders" \
  -H "x-api-key: $CRIUS_API_KEY"

const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders", {
  headers: { "x-api-key": process.env.CRIUS_API_KEY },
});
const { data, meta } = await res.json();

import os, requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])

{
  "error": {
    "code": "plan_required",
    "docs_url": "https://docs.crius.sh/plans-and-limits/",
    "message": "This endpoint needs an API key (Free plan or higher); you called it without one. To use it, get a free API key at https://dashboard.crius.sh.",
    "plan": "anon",
    "required_plan": "free",
    "upgrade_url": "https://dashboard.crius.sh"
  }
}

Check freshness first

curl "https://api.crius.sh/v1/status"

const res = await fetch("https://api.crius.sh/v1/status");
const { data, meta } = await res.json();

import requests

r = requests.get(
    "https://api.crius.sh/v1/status",
)
body = r.json()
print(body["data"])

{
  "data": {
    "chains": {
      "robinhood": {
        "addresses": 29509881,
        "block_age_ms": 1203,
        "chain_id": 4663,
        "finalized_block": 100397649,
        "indexed_block": 100406757,
        "lag_ms": 50,
        "pools": 2780862,
        "safe_block": 100401329,
        "start_block": 0,
        "status": "live",
        "tokens": 2406786
      }
    },
    "region": "rigel",
    "version": "0.1.0"
  }
}

{
  "name": "robinhood_token_security",
  "description": "Safety check for a Robinhood Chain token: score 0-100, risk level, honeypot, buy and sell tax, owner powers, LP lock. Call it before saying whether a token is safe. Needs the token's 0x address (use robinhood_search first if you only have a name).",
  "parameters": {
    "type": "object",
    "properties": {
      "address": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "description": "Token contract address" }
    },
    "required": ["address"]
  }
}

The tool calls GET https://api.crius.sh/v1/robinhood/token/{address}/security and returns data and meta.block to the model. More on prompts, the docs files for models and key setup is in Use the Crius API from AI agents and For AI agents & LLMs.

Frequently asked questions

Related