Skip to content

feat(action-providers): add Degenscan Intel provider (TS + Python) - #1626

Open
tradewr333-lgtm wants to merge 1 commit into
coinbase:mainfrom
tradewr333-lgtm:feat/degenscan-intel-action-provider
Open

tradewr333-lgtm wants to merge 1 commit into
coinbase:mainfrom
tradewr333-lgtm:feat/degenscan-intel-action-provider

Conversation

@tradewr333-lgtm

Copy link
Copy Markdown

Description

Adds degenscan_intel, a read-only HTTP action provider for Degenscan Intel (https://intel.degenscan.io): market data and market-event intelligence for trading agents.

Actions (same names in TypeScript and Python):

  • get_market_pulse: last-hour event counts by class, high-severity count, venues open ($0.001)
  • get_market_events: price-moving events from primary sources (SEC EDGAR, Fed and other central banks, Federal Register, FTC/DOJ/FDA/CFTC, USGS, NOAA, Nasdaq halts, DeFi hacks, Polymarket) with per-asset impacts ($0.005)
  • get_asset_brief: one-call pre-trade brief for one asset ($0.10)
  • get_perp_derivs: Hyperliquid funding, predicted funding by venue, open interest, premium, flags ($0.003)
  • get_deribit_perps: funding (8h and annualized), premium, open interest and 24h volume for Deribit perpetuals, the venue Coinbase Advanced / Coinbase for Agents uses for international perps, plus the funding gap vs Hyperliquid; one symbol adds 7 days of hourly funding ($0.002)

Why: AgentKit agents can act on-chain and, through Coinbase for Agents, trade perps, but have no native source of funding/positioning data or of the real-world events that move prices. The provider is paid the agent-native way: per call in USDC via x402 on Base (CDP facilitator) or Solana, or with a prepaid key bought with USDC (POST /v1/keys/x402/balance_5). No card, no account. A free trial (100 calls/day/IP) works with zero configuration.

Pattern: follows pyth: no wallet needed, supportsNetwork = () => true, zod / pydantic schemas, README, unit tests with a mocked fetch / requests session. Optional config: apiKey (or DEGENSCAN_INTEL_API_KEY), baseUrl, and (TS) fetchFn to pass an x402-wrapped fetch from @x402/fetch. Exports added to action-providers/index.ts and action_providers/__init__.py; changeset (patch) and changelog.d entry included.

Disclosure: the provider is maintained by the service operator (Marbella Collins LLC). Not affiliated with Coinbase, Deribit or Hyperliquid. Information and analytics only, not investment advice. Written with AI assistance (Claude) and reviewed by the maintainer.

Tests

Unit tests:
typescript/agentkit$ npx jest src/action-providers/degenscanIntel
Tests: 6 passed, 6 total
typescript/agentkit$ npx eslint -c .eslintrc.json "src/action-providers/degenscanIntel/*.ts" # clean
typescript/agentkit$ npx tsc --noEmit -p . # clean

python/coinbase-agentkit$ uv run pytest tests/action_providers/degenscan_intel -q
6 passed
python/coinbase-agentkit$ uv run ruff check . && uv run ruff format --check .                  # all checks passed

Live call used by get_deribit_perps (free trial header):
GET https://intel.degenscan.io/v1/deribit/perps?symbols=BTC,SOL (X-Free-Trial: 1)
→ 200, items[]: { symbol: "BTC", instrument: "BTC-PERPETUAL", funding_apr_pct: 13.62, funding_gap_vs_hyperliquid_apr_pct: 2.67, open_interest_usd: 690691240, ... }

🤖 Generated with Claude Code

@cb-heimdall

cb-heimdall commented Nov 6, 2026 •

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
1 if authored by an app that is not allowlisted and lacks verified human attribution 0
Sum 1

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider python typescript labels Nov 6, 2026
Read-only market-data provider: market pulse, market events with
per-asset impacts, asset brief, Hyperliquid perp derivs and Deribit
perps (venue for Coinbase Advanced international perps). Paid per
call via x402 (USDC) or API key; free trial without configuration.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NXwbW1TfFYJmEdHbPkKWsg
@tradewr333-lgtm
tradewr333-lgtm force-pushed the feat/degenscan-intel-action-provider branch from cba587e to 009c6f4 Compare November 6, 2026 11:25

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation python typescript

Development

Successfully merging this pull request may close these issues.

2 participants