Get a Robinhood Chain token's live USD price

The price endpoint answers one question as fast as possible: what is this Robinhood Chain token worth right now, in USD and ETH. Crius finds the token’s deepest market (the pool with the most liquidity within 2% of the price), reads its current price, and converts the quote asset (ETH, WETH, USDG or another priced token) to USD through the deepest ETH/USDG pool. The response says which pool was used and how much liquidity backs it, so you know how far to trust the number.

Get the price in one call

curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/price"

const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/price");
const { data, meta } = await res.json();

import requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/price",
)
body = r.json()
print(body["data"])

{
  "data": {
    "confidence": "medium",
    "dex": "uniswap_v4",
    "eth": 0.00000000165124,
    "eth_usd": 2355.49,
    "liquidity_usd": 5604.57,
    "quote": "0x0000000000000000000000000000000000000000",
    "quote_liquidity_usd": 2802.29,
    "source_pool": "0x871b166182fd708d5d16a4daa9a42f05a653fa51ee2b195097f425e0d9ca4913",
    "symbol": "CHARGE",
    "thin_liquidity": false,
    "token": "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8",
    "usd": 0.00000388948
  },
  "meta": {
    "block": 100406772,
    "block_age_ms": 654,
    "block_ts": 1793225075000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 66,
    "safe_block": 100401329
  }
}

curl "https://api.crius.sh/v1/robinhood/token/0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec/price"

const res = await fetch("https://api.crius.sh/v1/robinhood/token/0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec/price");
const { data, meta } = await res.json();

import requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/token/0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec/price",
)
body = r.json()
print(body["data"])

{
  "data": {
    "confidence": "high",
    "dex": "uniswap_v3",
    "eth": 0.0909845,
    "eth_usd": 2355.49,
    "liquidity_usd": 1415590,
    "quote": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
    "quote_liquidity_usd": 707795,
    "source_pool": "0xd4eb21209c4d6093f80b5b84f5c45cc093ea14a3",
    "symbol": "NVDA",
    "thin_liquidity": false,
    "token": "0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec",
    "usd": 214.313
  },
  "meta": {
    "block": 100409717,
    "block_age_ms": 717,
    "block_ts": 1793225377000,
    "chain": "robinhood",
    "finalized_block": 100401329,
    "lag_ms": 108,
    "safe_block": 100405028
  }
}

What the fields mean

How the source pool is chosen

A token can trade in many pools: Uniswap v2 pairs, v3 fee tiers, v4 pools with hooks and launchpad bonding curves. Crius ranks them by how much can actually be traded near the price (depth within ±2%), not by headline TVL, and skips pools that can’t set a fair price:

• Decoy pools. A pool with a fee of 25% or more never sets a price, because nobody really trades there.
• One-sided pools. A pool with only a bid near the price, or one implying a fully diluted value far beyond its liquidity, is only a last-resort fallback.
• Dust pools. Pools under $50 only count when the token has nothing else, and then thin_liquidity is true.

When the deepest market is quoted in another token (a meme paired with a tokenized stock, for example), that token’s own USD price is used, and the reported liquidity can’t exceed that token’s own market. Find every pool of a token to see the alternatives, with is_price_pool marking the one used here.

Use it in your app

import requests

token = "0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec"  # NVDA tokenized stock
r = requests.get(f"https://api.crius.sh/v1/robinhood/token/{token}/price", timeout=10)
r.raise_for_status()
p = r.json()["data"]

if p["thin_liquidity"] or p["confidence"] == "low":
    print(f"{p['symbol']}: ${p['usd']} (unreliable, ${p['quote_liquidity_usd']} in the pool)")
else:
    print(f"{p['symbol']}: ${p['usd']} ({p['confidence']} confidence, {p['dex']})")

Frequently asked questions

Related