API Documentation

Overview

Umbrix provides real-time blockchain intelligence APIs for token discovery, trend tracking, and wallet insights. Our mission is simple: make Web3 data accessible, powerful, and actionable — for builders, researchers, and explorers.

Umbrix APIs are designed to be lightweight, fast, and developer-friendly.

✅ Standard REST APIs

✅ JSON responses

✅ No complex setup

Core API Endpoints

Our core APIs provide essential data for blockchain analysis and token discovery.

📈 Trending Tokens API

Get the top 100 trending tokens based on transaction volume.

Endpoint:

bash
GET /tokens/trending

Optional Timeframe:

bash
GET /tokens/trending/{timeframe}

(Default = past 1 hour)

Available Timeframes:

5m, 15m, 30m, 1h (default), 2h, 3h, 4h, 5h, 6h, 12h, 24h

Example Request:

bash
curl --request GET \
  --url https://api.umbrix.ai/tokens/trending/1h \
  --header 'accept: application/json'

Response:

json
[
  {
    "token": {
      "name": "Pugg",
      "symbol": "PUGG",
      "mint": "H4ze...",
      "price": {
        "usd": 0.00179
      },
      "image": "https://image.url",
      "marketCap": 1795473,
      "volume": 2682388
    },
    "buysCount": 65,
    "sellsCount": 50,
    "priceChange24h": 63.9
  }
]

🧠 Token Profiles API

Fetch detailed metadata for the latest indexed tokens.

Endpoint:

bash
GET /token-profiles/latest

Example Request:

bash
curl --request GET \
  --url https://api.umbrix.ai/token-profiles/latest \
  --header 'accept: application/json'

🚀 Boosted Tokens API

Get tokens actively promoted across Umbrix ecosystem.

Endpoint:

bash
GET /token-boosts/latest

🛠️ Token Orders & Payment Status

Check if a token has paid for boosting services.

Endpoint:

bash
GET /orders/{chainId}/{tokenAddress}

🔍 Token Pair Details API

Retrieve liquidity and pricing info for token pairs.

Endpoint:

swift
GET /dex/pairs/{chainId}/{pairId}

Example:

bash
curl --request GET \
  --url https://api.umbrix.ai/dex/pairs/solana/JUPy... \
  --header 'accept: application/json'

📋 Authentication

Public access for basic endpoints. For higher limits or custom queries, contact support@umbrix.ai.

🛡️ Rate Limits

PlanRate Limit
Public60 requests/minute
Premium300 requests/minute

(429 Too Many Requests will be returned if you exceed.)

🚀 Quick Start Example

bash
# Get Trending Tokens (Past 1 Hour)
curl --request GET \
  --url https://api.umbrix.ai/tokens/trending/1h \
  --header 'accept: application/json'

📞 Support

Need help?

🛰️ Roadmap

  • Trending Token APIs
  • Token Metadata Indexing
  • Wallet Profiler (coming soon)
  • Risk Signal Engine (coming soon)