TraderScan

Public futures data in. Market signals out.

A CROO agent that scans public crypto perpetual futures data and returns structured JSON market intelligence.

Website
Open TraderScan on CROO
View live JSON response

TraderScan turns public crypto futures data into ranked market intelligence.
It scans supported perpetual futures exchanges and returns bullish tokens, bearish tokens, squeeze risk, funding heat, crowded positioning, exchange leaders, risk levels, scores, and plain English explanations.

Overview

TraderScan is a zero input CROO agent for crypto perpetual futures market intelligence.

It scans public market data across supported exchanges and generates a structured JSON report that can be used by humans, dashboards, and other agents.

The user does not need to enter a symbol, connect an exchange account, share private API keys, provide wallet access, or rely on scraping.

TraderScan is designed for the CROO agent economy. A buyer can order the service on CROO, the provider runs the scan, and the result is delivered as a text JSON report.

Live Links

Item	Link
Website	`https://traderscan-web.vercel.app/`
CROO Agent	`https://agent.croo.network/agents/0df4b4bf-c710-42fc-b443-485e930c2539`
API Root	`https://traderscan-croo-provider.onrender.com/`
Scanner Endpoint	`https://traderscan-croo-provider.onrender.com/perp_signal_scanner`
Pretty JSON Endpoint	`https://traderscan-croo-provider.onrender.com/perp_signal_scanner_pretty`
Health Check	`https://traderscan-croo-provider.onrender.com/health`
CROO Status	`https://traderscan-croo-provider.onrender.com/croo/status`

What TraderScan Does

TraderScan turns public perpetual futures data into a ranked market intelligence report.

It helps answer:

Which tokens look bullish right now?
Which tokens look bearish right now?
Where is squeeze risk building?
Where is funding getting hot?
Which markets look crowded long?
Which markets look crowded short?
Which opportunities rank highest across exchanges?
Which exchange is producing the strongest signal?
What should the user watch next?
What can another agent reuse from the report?

Core Features

Zero Input

No prompt, symbol, exchange login, private API key, wallet connection, or scraping required.

Market Intelligence

Ranks opportunities using movement, volume, funding, open interest, and positioning signals where available.

Agent Ready JSON

Returns structured JSON that can be displayed by dashboards or consumed by other agents.

Signal Categories

Category	Meaning
`bullish`	Markets with bullish momentum or aggressive buyer activity.
`bearish`	Markets with bearish momentum or aggressive seller activity.
`squeeze_risk`	Markets showing possible short squeeze or long squeeze setups.
`funding_heat`	Markets with notable funding pressure or leverage heat.
`crowded_longs`	Markets where long positioning appears crowded.
`crowded_shorts`	Markets where short positioning appears crowded.
`global_ranked_opportunities`	Best opportunities ranked across all supported exchanges.
`exchanges`	Exchange by exchange scan status, leaders, returned opportunities, source URLs, and errors.

Supported Data Sources

TraderScan uses public perpetual futures market data only.

Exchange	Status	Data Type
Binance	Supported when hosting region allows access	Public futures market data
Bybit	Supported when hosting region allows access	Public futures market data
OKX	Supported	Public swap market data
Bitget	Supported	Public futures market data
Gate	Supported	Public futures market data
KuCoin	Supported	Public futures market data

TraderScan reports unavailable sources inside the JSON output instead of hiding failures.

Public Data Policy

TraderScan is built around public data only.

It does not use:

Private exchange accounts
User exchange API keys
Login sessions
Browser automation
Captcha bypass
Scraping
Private trader identity data
Trade execution
Custody
Wallet approvals

The agent does not place trades. It only returns market intelligence.

Service Output

TraderScan returns a structured JSON report.

Section	Purpose
`service`	Identifies the service as `perp_signal_scanner`.
`timestamp_utc`	Shows when the scan was generated.
`input_required`	Always false because TraderScan runs with no user input.
`status`	Overall scan status.
`summary`	Fast overview of market condition, counts, strongest opportunity, signal mix, and exchange leaders.
`bullish`	Tokens with bullish momentum or buyer pressure.
`bearish`	Tokens with bearish momentum or seller pressure.
`squeeze_risk`	Tokens showing possible short squeeze or long squeeze conditions.
`funding_heat`	Tokens with notable funding pressure.
`crowded_longs`	Markets where long positioning appears crowded.
`crowded_shorts`	Markets where short positioning appears crowded.
`global_ranked_opportunities`	Best opportunities across exchanges ranked by score.
`exchanges`	Exchange by exchange breakdown with leaders and opportunities.
`market_context`	Optional market context and source status.

Example Response Shape

{
  "service": "perp_signal_scanner",
  "timestamp_utc": "2026-07-11T12:00:00.000Z",
  "input_required": false,
  "status": "success",
  "summary": {
    "market_condition": "mixed",
    "success_exchanges": ["binance", "okx", "bitget", "gate", "kucoin"],
    "unavailable_exchanges": [],
    "strongest_opportunity": {
      "exchange": "binance",
      "symbol": "NEARUSDT",
      "signal_type": "aggressive_selling",
      "direction_bias": "bearish",
      "score": 77,
      "risk_level": "medium",
      "why_it_matters": "NEARUSDT shows aggressive seller flow.",
      "watch_next": "Watch whether seller pressure continues with rising volume."
    }
  },
  "bullish": [],
  "bearish": [],
  "squeeze_risk": [],
  "funding_heat": [],
  "crowded_longs": [],
  "crowded_shorts": [],
  "global_ranked_opportunities": [],
  "exchanges": {},
  "market_context": {}
}

Opportunity Object

Each ranked opportunity follows this shape.

{
  "rank": 1,
  "exchange": "binance",
  "symbol": "NEARUSDT",
  "base_asset": "NEAR",
  "signal_type": "aggressive_selling",
  "direction_bias": "bearish",
  "strength": "strong",
  "score": 77,
  "risk_level": "medium",
  "why_it_matters": "NEARUSDT shows aggressive seller flow.",
  "watch_next": "Watch whether seller pressure continues with rising volume.",
  "data_points": {
    "price_change_percent_24h": -2.68,
    "funding_rate": 0.0001,
    "long_short_ratio": 1.2,
    "taker_buy_sell_ratio": 0.31
  }
}

How Signals Are Scored

TraderScan normalizes public exchange data and assigns each opportunity a score from 0 to 100.

Data Point	Use
24 hour price movement	Detects momentum, weakness, and abnormal moves.
Volume or turnover	Filters for active markets.
Funding rate	Finds funding heat and possible crowded leverage.
Open interest	Shows futures participation where available.
Long short ratio	Detects crowded positioning where available.
Taker buy sell ratio	Detects aggressive buyer or seller flow where available.

Each opportunity includes:

Signal type
Direction bias
Strength
Score
Risk level
Why it matters
What to watch next
Supporting data points

Signal Types

Signal Type	Meaning
`bullish_momentum`	Upside movement with supporting activity.
`bearish_momentum`	Downside movement with supporting activity.
`crowded_longs`	Long side appears crowded based on available positioning data.
`crowded_shorts`	Short side appears crowded based on available positioning data.
`possible_short_squeeze`	Conditions may pressure short positions.
`possible_long_squeeze`	Conditions may pressure long positions.
`funding_heat`	Funding pressure is elevated.
`aggressive_buying`	Taker flow leans toward buyers where available.
`aggressive_selling`	Taker flow leans toward sellers where available.
`activity_watch`	Market activity is notable but direction is less clear.
`insufficient_data`	Signal could not be classified with confidence.

Direction Bias

Bias	Meaning
`bullish`	Signal leans toward upside pressure.
`bearish`	Signal leans toward downside pressure.
`crowded_long`	Long positioning appears crowded.
`crowded_short`	Short positioning appears crowded.
`mixed`	Signals conflict or direction is unclear.
`neutral`	No strong directional read.
`unknown`	Not enough data to classify bias.

Tech Stack

Technology	Purpose
Node.js 22	Runtime
TypeScript	Typed application code
Fastify	API server
Next.js 16	Landing page and live response display
Yarn Workspaces	Monorepo package management
`@croo-network/sdk`	CROO provider connection and order delivery
Render	API and CROO provider hosting
Vercel	Website hosting
Exchange public APIs	Perpetual futures market data

Project Structure

traderscan
  assets
    logo.png
  apps
    api
      package.json
      tsconfig.json
      src
        agent.ts
        config.ts
        croo_agent.ts
        croo_provider.ts
        croo_provider_standalone.ts
        index.ts
        server.ts
        sources
          http.ts
          market.ts
          perp_scanner.ts
    web
      package.json
      next.config.ts
      tsconfig.json
      public
        logo.png
      app
        globals.css
        layout.tsx
        page.tsx
  packages
    shared
      package.json
      tsconfig.json
      src
        index.ts
        types.ts
  package.json
  tsconfig.base.json

Quick Start

Install dependencies:

yarn install

Create local environment file:

cp .env.example .env

Run the API locally:

yarn dev

Run the website locally:

yarn web:dev

Build API only:

yarn build

Build API and website:

yarn build:all

Run lint:

yarn lint

Run format:

yarn format

Run full checks:

yarn check

Start production API locally:

yarn start

Environment Variables

Create .env from .env.example.

PORT=8080
HOST=0.0.0.0
REQUEST_TIMEOUT_MS=18000

CROO_API_URL=https://api.croo.network
CROO_WS_URL=wss://api.croo.network/ws
CROO_API_KEY=
CROO_SDK_KEY=
ENABLE_CROO_PROVIDER=false

For local API testing:

ENABLE_CROO_PROVIDER=false

For Render and CROO order delivery:

ENABLE_CROO_PROVIDER=true

Website environment variables:

NEXT_PUBLIC_CROO_AGENT_URL=https://agent.croo.network/agents/0df4b4bf-c710-42fc-b443-485e930c2539
NEXT_PUBLIC_TRADERSCAN_API_URL=https://traderscan-croo-provider.onrender.com/perp_signal_scanner

Never commit real CROO keys.

API Routes

Root metadata:

curl http://127.0.0.1:8080/

Health check:

curl http://127.0.0.1:8080/health

CROO provider status:

curl http://127.0.0.1:8080/croo/status

Scanner endpoint:

curl http://127.0.0.1:8080/perp_signal_scanner

Pretty scanner endpoint:

curl http://127.0.0.1:8080/perp_signal_scanner_pretty

Live production checks:

curl https://traderscan-croo-provider.onrender.com/
curl https://traderscan-croo-provider.onrender.com/health
curl https://traderscan-croo-provider.onrender.com/croo/status
curl https://traderscan-croo-provider.onrender.com/perp_signal_scanner
curl https://traderscan-croo-provider.onrender.com/perp_signal_scanner_pretty

CROO Integration

TraderScan runs as a CROO provider when ENABLE_CROO_PROVIDER=true.

Field	Value
Agent name	TraderScan
Service name	`perp_signal_scanner`
Input required	No
Deliverable type	Text JSON
SLA	Less than 30 minutes
Agent URL	`https://agent.croo.network/agents/0df4b4bf-c710-42fc-b443-485e930c2539`

Deliverable Schema

A structured JSON market intelligence report from TraderScan. The report includes summary, bullish tokens, bearish tokens, squeeze risk, funding heat, crowded longs, crowded shorts, global ranked opportunities, exchange by exchange leaders, market context, risk levels, scores, and plain English explanations for each signal.

Requirements Schema

No input required. The buyer can leave this blank. TraderScan automatically scans public perpetual futures market data across supported exchanges.

CROO Order Flow

Buyer

→

CROO

→

TraderScan Provider

→

Public APIs

→

JSON Report

→

Deliverable

Expected provider logs:

croo_provider_started
croo_negotiation_created
croo_negotiation_accepted
croo_order_paid
croo_order_delivered

Deployment

Render API Service

TraderScan API and CROO provider are deployed as a Render web service.

Build command:

yarn install && yarn build

Start command:

yarn start

Recommended Render environment variables:

HOST=0.0.0.0
REQUEST_TIMEOUT_MS=18000

CROO_API_URL=https://api.croo.network
CROO_WS_URL=wss://api.croo.network/ws
CROO_API_KEY=
CROO_SDK_KEY=your_real_croo_sdk_key
ENABLE_CROO_PROVIDER=true

Do not manually set PORT on Render unless needed. Render provides the port at runtime.

Vercel Web App

TraderScan website is deployed on Vercel.

Website URL:

https://traderscan-web.vercel.app/

Vercel project settings:

Framework Preset: Next.js
Root Directory: apps/web
Install Command: yarn install
Build Command: yarn build
Output Directory: leave empty
Node.js Version: 22.x

Vercel environment variables:

NEXT_PUBLIC_CROO_AGENT_URL=https://agent.croo.network/agents/0df4b4bf-c710-42fc-b443-485e930c2539
NEXT_PUBLIC_TRADERSCAN_API_URL=https://traderscan-croo-provider.onrender.com/perp_signal_scanner

Architecture

System Flow

Buyer

→

CROO Marketplace

→

TraderScan Provider

→

Public Market APIs

→

JSON Report

Scanner Pipeline

Fetch

→

Normalize

→

Score

→

Categorize

→

Rank

→

Deliver

Provider Flow

Start Fastify server
Connect CROO provider if enabled
Listen for negotiation events
Accept valid negotiation
Listen for paid order events
Run perp signal scanner
Deliver JSON report to CROO

Monorepo Scripts

Script	Purpose
`yarn build`	Build shared package and API.
`yarn build:all`	Build shared package, API, and web app.
`yarn dev`	Build shared package and run API in development mode.
`yarn web:dev`	Run the Next.js web app locally.
`yarn web:build`	Build the Next.js web app.
`yarn api:dev`	Run API in development mode.
`yarn api:build`	Build API only.
`yarn lint`	Run lint checks.
`yarn format`	Format the repository.
`yarn check`	Run build, lint, and format checks.

Why JSON

TraderScan delivers JSON because the result is meant to be useful beyond a human reading a page.

A human can view the report on the website.

A dashboard can render the ranked signals.

Another agent can read the fields directly.

A workflow can filter opportunities by score, risk level, exchange, or signal type.

This makes TraderScan useful as both a user facing tool and an agent to agent data service.

Limitations

TraderScan depends on public market endpoints.

Some exchanges may block certain hosting regions.

Some fields are not available on every exchange.

Public rate limits can affect availability.

The scanner reports unavailable exchanges and errors in the JSON output.

The output is market intelligence, not trade execution.

Disclaimer

TraderScan is a market intelligence tool. It is not financial advice.

The output is for research, monitoring, and signal discovery. Users should verify market conditions before making trading decisions.

Crypto markets are volatile. Signals can change quickly.

Built By

Built by Muhammad Adeel.

Crypto market intelligence · Public data · CROO agent infrastructure

Name		Name	Last commit message	Last commit date
apps		apps
assets		assets
packages/shared		packages/shared
.env.example		.env.example
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc.json		.prettierrc.json
README.md		README.md
eslint.config.js		eslint.config.js
package.json		package.json
tsconfig.base.json		tsconfig.base.json
yarn.lock		yarn.lock

Latest commit

History

Folders and files

Repository files navigation