DSCVR Intelligence Skill

Query DSCVR crypto intelligence APIs for market news, event tracking, smart money analysis, prediction market data, AI-powered event discovery, market orderb...

Security Scan

The skill's code and SKILL.md require DSCVR API credentials, but the registry metadata does not declare any required environment variables or primary credential — an incoherence that warrants caution before installing.

Purpose & Capability

The skill's name, description, SKILL.md, README, and included Python code all consistently implement a DSCVR crypto-intelligence client (HMAC-SHA256 auth, various endpoints). Functionality matches the stated purpose.

Instruction Scope

Runtime instructions are appropriately scoped to calling the DSCVR API via included CLI scripts; they require Python/uv and explicit API credentials and do not attempt to read unrelated system files or other services.

Install Mechanism

This is instruction-plus-source (no external download URLs). Dependencies are declared inline (PEP 723) and resolved via uv; the only network targets are the DSCVR API base URL. No high-risk install URLs or archives are present.

Credentials

The SKILL.md and scripts require DSCVR_API_KEY and DSCVR_SECRET_KEY (and optional DSCVR_API_BASE_URL) — reasonable for the described API client. However, the registry metadata lists no required environment variables or primary credential, which is inconsistent and could mislead permission/secret review. The skill will read secret env vars at runtime and exit if missing.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system configuration, and has no elevated persistence. It only runs on invocation and makes outbound API calls to the configured base URL.

What to consider before installing

Do not install or provide secrets yet — there is a metadata mismatch. The package files and SKILL.md clearly require two secrets (DSCVR_API_KEY and DSCVR_SECRET_KEY), but the registry entry declares none. Before proceeding: 1) Ask the publisher to correct the registry metadata so required env vars/primary credential are declared. 2) Verify the DSCVR API base URL (defaults to https://dscvr.one) is legitimate. 3) If you must test, run the scripts in an isolated environment (container) and use a least-privilege or temporary API key you can revoke. 4) Consider rotating/revoking the key if you already provided it to this skill. If the registry metadata is corrected to explicitly require DSCVR_API_KEY/DSCVR_SECRET_KEY and nothing else, and the seller is trusted, the skill is coherent with its purpose.

Query DSCVR's crypto intelligence APIs to retrieve market news events, event categories, and detailed event analysis. All API calls are authenticated via HMAC-SHA256 signing.

Prerequisites

Before using this skill, ensure:

1. uv is installed — see docs.astral.sh/uv
2. Python 3.10+ is available (uv can install it for you: uv python install 3.10)
3. API credentials are configured — you need an api_key and secret_key obtained from a DSCVR subscription at dscvr.one/subscription.

No manual pip install needed — scripts declare their dependencies inline via PEP 723, and uv run resolves them automatically.

Configuration

The skill needs two environment variables (or they can be passed as arguments to scripts):

Variable	Description
DSCVR_API_KEY	Your 16-character public API key
DSCVR_SECRET_KEY	Your 32-character secret key
DSCVR_API_BASE_URL	API server base URL (default: https://dscvr.one)

Available Tools

1. Get Event Categories

Retrieve all available news event categories.

uv run scripts/dscvr_api.py categories

Returns a list of event categories with id, name, and image_url.

2. Get Event List

Retrieve paginated news events, optionally filtered by category and date.

uv run scripts/dscvr_api.py events [--category CATEGORY] [--date YYYY-MM-DD] [--page N] [--limit N]

Parameters:

• --category: Filter by category name (optional)
• --date: Filter by date in YYYY-MM-DD format (optional)
• --page: Page number, starting from 1 (default: 1)
• --limit: Results per page (default: 10)

3. Get Event Detail

Retrieve detailed information about a specific event.

uv run scripts/dscvr_api.py event-detail --event-id EVENT_ID

Parameters:

• --event-id: The event ID (required)

4. Smart Money Traders

List smart money traders with rich filtering options.

uv run scripts/dscvr_api.py smart-money [--keyword KW] [--win-rate HOT,STEADY,REVERSE] [--position-state ACTIVE,STREAK,SAFE] [--tx-size WHALE,MID,SMALL] [--style SWING,DIAMOND,HOT_ONLY] [--identity BOT,HUMAN,INSIDER] [--category politics,crypto,...] [--sort FIELD] [--ascending] [--page N] [--limit N]

Parameters:

• --keyword: Fuzzy search by name or bio (optional)
• --win-rate: Win rate filter, comma-separated: HOT, STEADY, REVERSE (optional)
• --position-state: Position state, comma-separated: ACTIVE, STREAK, SAFE (optional)
• --tx-size: Transaction size, comma-separated: WHALE, MID, SMALL, SMALL_LOSS, MID_LOSS (optional)
• --style: Position style, comma-separated: SWING, DIAMOND, HOT_ONLY (optional)
• --identity: Identity type, comma-separated: BOT, HUMAN, INSIDER (optional)
• --category: Domain category, comma-separated: politics, sports, crypto, economy, elections, culture, finance, mentions, world, geopolitics, earnings, climate_science, tech (optional)
• --sort: Sort field: TOTAL_PNL, WIN_RATE, TOTAL_TRADE_COUNT, TOTAL_TURNOVER, AVG_HOLD_TIME (default: TOTAL_PNL)
• --ascending: Sort ascending instead of descending (optional)
• --page: Page number (default: 1)
• --limit: Results per page (default: 20, max: 100)

5. Prediction Market Categories

List all available prediction market categories.

uv run scripts/dscvr_api.py market-categories [--source polymarket]

Parameters:

• --source: Data source (default: polymarket)

6. Prediction Market Listings

Browse prediction markets with filtering and smart money signals.

uv run scripts/dscvr_api.py markets [--source SRC] [--category CAT] [--smart-filter all|smart_money] [--sort FIELD] [--page N] [--limit N]

Parameters:

• --source: Data source (default: polymarket)
• --category: Category filter (default: all)
• --smart-filter: all or smart_money — filter to only show events with smart money activity (default: all)
• --sort: Sort field (prefix with - for ascending): smart_money_activity, volume_24h, liquidity, close_time
• --page: Page number (default: 1)
• --limit: Results per page (default: 20, max: 100)

7. Event Traders

Get smart money traders and their positions for a specific prediction market event.

uv run scripts/dscvr_api.py event-traders --event-id EVENT_ID [--page N] [--limit N]

Parameters:

• --event-id: The event ID (required)
• --page: Page number (default: 1)
• --limit: Results per page (default: 5, max: 10)

8. AI Discovery Categories

List all AI discovery event categories.

uv run scripts/dscvr_api.py ai-categories

9. AI Discovery Events

Browse AI-curated prediction market events with filters.

uv run scripts/dscvr_api.py ai-events [--category CAT] [--platform PLAT] [--active] [--page N] [--limit N]

Parameters:

• --category: Category filter (default: All)
• --platform: Platform filter (optional)
• --active: Only show active events (optional)
• --page: Page number (default: 1)
• --limit: Results per page (default: 10)

10. AI Event Search

Search AI discovery events by keyword.

uv run scripts/dscvr_api.py ai-search --query KEYWORD [--page N] [--limit N]

Parameters:

• --query: Search keyword (required)
• --page: Page number (default: 1)
• --limit: Results per page (default: 10)

11. AI Event Detail

Get detailed AI analysis for a specific event.

uv run scripts/dscvr_api.py ai-event-detail --provider PROVIDER --event-id EVENT_ID

Parameters:

• --provider: Provider name (required)
• --event-id: Event ID (required)

12. Market Orderbook

Get orderbook depth data for a prediction market.

uv run scripts/dscvr_api.py ai-orderbook [--kalshi-id ID] [--polymarket-id ID]

Parameters:

• --kalshi-id: Kalshi market ID (optional)
• --polymarket-id: Polymarket market ID (optional)
• At least one ID is required.

13. Social GraphQL

Query the DSCVR social graph via GraphQL. Supports user lookup, content lookup, portal lookup, and more.

uv run scripts/dscvr_api.py social-graphql --query '{ userByName(name: "alice") { id username followerCount } }'

Parameters:

• --query: GraphQL query string (required)

Available queries:

• user(id: DscvrId!) — Lookup user by principal ID
• userByName(name: String!) — Lookup user by username
• content(id: ContentId!) — Lookup content by ID
• portalBySlug(slug: String!) — Lookup portal by slug
• portalById(id: PortalId!) — Lookup portal by ID

Authentication

All API calls use HMAC-SHA256 request signing. The skill handles this automatically via scripts/auth.py. Three headers are sent with every request:

Header	Value
X-API-Key	Your public API key
X-Timestamp	Current Unix timestamp (seconds)
X-Signature	HMAC-SHA256(secret_key, "{api_key}:{timestamp}") hex digest

The timestamp must be within 5 minutes of the server's time. See references/auth-reference.md for the full signing specification.

Usage Examples

Example 1: Browse event categories

User prompt: "What crypto event categories does DSCVR track?"

Steps:

1. Run uv run scripts/dscvr_api.py categories
2. Present the category list to the user in a readable format

Example 2: Get recent events for a category

User prompt: "Show me the latest DeFi news events"

Steps:

1. First run uv run scripts/dscvr_api.py categories to find the matching category
2. Run uv run scripts/dscvr_api.py events --category "DeFi" to get events
3. Summarize the events for the user, highlighting key headlines and related coins

Example 3: Deep dive into a specific event

User prompt: "Tell me more about event #42"

Steps:

1. Run uv run scripts/dscvr_api.py event-detail --event-id 42
2. Present the full event details including sources, related coins, and analysis

Example 4: Daily market briefing

User prompt: "Give me today's crypto market briefing"

Steps:

1. Run uv run scripts/dscvr_api.py categories to get all categories
2. Run uv run scripts/dscvr_api.py events --date $(date +%Y-%m-%d) --limit 10 for today's top events
3. Synthesize the events into a coherent market briefing

Example 5: Find top smart money traders

User prompt: "Show me the top whale traders in crypto with the highest PnL"

Steps:

1. Run uv run scripts/dscvr_api.py smart-money --tx-size WHALE --category crypto --sort TOTAL_PNL --limit 10
2. Present the traders with their win rates, PnL, and recent activity

Example 6: Explore prediction markets

User prompt: "What prediction markets are trending with smart money?"

Steps:

1. Run uv run scripts/dscvr_api.py markets --smart-filter smart_money --sort smart_money_activity --limit 10
2. Summarize the top markets, highlighting smart money positions and popular outcomes

Example 7: Analyze smart money positions on an event

User prompt: "Who are the smart money traders betting on the Fed decision event?"

Steps:

1. Run uv run scripts/dscvr_api.py markets --category all --limit 50 to find the Fed decision event
2. Run uv run scripts/dscvr_api.py event-traders --event-id <EVENT_ID> with the found event ID
3. Present each trader's positions, realized/unrealized PnL, and trade direction

Example 8: Search AI discovery events

User prompt: "Find prediction market events about the US election"

Steps:

1. Run uv run scripts/dscvr_api.py ai-search --query "US election" --limit 10
2. Present the matching events with their categories and status

Example 9: Get market orderbook

User prompt: "Show me the orderbook for this Polymarket event"

Steps:

1. Run uv run scripts/dscvr_api.py ai-orderbook --polymarket-id <MARKET_ID>
2. Present the bid/ask depth and current prices

Example 10: Look up a DSCVR user

User prompt: "Find the DSCVR profile for user PopularDude99"

Steps:

1. Run uv run scripts/dscvr_api.py social-graphql --query '{ userByName(name: "PopularDude99") { id username followerCount } }'
2. Present the user's profile information

Error Handling

Error	Meaning	Action
401 Unauthorized	Invalid API key, bad signature, or expired timestamp	Check credentials and system clock
403 Forbidden	API key is temporarily banned (1-min cooldown after auth failure)	Wait 60 seconds and retry
404 Not Found	Endpoint or resource doesn't exist	Verify the endpoint path
429 Too Many Requests	Rate limit exceeded (100 req/min default)	Wait and retry with backoff
502 Bad Gateway	Upstream DSCVR service unavailable	Retry after a short delay

API Endpoint Pattern

All product endpoints follow the pattern:

/developer/v1/product/<module>/<endpoint>

Currently available modules:

• news — Crypto news and event intelligence
• market — Smart money analytics and prediction market data
• ai — AI-powered event discovery, search, and market orderbooks
• social — DSCVR social graph (GraphQL)

See references/api-reference.md for the complete API documentation.