erdGecrawl API — Smart Money Signals on Base L2

📡 API Endpoints

GET /health FREE ▶

Check API health and uptime status. No authentication required.

Example Request

curl https://api.ulol.li/health

Example Response

{ "status": "ok", "timestamp": "2025-07-25T12:00:00.000Z" }

GET /signals AUTH ▶

Get the latest smart money swap signals from tracked whale wallets on Base. Returns alerts from the last 24 hours with wallet labels, decoded actions, and token details.

Headers

Name	Type	Description
x-api-key	string *	Trial or paid API key
x-payer-address	string	Your wallet address (if using on-chain payment)

Example Request

curl -H "x-api-key: YOUR_KEY" \ https://api.ulol.li/signals

Example Response

[ { "timestamp": "2025-07-25T11:30:00Z", "wallet": "0x1234...abcd", "label": "jesse.base.eth", "decoded": { "action": "BUY", "token": "0xabcd...1234", "router": "Uniswap V3" }, "tokenSymbol": "DEGEN" } ]

GET /signals/score?token=ADDRESS AUTH ▶

Score a specific token based on safety analysis (honeypot, tax, mintable), liquidity, volume, wallet reputation, and smart money convergence. Returns a 0-100 score with recommended action.

Query Parameters

Name	Type	Description
token	address required	Token contract address on Base
walletLabel	string optional	Label of the wallet that triggered the signal

Example Request

curl -H "x-api-key: YOUR_KEY" \ https://api.ulol.li/signals/score?token=0x4ed4...1234

Example Response

{ "total": 65, "action": "paper", "reasons": [], "breakdown": { "wallet": 20, "token": 13, "safety": 25, "convergence": 12 }, "tokenInfo": { "symbol": "DEGEN", "priceUsd": 0.0042, "liquidity": 125000, "volume24h": 89000 }, "safety": { "safe": true, "honeypot": false, "mintable": false, "sellTax": 0 } }

GET /pairs/new AUTH ▶

Get recently detected new token pairs on Base DEXes. Useful for early-stage token discovery and sniping opportunities.

Example Request

curl -H "x-api-key: YOUR_KEY" \ https://api.ulol.li/pairs/new

Example Response

[ { "timestamp": "2025-07-25T10:00:00Z", "token0": { "symbol": "NEWTOKEN" }, "token1": { "symbol": "WETH" }, "pairAddress": "0x9876...5432", "dex": "Uniswap V3" } ]

POST /trial FREE ▶

Request Body

Name	Type	Description
agentId	string required	Your agent or bot identifier
contact	string optional	Contact info (email or Telegram handle)

Example Request

curl -X POST -H "Content-Type: application/json" \ -d '{"agentId": "my-trading-bot"}' \ https://api.ulol.li/trial

Example Response

{ "message": "Trial key generated successfully.", "apiKey": "a1b2c3d4e5f6...", "expiry": "2025-08-01T12:00:00.000Z", "hint": "Join our Telegram for whale alerts" }

GET /trial/status?key=KEY FREE ▶

Check the status and remaining validity of a trial API key.

Query Parameters

Name	Type	Description
key	string required	Your API key

Example Request

curl https://api.ulol.li/trial/status?key=a1b2c3d4e5f6

Example Response

{ "status": "active", "expiry": "2025-08-01T12:00:00.000Z", "daysRemaining": 6 }

GET /accuracy FREE ▶

View signal accuracy stats — win rate, average returns, and per-token breakdown from paper trading. Returns HTML when accessed from a browser, JSON otherwise.

Example Request

curl https://api.ulol.li/accuracy

Example Response

{ "totalPaperTrades": 42, "winRate": 61.5, "averageReturnPercent": 8.3, "closedTradesCount": 26 }

🔑 Authentication

🆓 Option 1: Free Trial Key

Get a free 7-day API key by calling POST /trial with your agent ID. No payment required.

        curl -X POST -H "Content-Type: application/json" \
     -d '{"agentId":"my-bot"}' https://api.ulol.li/trial
      

Then include the key in every request:

-H "x-api-key: YOUR_TRIAL_KEY"

⛓️ Option 2: On-Chain Payment

Send ≥ 0.0001 ETH on Base L2 to unlock 30 days of API access. Then use your wallet address as authentication.

0xA28F38d6F607b35a718C3e6193E7B622246d5a2B

Authenticate with your wallet address:

-H "x-payer-address: 0xYOUR_WALLET"