{"id":"20de4fb4-dbd9-4ae5-8d5d-eb2aeb214de6","entityType":"agent","slug":"clawhub-blockbeatsofficial-blockbeats-skill","name":"blockbeats--skill","canonicalUrl":"https://www.xpersona.co/agent/clawhub-blockbeatsofficial-blockbeats-skill","canonicalPath":"/agent/clawhub-blockbeatsofficial-blockbeats-skill","generatedAt":"2026-10-09T17:24:45.744Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T16:56:41.430Z","emptyReason":null},"description":"BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also fea... Skill: blockbeats--skill Owner: blockbeatsofficial Summary: BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also fea... Tags: latest:1.0.3 Version history: v1.0.3 | 2026-03-24T03:06:59.350Z | user blockbeats-skill 1.0.3 - Updated environment and installation metadata for improved clarity and support (added primaryEnv,","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.3K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17b17aqkx7m4b713ghn52k86h83gdqr:blockbeats-skill","sourceUrl":"https://clawhub.ai/blockbeatsofficial/blockbeats-skill","homepage":"https://clawhub.ai/blockbeatsofficial/skills/blockbeats-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/blockbeatsofficial/blockbeats-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/blockbeatsofficial/skills/blockbeats-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":57,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also fea..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T16:56:41.430Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T16:56:41.430Z","emptyReason":null},"stars":null,"forks":null,"downloads":2262,"packageName":null,"latestVersion":"1.0.3","tractionLabel":"2.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T16:56:41.430Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T16:56:41.430Z","lastCrawledAt":"2026-10-09T16:56:41.430Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T16:56:41.430Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.3","createdAt":"2026-03-24T03:06:59.350Z","changelog":"blockbeats-skill 1.0.3 - Updated environment and installation metadata for improved clarity and support (added primaryEnv, install with Homebrew info). - Version bumped to 1.0.3 in metadata. - Removed the README.md file from the repository.","fileCount":3,"zipByteSize":6667},{"version":"1.0.2","createdAt":"2026-03-22T11:15:32.548Z","changelog":"- Initial release of BlockBeats Skill version 1.0.0. - Provides access to over 1,500 crypto information sources including AI insights, on-chain data, and market analytics. - Supports scenario-based queries: market overview, capital flow analysis, macro environment, derivatives market, keyword search, and news/article lists. - Enables robust keyword-based search functionality. - Includes clear output and interpretation rules for each supported scenario.","fileCount":3,"zipByteSize":6997},{"version":"1.0.1","createdAt":"2026-03-22T11:11:13.848Z","changelog":"- Updated description to highlight coverage of 1,500+ sources, AI-driven insights, Hyperliquid on-chain data, and Polymarket analytics. - Switched API base URLs from http to https for all endpoints. - Added explicit note on required environment variable: BLOCKBEATS_API_KEY. - Minor metadata corrections to ensure accurate requirements and platform tags. - No functional or code changes; documentation and metadata updates only.","fileCount":3,"zipByteSize":6999},{"version":"1.0.0","createdAt":"2026-03-22T11:05:48.833Z","changelog":"BlockBeats Skill 1.0.0 - Initial release of the BlockBeats API skill for crypto news and on-chain market data queries - Supports market overviews, capital flow analysis, macro environment assessment, derivatives market analysis, keyword search, and category-based news/article listings - Implements interpretation rules and clear output formats for actionable insights - Requires BLOCKBEATS_API_KEY and runs on darwin, linux, and win32 platforms","fileCount":3,"zipByteSize":6958}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17b17aqkx7m4b713ghn52k86h83gdqr:blockbeats-skill","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T17:24:45.741Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-blockbeatsofficial-blockbeats-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T16:56:41.430Z","emptyReason":null},"readme":"Skill: blockbeats--skill\n\nOwner: blockbeatsofficial\n\nSummary: BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also fea...\n\nTags: latest:1.0.3\n\nVersion history:\n\nv1.0.3 | 2026-03-24T03:06:59.350Z | user\n\nblockbeats-skill 1.0.3\n\n- Updated environment and installation metadata for improved clarity and support (added primaryEnv, install with Homebrew info).\n- Version bumped to 1.0.3 in metadata.\n- Removed the README.md file from the repository.\n\nv1.0.2 | 2026-03-22T11:15:32.548Z | user\n\n- Initial release of BlockBeats Skill version 1.0.0.\n- Provides access to over 1,500 crypto information sources including AI insights, on-chain data, and market analytics.\n- Supports scenario-based queries: market overview, capital flow analysis, macro environment, derivatives market, keyword search, and news/article lists.\n- Enables robust keyword-based search functionality.\n- Includes clear output and interpretation rules for each supported scenario.\n\nv1.0.1 | 2026-03-22T11:11:13.848Z | user\n\n- Updated description to highlight coverage of 1,500+ sources, AI-driven insights, Hyperliquid on-chain data, and Polymarket analytics.\n- Switched API base URLs from http to https for all endpoints.\n- Added explicit note on required environment variable: BLOCKBEATS_API_KEY.\n- Minor metadata corrections to ensure accurate requirements and platform tags.\n- No functional or code changes; documentation and metadata updates only.\n\nv1.0.0 | 2026-03-22T11:05:48.833Z | user\n\nBlockBeats Skill 1.0.0\n\n- Initial release of the BlockBeats API skill for crypto news and on-chain market data queries\n- Supports market overviews, capital flow analysis, macro environment assessment, derivatives market analysis, keyword search, and category-based news/article listings\n- Implements interpretation rules and clear output formats for actionable insights\n- Requires BLOCKBEATS_API_KEY and runs on darwin, linux, and win32 platforms\n\nArchive index:\n\nArchive v1.0.3: 3 files, 6667 bytes\n\nFiles: skill-card.md (2639b), SKILL.md (15604b), _meta.json (135b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: blockbeats-skill\r\ndescription: BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also features robust keyword-based search functionality.\r\nmetadata:\r\n  openclaw:\r\n    emoji: \"📰\"\r\n    primaryEnv: BLOCKBEATS_API_KEY\r\n    install:\r\n      - id: curl\r\n        kind: brew\r\n        formula: curl\r\n        label: curl (HTTP client)\r\n    requires:\r\n      bins:\r\n        - curl\r\n      env:\r\n        - BLOCKBEATS_API_KEY\r\n    os:\r\n      - darwin\r\n      - linux\r\n      - win32\r\n    tags:\r\n      - crypto\r\n      - news\r\n      - market-data\r\n      - on-chain\r\n      - defi\r\n  version: 1.0.3\r\n---\r\n\r\n# BlockBeats API Skill\r\n\r\nQuery crypto newsflashes, articles, search results, and on-chain market data via the BlockBeats Pro API.\r\n\r\n**Base URL**: `https://api-pro.theblockbeats.info`\r\n**Auth**: All requests require Header `api-key: $BLOCKBEATS_API_KEY`\r\n**Response format**: `{\"status\": 0, \"message\": \"\", \"data\": {...}}` — status 0 = success\r\n\r\n---\r\n\r\n## Scenario 1: Market Overview\r\n\r\n**Triggers**: How's the market today, market overview, daily summary, market conditions\r\n\r\nExecute the following four requests in parallel:\r\n\r\n```bash\r\n# 1. Market sentiment index\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/bottom_top_indicator\"\r\n\r\n# 2. Important newsflashes (latest 5)\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/newsflash/important\" \\\r\n  -G --data-urlencode \"size=5\" --data-urlencode \"lang=en\"\r\n\r\n# 3. BTC ETF net inflow\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/btc_etf\"\r\n\r\n# 4. Daily on-chain transaction volume\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/daily_tx\"\r\n```\r\n\r\n**Output format**:\r\n```\r\n📊 Market Overview · [Today's date]\r\n\r\nSentiment Index: [value] → [<20 potential buy zone / 20-80 neutral / >80 potential sell zone]\r\nBTC ETF: Today net inflow [value] million USD, cumulative [value] million\r\nOn-chain Volume: Today [value] (vs yesterday [↑/↓][change%])\r\nKey News:\r\n  · [Title 1] [time]\r\n  · [Title 2] [time]\r\n  · [Title 3] [time]\r\n```\r\n\r\n**Interpretation rules**:\r\n- Sentiment < 20 → Alert user to potential opportunities\r\n- Sentiment > 80 → Warn about sell-off risk\r\n- ETF positive inflow 3 days in a row → Institutional accumulation signal\r\n- ETF net inflow > 500M/day → Strong buy signal\r\n- Rising on-chain volume → Increasing on-chain activity and market heat\r\n\r\n---\r\n\r\n## Scenario 2: Capital Flow Analysis\r\n\r\n**Triggers**: Where is capital flowing, on-chain trends, which tokens are being bought, stablecoins, smart money\r\n\r\nExecute in parallel:\r\n\r\n```bash\r\n# 1. Top 10 tokens by on-chain net inflow (default solana; replace network param for Base/ETH)\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/top10_netflow\" \\\r\n  -G --data-urlencode \"network=solana\"\r\n\r\n# 2. Stablecoin market cap\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/stablecoin_marketcap\"\r\n\r\n# 3. BTC ETF net inflow\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/btc_etf\"\r\n```\r\n\r\nSelect `network` parameter based on user intent: `solana` (default) / `base` / `ethereum`\r\n\r\n**Output format**:\r\n```\r\n💰 Capital Flow Analysis\r\n\r\nOn-chain Trending ([chain]):\r\n  1. [token] Net inflow $[value]  Market cap $[value]\r\n  2. ...\r\n\r\nStablecoins: USDT [↑/↓] USDC [↑/↓] (expansion/contraction signal)\r\nInstitutional: ETF today [inflow/outflow] [value] million USD\r\n```\r\n\r\n**Interpretation rules**:\r\n- Stablecoin market cap expanding → More capital in market, stronger buy potential\r\n- Stablecoin market cap shrinking → Capital exiting, caution advised\r\n\r\n---\r\n\r\n## Scenario 3: Macro Environment Assessment\r\n\r\n**Triggers**: Macro environment, is it a good time to enter, liquidity, US Treasuries, dollar, M2, big picture\r\n\r\nExecute in parallel:\r\n\r\n```bash\r\n# 1. Global M2 supply\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/m2_supply\" \\\r\n  -G --data-urlencode \"type=1Y\"\r\n\r\n# 2. US 10Y Treasury yield\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/us10y\" \\\r\n  -G --data-urlencode \"type=1M\"\r\n\r\n# 3. DXY Dollar Index\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/dxy\" \\\r\n  -G --data-urlencode \"type=1M\"\r\n\r\n# 4. Compliant exchange total assets\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/compliant_total\"\r\n```\r\n\r\n**Output format**:\r\n```\r\n🌐 Macro Environment Assessment\r\n\r\nGlobal M2: [latest value] YoY [↑/↓][change%] → [expansionary/contractionary]\r\nUS Treasury Yield (10Y): [latest value]% → [rising/falling trend]\r\nDollar Index (DXY): [latest value] → [strong/weak]\r\nCompliant Exchange Assets: $[value] → [inflow/outflow trend]\r\n\r\nOverall: [bullish/neutral/bearish] for crypto market\r\n```\r\n\r\n**Interpretation rules**:\r\n- M2 YoY > 5% → Loose liquidity, favorable for risk assets\r\n- M2 YoY < 0% → Liquidity tightening, caution\r\n- DXY rising → Strong dollar, crypto under pressure\r\n- DXY falling → Weak dollar, crypto benefits\r\n- Rising Treasury yield → Higher risk-free rate, capital returning to bonds\r\n- Rising compliant exchange assets → Growing institutional allocation appetite\r\n\r\n---\r\n\r\n## Scenario 4: Derivatives Market Analysis\r\n\r\n**Triggers**: Futures market, long/short positioning, open interest, Binance Bybit OI, leverage risk\r\n\r\nExecute in parallel:\r\n\r\n```bash\r\n# 1. Major derivatives platform comparison\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/contract\" \\\r\n  -G --data-urlencode \"dataType=1D\"\r\n\r\n# 2. Exchange snapshot\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/exchanges\" \\\r\n  -G --data-urlencode \"size=10\"\r\n\r\n# 3. Bitfinex BTC long positions\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/bitfinex_long\" \\\r\n  -G --data-urlencode \"symbol=btc\" --data-urlencode \"type=1D\"\r\n```\r\n\r\n**Output format**:\r\n```\r\n⚡ Derivatives Market Analysis\r\n\r\nPlatform OI:\r\n  Binance [value]  Bybit [value]  Hyperliquid [value]\r\n\r\nExchange Rankings (by volume):\r\n  1. [name] Volume $[value]  OI $[value]\r\n  2. ...\r\n\r\nBitfinex BTC Longs: [value] → [increasing/decreasing] (leveraged long sentiment [strong/weak])\r\n```\r\n\r\n**Interpretation rules**:\r\n- Bitfinex longs persistently increasing → Large players bullish, market confidence growing\r\n- Bitfinex longs dropping sharply → Watch for long liquidation cascade\r\n\r\n---\r\n\r\n## Scenario 5: Keyword Search\r\n\r\n**Triggers**: search [keyword], find [keyword], [keyword] news, what's happening with [keyword]\r\n\r\n```bash\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/search\" \\\r\n  -G --data-urlencode \"name=[keyword]\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\r\n```\r\n\r\nResponse fields: `title`, `abstract`, `content` (plain text), `type` (0=article, 1=newsflash), `time_cn` (relative time), `img_url`, `url`; pagination object: `total`, `page`, `size`, `total_pages`; `size` max 100\r\n\r\n---\r\n\r\n## Scenario 6: Newsflash & Article Lists\r\n\r\nSelect the appropriate newsflash category or article endpoint based on user intent. Default returns 10 items; use `size` param to adjust.\r\n\r\n**Newsflash category triggers and endpoints**:\r\n\r\n| User says | Endpoint path |\r\n|-----------|--------------|\r\n| latest news / newsflash list / what's new | `/v1/newsflash` |\r\n| last 24 hours / past 24h / today's all news | `/v1/newsflash/24h` |\r\n| important news / major events / key headlines | `/v1/newsflash/important` |\r\n| original newsflash / original coverage | `/v1/newsflash/original` |\r\n| first-report / exclusive / scoop | `/v1/newsflash/first` |\r\n| on-chain news / on-chain data / on-chain updates | `/v1/newsflash/onchain` |\r\n| financing news / fundraising / VC deals / investment rounds | `/v1/newsflash/financing` |\r\n| prediction market / Polymarket / forecast / betting | `/v1/newsflash/prediction` |\r\n| AI news / AI updates / AI projects / artificial intelligence | `/v1/newsflash/ai` |\r\n\r\n**Article category triggers and endpoints**:\r\n\r\n| User says | Endpoint path |\r\n|-----------|--------------|\r\n| article list / in-depth articles / latest articles | `/v1/article` |\r\n| last 24 hours articles / today's articles (up to 50, no pagination) | `/v1/article/24h` |\r\n| important articles / key reports | `/v1/article/important` |\r\n| original articles / original analysis | `/v1/article/original` |\r\n\r\n**Request example** (AI newsflash):\r\n\r\n```bash\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/newsflash/ai\" \\\r\n  -G --data-urlencode \"page=1\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\r\n```\r\n\r\n**Output format**:\r\n\r\n```\r\n📰 [Category Name] · Latest [N] items\r\n\r\n1. [Title] [time_cn]\r\n   [abstract, if available]\r\n\r\n2. [Title] [time_cn]\r\n   [abstract, if available]\r\n...\r\n```\r\n\r\n**Notes**:\r\n- `content` field is HTML; strip tags and display plain text only\r\n- Article endpoints do NOT have a `url` field; use `link` for the article page URL\r\n\r\n---\r\n\r\n## Single Endpoint Reference\r\n\r\n### Newsflash Endpoints (all support page/size/lang)\r\n\r\n| Endpoint | URL |\r\n|----------|-----|\r\n| All newsflashes | `GET /v1/newsflash` |\r\n| Last 24 hours (no pagination) | `GET /v1/newsflash/24h` |\r\n| Important | `GET /v1/newsflash/important` |\r\n| Original | `GET /v1/newsflash/original` |\r\n| First-report | `GET /v1/newsflash/first` |\r\n| On-chain | `GET /v1/newsflash/onchain` |\r\n| Financing | `GET /v1/newsflash/financing` |\r\n| Prediction market | `GET /v1/newsflash/prediction` |\r\n| AI | `GET /v1/newsflash/ai` |\r\n\r\n```bash\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/newsflash/[type]\" \\\r\n  -G --data-urlencode \"page=1\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\r\n```\r\n\r\n### Article Endpoints\r\n\r\n| Endpoint | URL | Params |\r\n|----------|-----|--------|\r\n| All articles | `GET /v1/article` | page/size/lang |\r\n| Last 24 hours (no pagination, up to 50) | `GET /v1/article/24h` | lang only |\r\n| Important | `GET /v1/article/important` | page/size/lang |\r\n| Original | `GET /v1/article/original` | page/size/lang |\r\n\r\n### RSS Endpoints\r\n\r\n| Endpoint | URL | Key Parameters |\r\n|----------|-----|----------------|\r\n| Newsflash RSS | `GET /v1/rss/newsflash` | `page` `size` (1-50) |\r\n| Article RSS | `GET /v1/rss/article` | `page` `size` (1-50) |\r\n\r\nRSS endpoints return XML format. Use when user requests RSS feed or wants to subscribe to updates.\r\n\r\n### Data Endpoints\r\n\r\n| Endpoint | URL | Key Parameters |\r\n|----------|-----|----------------|\r\n| BTC ETF net inflow | `GET /v1/data/btc_etf` | none |\r\n| Daily on-chain volume | `GET /v1/data/daily_tx` | none |\r\n| IBIT/FBTC net inflow | `GET /v1/data/ibit_fbtc` | none |\r\n| Stablecoin market cap | `GET /v1/data/stablecoin_marketcap` | none |\r\n| Compliant exchange assets | `GET /v1/data/compliant_total` | none |\r\n| US Treasury yield | `GET /v1/data/us10y` | `type=1D/1W/1M` |\r\n| Dollar Index (DXY) | `GET /v1/data/dxy` | `type=1D/1W/1M` |\r\n| Global M2 supply | `GET /v1/data/m2_supply` | `type=3M/6M/1Y/3Y` |\r\n| Bitfinex long positions | `GET /v1/data/bitfinex_long` | `symbol=btc` `type=1D/1W/1M/h24` |\r\n| Derivatives platform data | `GET /v1/data/contract` | `dataType=1D/1W/1M/3M/6M/12M` |\r\n| Buy/sell indicator | `GET /v1/data/bottom_top_indicator` | none |\r\n| Top 10 on-chain net inflow | `GET /v1/data/top10_netflow` | `network=solana/base/ethereum` |\r\n| Exchange snapshot | `GET /v1/data/exchanges` | `name` `page` `size` |\r\n\r\n---\r\n\r\n## Time Dimension Mapping\r\n\r\n| User says | Parameter |\r\n|-----------|-----------|\r\n| today / latest / real-time | `type=1D` or `size=5` |\r\n| this week / recent | `type=1W` |\r\n| this month / last 30 days | `type=1M` |\r\n| this year / long-term trend | `type=1Y` or `type=3Y` |\r\n| last 24 hours (bitfinex_long only) | `type=h24` |\r\n\r\n---\r\n\r\n## Intent Mapping\r\n\r\n| User intent | Scenario / endpoint |\r\n|-------------|---------------------|\r\n| How's the market today / daily overview | Scenario 1: Market Overview |\r\n| Capital flow / on-chain trends / smart money | Scenario 2: Capital Flow |\r\n| Macro / M2 / US Treasuries / good time to enter | Scenario 3: Macro Assessment |\r\n| Futures / open interest / exchange OI / leverage risk | Scenario 4: Derivatives |\r\n| search [keyword] | Scenario 5: Search |\r\n| Latest news / newsflash list | `GET /v1/newsflash` |\r\n| Last 24 hours / today all newsflashes | `GET /v1/newsflash/24h` |\r\n| Important newsflashes | `GET /v1/newsflash/important` |\r\n| Original newsflashes | `GET /v1/newsflash/original` |\r\n| First-report newsflashes | `GET /v1/newsflash/first` |\r\n| On-chain newsflashes | `GET /v1/newsflash/onchain` |\r\n| Financing news | `GET /v1/newsflash/financing` |\r\n| Prediction market / Polymarket | `GET /v1/newsflash/prediction` |\r\n| AI newsflashes / AI news | `GET /v1/newsflash/ai` |\r\n| Article list | `GET /v1/article` |\r\n| Last 24 hours articles / today's articles | `GET /v1/article/24h` |\r\n| Important articles | `GET /v1/article/important` |\r\n| Original articles | `GET /v1/article/original` |\r\n| BTC ETF inflow | `GET /v1/data/btc_etf` |\r\n| IBIT FBTC | `GET /v1/data/ibit_fbtc` |\r\n| Stablecoin market cap / USDT USDC | `GET /v1/data/stablecoin_marketcap` |\r\n| Dollar index / DXY | `GET /v1/data/dxy` |\r\n| Bitfinex longs / leveraged positions | `GET /v1/data/bitfinex_long` |\r\n| Buy/sell signal / market sentiment | `GET /v1/data/bottom_top_indicator` |\r\n| Top inflow tokens / on-chain trending | `GET /v1/data/top10_netflow` |\r\n| Exchange rankings | `GET /v1/data/exchanges` |\r\n| On-chain volume / activity | `GET /v1/data/daily_tx` |\r\n| Compliant exchange assets / institutional custody | `GET /v1/data/compliant_total` |\r\n\r\n---\r\n\r\n## Data Refresh Frequency\r\n\r\n| Endpoint type | Update frequency |\r\n|---------------|-----------------|\r\n| Newsflash / articles / search | Real-time |\r\n| top10_netflow | Near real-time |\r\n| btc_etf / ibit_fbtc / daily_tx | Daily (T+1) |\r\n| stablecoin_marketcap / compliant_total | Daily |\r\n| bottom_top_indicator | Daily |\r\n| us10y / dxy | Intraday minute-level |\r\n| m2_supply | Monthly |\r\n| exchanges / contract | Daily |\r\n| bitfinex_long | Daily (h24 param is near real-time) |\r\n\r\n---\r\n\r\n## Error Handling\r\n\r\n| Error condition | Response |\r\n|----------------|----------|\r\n| `BLOCKBEATS_API_KEY` not set | Prompt: Please set the BLOCKBEATS_API_KEY environment variable. Apply at: https://www.theblockbeats.info/ |\r\n| status 100 | Missing API key — please provide your api-key header |\r\n| status 101 | Invalid API key — please verify your key |\r\n| status 102 | API key expired — please renew your subscription |\r\n| status 103 | Invalid request method — check that you are using GET |\r\n| status -1 | General failure — display the `message` field content |\r\n| Request timeout | Prompt to retry; do not interrupt other parallel requests |\r\n| data is empty array | Explain possible reasons (non-trading day, data delay, no data for this token) |\r\n\r\n## Notes\r\n\r\n- `content` field is HTML; strip tags and display plain text only\r\n- `create_time` field format: `Y-m-d H:i:s`\r\n- Numeric fields (price/vol etc.) are strings; format as numbers when displaying\r\n- When running parallel requests, a failure on one endpoint must not block display of others\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7dybqnmkdzwstxgz8z1nha0s82dwja\",\n  \"slug\": \"blockbeats-skill\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1774321619350\n}\n\nFile v1.0.3:skill-card.md\n\n## Description:\n\nBlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[blockbeatsofficial](https://clawhub.ai/user/blockbeatsofficial)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to query BlockBeats Pro API news, article, search, RSS, and crypto market-data endpoints. It supports market overview, capital flow, macro, derivatives, keyword search, and news-list workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends market, news, and keyword-search queries to BlockBeats using a user-provided API key.\n\nMitigation: Install only when that data sharing is acceptable, keep BLOCKBEATS_API_KEY in environment configuration, and avoid sensitive keyword searches.\n\nRisk: Market interpretation rules may produce buy, sell, bullish, or bearish commentary.\n\nMitigation: Present those outputs as informational market commentary rather than financial advice.\n\nRisk: Broad trigger phrases such as market overview or search terms may invoke external API calls unexpectedly.\n\nMitigation: Prefer explicit prompts such as 'search BlockBeats for ...' and confirm intent before sending ambiguous queries.\n\nRisk: Results depend on BlockBeats API availability, subscription status, and endpoint data-refresh frequency.\n\nMitigation: Surface API status messages clearly, tolerate partial request failures, and note data delays where endpoint behavior indicates daily or monthly refreshes.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/blockbeatsofficial/skills/blockbeats-skill)\n- [Publisher profile](https://clawhub.ai/user/blockbeatsofficial)\n- [BlockBeats Pro API base URL](https://api-pro.theblockbeats.info)\n- [BlockBeats API access page](https://www.theblockbeats.info/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, guidance]\n\n**Output Format:** [Markdown summaries with inline shell commands and API response interpretation]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires curl and BLOCKBEATS_API_KEY; sends selected market, news, and keyword queries to BlockBeats.]\n\n## Skill Version(s):\n\n1.0.3 (source: release evidence and skill metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.2: 3 files, 6997 bytes\n\nFiles: README.md (3565b), SKILL.md (15034b), _meta.json (135b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: blockbeats-skill\ndescription: BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also features robust keyword-based search functionality.\nmetadata:\n  openclaw:\n    emoji: \"📰\"\n    requires:\n      bins:\n        - curl\n      env:\n        - BLOCKBEATS_API_KEY\n    os:\n      - darwin\n      - linux\n      - win32\n    tags:\n      - crypto\n      - news\n      - market-data\n      - on-chain\n      - defi\n  version: 1.0.0\n---\n\n# BlockBeats API Skill\n\nQuery crypto newsflashes, articles, search results, and on-chain market data via the BlockBeats Pro API.\n\n**Base URL**: `https://api-pro.theblockbeats.info`\n**Auth**: All requests require Header `api-key: $BLOCKBEATS_API_KEY`\n**Response format**: `{\"status\": 0, \"message\": \"\", \"data\": {...}}` — status 0 = success\n\n---\n\n## Scenario 1: Market Overview\n\n**Triggers**: How's the market today, market overview, daily summary, market conditions\n\nExecute the following four requests in parallel:\n\n```bash\n# 1. Market sentiment index\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/bottom_top_indicator\"\n\n# 2. Important newsflashes (latest 5)\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/newsflash/important\" \\\n  -G --data-urlencode \"size=5\" --data-urlencode \"lang=en\"\n\n# 3. BTC ETF net inflow\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/btc_etf\"\n\n# 4. Daily on-chain transaction volume\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/daily_tx\"\n```\n\n**Output format**:\n```\n📊 Market Overview · [Today's date]\n\nSentiment Index: [value] → [<20 potential buy zone / 20-80 neutral / >80 potential sell zone]\nBTC ETF: Today net inflow [value] million USD, cumulative [value] million\nOn-chain Volume: Today [value] (vs yesterday [↑/↓][change%])\nKey News:\n  · [Title 1] [time]\n  · [Title 2] [time]\n  · [Title 3] [time]\n```\n\n**Interpretation rules**:\n- Sentiment < 20 → Alert user to potential opportunities\n- Sentiment > 80 → Warn about sell-off risk\n- ETF positive inflow 3 days in a row → Institutional accumulation signal\n- ETF net inflow > 500M/day → Strong buy signal\n- Rising on-chain volume → Increasing on-chain activity and market heat\n\n---\n\n## Scenario 2: Capital Flow Analysis\n\n**Triggers**: Where is capital flowing, on-chain trends, which tokens are being bought, stablecoins, smart money\n\nExecute in parallel:\n\n```bash\n# 1. Top 10 tokens by on-chain net inflow (default solana; replace network param for Base/ETH)\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/top10_netflow\" \\\n  -G --data-urlencode \"network=solana\"\n\n# 2. Stablecoin market cap\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/stablecoin_marketcap\"\n\n# 3. BTC ETF net inflow\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/btc_etf\"\n```\n\nSelect `network` parameter based on user intent: `solana` (default) / `base` / `ethereum`\n\n**Output format**:\n```\n💰 Capital Flow Analysis\n\nOn-chain Trending ([chain]):\n  1. [token] Net inflow $[value]  Market cap $[value]\n  2. ...\n\nStablecoins: USDT [↑/↓] USDC [↑/↓] (expansion/contraction signal)\nInstitutional: ETF today [inflow/outflow] [value] million USD\n```\n\n**Interpretation rules**:\n- Stablecoin market cap expanding → More capital in market, stronger buy potential\n- Stablecoin market cap shrinking → Capital exiting, caution advised\n\n---\n\n## Scenario 3: Macro Environment Assessment\n\n**Triggers**: Macro environment, is it a good time to enter, liquidity, US Treasuries, dollar, M2, big picture\n\nExecute in parallel:\n\n```bash\n# 1. Global M2 supply\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/m2_supply\" \\\n  -G --data-urlencode \"type=1Y\"\n\n# 2. US 10Y Treasury yield\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/us10y\" \\\n  -G --data-urlencode \"type=1M\"\n\n# 3. DXY Dollar Index\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/dxy\" \\\n  -G --data-urlencode \"type=1M\"\n\n# 4. Compliant exchange total assets\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/compliant_total\"\n```\n\n**Output format**:\n```\n🌐 Macro Environment Assessment\n\nGlobal M2: [latest value] YoY [↑/↓][change%] → [expansionary/contractionary]\nUS Treasury Yield (10Y): [latest value]% → [rising/falling trend]\nDollar Index (DXY): [latest value] → [strong/weak]\nCompliant Exchange Assets: $[value] → [inflow/outflow trend]\n\nOverall: [bullish/neutral/bearish] for crypto market\n```\n\n**Interpretation rules**:\n- M2 YoY > 5% → Loose liquidity, favorable for risk assets\n- M2 YoY < 0% → Liquidity tightening, caution\n- DXY rising → Strong dollar, crypto under pressure\n- DXY falling → Weak dollar, crypto benefits\n- Rising Treasury yield → Higher risk-free rate, capital returning to bonds\n- Rising compliant exchange assets → Growing institutional allocation appetite\n\n---\n\n## Scenario 4: Derivatives Market Analysis\n\n**Triggers**: Futures market, long/short positioning, open interest, Binance Bybit OI, leverage risk\n\nExecute in parallel:\n\n```bash\n# 1. Major derivatives platform comparison\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/contract\" \\\n  -G --data-urlencode \"dataType=1D\"\n\n# 2. Exchange snapshot\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/exchanges\" \\\n  -G --data-urlencode \"size=10\"\n\n# 3. Bitfinex BTC long positions\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/bitfinex_long\" \\\n  -G --data-urlencode \"symbol=btc\" --data-urlencode \"type=1D\"\n```\n\n**Output format**:\n```\n⚡ Derivatives Market Analysis\n\nPlatform OI:\n  Binance [value]  Bybit [value]  Hyperliquid [value]\n\nExchange Rankings (by volume):\n  1. [name] Volume $[value]  OI $[value]\n  2. ...\n\nBitfinex BTC Longs: [value] → [increasing/decreasing] (leveraged long sentiment [strong/weak])\n```\n\n**Interpretation rules**:\n- Bitfinex longs persistently increasing → Large players bullish, market confidence growing\n- Bitfinex longs dropping sharply → Watch for long liquidation cascade\n\n---\n\n## Scenario 5: Keyword Search\n\n**Triggers**: search [keyword], find [keyword], [keyword] news, what's happening with [keyword]\n\n```bash\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/search\" \\\n  -G --data-urlencode \"name=[keyword]\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\n```\n\nResponse fields: `title`, `abstract`, `content` (plain text), `type` (0=article, 1=newsflash), `time_cn` (relative time), `img_url`, `url`; pagination object: `total`, `page`, `size`, `total_pages`; `size` max 100\n\n---\n\n## Scenario 6: Newsflash & Article Lists\n\nSelect the appropriate newsflash category or article endpoint based on user intent. Default returns 10 items; use `size` param to adjust.\n\n**Newsflash category triggers and endpoints**:\n\n| User says | Endpoint path |\n|-----------|--------------|\n| latest news / newsflash list / what's new | `/v1/newsflash` |\n| last 24 hours / past 24h / today's all news | `/v1/newsflash/24h` |\n| important news / major events / key headlines | `/v1/newsflash/important` |\n| original newsflash / original coverage | `/v1/newsflash/original` |\n| first-report / exclusive / scoop | `/v1/newsflash/first` |\n| on-chain news / on-chain data / on-chain updates | `/v1/newsflash/onchain` |\n| financing news / fundraising / VC deals / investment rounds | `/v1/newsflash/financing` |\n| prediction market / Polymarket / forecast / betting | `/v1/newsflash/prediction` |\n| AI news / AI updates / AI projects / artificial intelligence | `/v1/newsflash/ai` |\n\n**Article category triggers and endpoints**:\n\n| User says | Endpoint path |\n|-----------|--------------|\n| article list / in-depth articles / latest articles | `/v1/article` |\n| last 24 hours articles / today's articles (up to 50, no pagination) | `/v1/article/24h` |\n| important articles / key reports | `/v1/article/important` |\n| original articles / original analysis | `/v1/article/original` |\n\n**Request example** (AI newsflash):\n\n```bash\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/newsflash/ai\" \\\n  -G --data-urlencode \"page=1\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\n```\n\n**Output format**:\n\n```\n📰 [Category Name] · Latest [N] items\n\n1. [Title] [time_cn]\n   [abstract, if available]\n\n2. [Title] [time_cn]\n   [abstract, if available]\n...\n```\n\n**Notes**:\n- `content` field is HTML; strip tags and display plain text only\n- Article endpoints do NOT have a `url` field; use `link` for the article page URL\n\n---\n\n## Single Endpoint Reference\n\n### Newsflash Endpoints (all support page/size/lang)\n\n| Endpoint | URL |\n|----------|-----|\n| All newsflashes | `GET /v1/newsflash` |\n| Last 24 hours (no pagination) | `GET /v1/newsflash/24h` |\n| Important | `GET /v1/newsflash/important` |\n| Original | `GET /v1/newsflash/original` |\n| First-report | `GET /v1/newsflash/first` |\n| On-chain | `GET /v1/newsflash/onchain` |\n| Financing | `GET /v1/newsflash/financing` |\n| Prediction market | `GET /v1/newsflash/prediction` |\n| AI | `GET /v1/newsflash/ai` |\n\n```bash\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/newsflash/[type]\" \\\n  -G --data-urlencode \"page=1\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\n```\n\n### Article Endpoints\n\n| Endpoint | URL | Params |\n|----------|-----|--------|\n| All articles | `GET /v1/article` | page/size/lang |\n| Last 24 hours (no pagination, up to 50) | `GET /v1/article/24h` | lang only |\n| Important | `GET /v1/article/important` | page/size/lang |\n| Original | `GET /v1/article/original` | page/size/lang |\n\n### RSS Endpoints\n\n| Endpoint | URL | Key Parameters |\n|----------|-----|----------------|\n| Newsflash RSS | `GET /v1/rss/newsflash` | `page` `size` (1-50) |\n| Article RSS | `GET /v1/rss/article` | `page` `size` (1-50) |\n\nRSS endpoints return XML format. Use when user requests RSS feed or wants to subscribe to updates.\n\n### Data Endpoints\n\n| Endpoint | URL | Key Parameters |\n|----------|-----|----------------|\n| BTC ETF net inflow | `GET /v1/data/btc_etf` | none |\n| Daily on-chain volume | `GET /v1/data/daily_tx` | none |\n| IBIT/FBTC net inflow | `GET /v1/data/ibit_fbtc` | none |\n| Stablecoin market cap | `GET /v1/data/stablecoin_marketcap` | none |\n| Compliant exchange assets | `GET /v1/data/compliant_total` | none |\n| US Treasury yield | `GET /v1/data/us10y` | `type=1D/1W/1M` |\n| Dollar Index (DXY) | `GET /v1/data/dxy` | `type=1D/1W/1M` |\n| Global M2 supply | `GET /v1/data/m2_supply` | `type=3M/6M/1Y/3Y` |\n| Bitfinex long positions | `GET /v1/data/bitfinex_long` | `symbol=btc` `type=1D/1W/1M/h24` |\n| Derivatives platform data | `GET /v1/data/contract` | `dataType=1D/1W/1M/3M/6M/12M` |\n| Buy/sell indicator | `GET /v1/data/bottom_top_indicator` | none |\n| Top 10 on-chain net inflow | `GET /v1/data/top10_netflow` | `network=solana/base/ethereum` |\n| Exchange snapshot | `GET /v1/data/exchanges` | `name` `page` `size` |\n\n---\n\n## Time Dimension Mapping\n\n| User says | Parameter |\n|-----------|-----------|\n| today / latest / real-time | `type=1D` or `size=5` |\n| this week / recent | `type=1W` |\n| this month / last 30 days | `type=1M` |\n| this year / long-term trend | `type=1Y` or `type=3Y` |\n| last 24 hours (bitfinex_long only) | `type=h24` |\n\n---\n\n## Intent Mapping\n\n| User intent | Scenario / endpoint |\n|-------------|---------------------|\n| How's the market today / daily overview | Scenario 1: Market Overview |\n| Capital flow / on-chain trends / smart money | Scenario 2: Capital Flow |\n| Macro / M2 / US Treasuries / good time to enter | Scenario 3: Macro Assessment |\n| Futures / open interest / exchange OI / leverage risk | Scenario 4: Derivatives |\n| search [keyword] | Scenario 5: Search |\n| Latest news / newsflash list | `GET /v1/newsflash` |\n| Last 24 hours / today all newsflashes | `GET /v1/newsflash/24h` |\n| Important newsflashes | `GET /v1/newsflash/important` |\n| Original newsflashes | `GET /v1/newsflash/original` |\n| First-report newsflashes | `GET /v1/newsflash/first` |\n| On-chain newsflashes | `GET /v1/newsflash/onchain` |\n| Financing news | `GET /v1/newsflash/financing` |\n| Prediction market / Polymarket | `GET /v1/newsflash/prediction` |\n| AI newsflashes / AI news | `GET /v1/newsflash/ai` |\n| Article list | `GET /v1/article` |\n| Last 24 hours articles / today's articles | `GET /v1/article/24h` |\n| Important articles | `GET /v1/article/important` |\n| Original articles | `GET /v1/article/original` |\n| BTC ETF inflow | `GET /v1/data/btc_etf` |\n| IBIT FBTC | `GET /v1/data/ibit_fbtc` |\n| Stablecoin market cap / USDT USDC | `GET /v1/data/stablecoin_marketcap` |\n| Dollar index / DXY | `GET /v1/data/dxy` |\n| Bitfinex longs / leveraged positions | `GET /v1/data/bitfinex_long` |\n| Buy/sell signal / market sentiment | `GET /v1/data/bottom_top_indicator` |\n| Top inflow tokens / on-chain trending | `GET /v1/data/top10_netflow` |\n| Exchange rankings | `GET /v1/data/exchanges` |\n| On-chain volume / activity | `GET /v1/data/daily_tx` |\n| Compliant exchange assets / institutional custody | `GET /v1/data/compliant_total` |\n\n---\n\n## Data Refresh Frequency\n\n| Endpoint type | Update frequency |\n|---------------|-----------------|\n| Newsflash / articles / search | Real-time |\n| top10_netflow | Near real-time |\n| btc_etf / ibit_fbtc / daily_tx | Daily (T+1) |\n| stablecoin_marketcap / compliant_total | Daily |\n| bottom_top_indicator | Daily |\n| us10y / dxy | Intraday minute-level |\n| m2_supply | Monthly |\n| exchanges / contract | Daily |\n| bitfinex_long | Daily (h24 param is near real-time) |\n\n---\n\n## Error Handling\n\n| Error condition | Response |\n|----------------|----------|\n| `BLOCKBEATS_API_KEY` not set | Prompt: Please set the BLOCKBEATS_API_KEY environment variable. Apply at: https://www.theblockbeats.info/ |\n| status 100 | Missing API key — please provide your api-key header |\n| status 101 | Invalid API key — please verify your key |\n| status 102 | API key expired — please renew your subscription |\n| status 103 | Invalid request method — check that you are using GET |\n| status -1 | General failure — display the `message` field content |\n| Request timeout | Prompt to retry; do not interrupt other parallel requests |\n| data is empty array | Explain possible reasons (non-trading day, data delay, no data for this token) |\n\n## Notes\n\n- `content` field is HTML; strip tags and display plain text only\n- `create_time` field format: `Y-m-d H:i:s`\n- Numeric fields (price/vol etc.) are strings; format as numbers when displaying\n- When running parallel requests, a failure on one endpoint must not block display of others\n\nFile v1.0.2:README.md\n\n# blockbeats-skill\n\nBlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also features robust keyword-based search functionality.\n\n## Installation\n\n```bash\nnpx clawhub@latest install blockbeats-skill\n```\n\nAn [OpenClaw](https://openclaw.dev) skill for querying crypto news, newsflashes, articles, and on-chain market data via the [BlockBeats Pro API](https://www.theblockbeats.info/).\n\n## What Can It Do\n\n### 📊 Market Overview\nAsk: *\"How's the market today?\"* / *\"Give me a daily summary\"*\n\nFetches in parallel:\n- **Sentiment index** — buy/sell zone indicator (< 20 potential buy, > 80 potential sell)\n- **BTC ETF net inflow** — daily & cumulative institutional flow\n- **On-chain transaction volume** — day-over-day change\n- **Top important newsflashes** — latest 5 key headlines\n\n### 💰 Capital Flow Analysis\nAsk: *\"Where is capital flowing?\"* / *\"Which tokens are being bought on-chain?\"*\n\n- **Top 10 on-chain net inflow tokens** — supports Solana / Base / Ethereum\n- **Stablecoin market cap** — USDT & USDC expansion/contraction signal\n- **BTC ETF institutional flow** — daily inflow/outflow\n\n### 🌐 Macro Environment Assessment\nAsk: *\"Is it a good time to enter?\"* / *\"What's the macro situation?\"*\n\n- **Global M2 supply** — YoY trend (expansionary vs contractionary)\n- **US 10Y Treasury yield** — risk-free rate pressure on crypto\n- **DXY Dollar Index** — dollar strength impact on risk assets\n- **Compliant exchange total assets** — institutional allocation appetite\n\n### ⚡ Derivatives Market Analysis\nAsk: *\"What's the futures market doing?\"* / *\"Show me open interest\"*\n\n- **Platform OI comparison** — Binance, Bybit, Hyperliquid side by side\n- **Exchange rankings** — by volume and open interest (top 10)\n- **Bitfinex BTC long positions** — large player leveraged sentiment signal\n\n### 🔍 Keyword Search\nAsk: *\"Search Solana\"* / *\"Find news about BlackRock\"*\n\nFull-text search across all newsflashes and articles. Returns title, abstract, type (article vs newsflash), relative time, and source URL.\n\n### 📰 Newsflash & Article Lists\nAsk for any category:\n\n| Category | Trigger |\n|----------|---------|\n| All newsflashes | latest news, what's new |\n| Last 24h newsflashes | past 24 hours, today's all news |\n| Important | major events, key headlines |\n| Original | exclusive coverage |\n| First-report | scoop, first to report |\n| On-chain | on-chain data updates |\n| Financing | VC deals, fundraising rounds |\n| Prediction market | Polymarket, forecast, betting |\n| AI | AI projects, artificial intelligence news |\n| Articles | in-depth analysis, research |\n| Last 24h articles | today's articles (up to 50) |\n| Important articles | key reports |\n| Original articles | original analysis |\n\n## Data Coverage\n\n| Data | Update Frequency |\n|------|-----------------|\n| Newsflashes & articles | Real-time |\n| Top 10 on-chain net inflow | Near real-time |\n| BTC ETF / daily on-chain volume | Daily (T+1) |\n| Stablecoin market cap | Daily |\n| Sentiment index | Daily |\n| US Treasury yield / DXY | Intraday (minute-level) |\n| Global M2 supply | Monthly |\n| Exchange & derivatives OI | Daily |\n| Bitfinex long positions | Daily (24h param = near real-time) |\n\n## Requirements\n\n- `curl` available in your shell\n- A BlockBeats Pro API key — apply at [theblockbeats.info](https://www.theblockbeats.info/)\n- Set environment variable: `BLOCKBEATS_API_KEY=your_key`\n\n## Supported Platforms\n\nmacOS · Linux · Windows\n\n## License\n\nMIT\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7dybqnmkdzwstxgz8z1nha0s82dwja\",\n  \"slug\": \"blockbeats-skill\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1774178132548\n}\n\nArchive v1.0.1: 3 files, 6999 bytes\n\nFiles: README.md (3565b), SKILL.md (15034b), _meta.json (135b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: blockbeats-skill\ndescription: BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also features robust keyword-based search functionality.\nmetadata:\n  openclaw:\n    emoji: \"📰\"\n    requires:\n      bins:\n        - curl\n      env:\n        - BLOCKBEATS_API_KEY\n    os:\n      - darwin\n      - linux\n      - win32\n    tags:\n      - crypto\n      - news\n      - market-data\n      - on-chain\n      - defi\n  version: 1.0.0\n---\n\n# BlockBeats API Skill\n\nQuery crypto newsflashes, articles, search results, and on-chain market data via the BlockBeats Pro API.\n\n**Base URL**: `https://api-pro.theblockbeats.info`\n**Auth**: All requests require Header `api-key: $BLOCKBEATS_API_KEY`\n**Response format**: `{\"status\": 0, \"message\": \"\", \"data\": {...}}` — status 0 = success\n\n---\n\n## Scenario 1: Market Overview\n\n**Triggers**: How's the market today, market overview, daily summary, market conditions\n\nExecute the following four requests in parallel:\n\n```bash\n# 1. Market sentiment index\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/bottom_top_indicator\"\n\n# 2. Important newsflashes (latest 5)\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/newsflash/important\" \\\n  -G --data-urlencode \"size=5\" --data-urlencode \"lang=en\"\n\n# 3. BTC ETF net inflow\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/btc_etf\"\n\n# 4. Daily on-chain transaction volume\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/daily_tx\"\n```\n\n**Output format**:\n```\n📊 Market Overview · [Today's date]\n\nSentiment Index: [value] → [<20 potential buy zone / 20-80 neutral / >80 potential sell zone]\nBTC ETF: Today net inflow [value] million USD, cumulative [value] million\nOn-chain Volume: Today [value] (vs yesterday [↑/↓][change%])\nKey News:\n  · [Title 1] [time]\n  · [Title 2] [time]\n  · [Title 3] [time]\n```\n\n**Interpretation rules**:\n- Sentiment < 20 → Alert user to potential opportunities\n- Sentiment > 80 → Warn about sell-off risk\n- ETF positive inflow 3 days in a row → Institutional accumulation signal\n- ETF net inflow > 500M/day → Strong buy signal\n- Rising on-chain volume → Increasing on-chain activity and market heat\n\n---\n\n## Scenario 2: Capital Flow Analysis\n\n**Triggers**: Where is capital flowing, on-chain trends, which tokens are being bought, stablecoins, smart money\n\nExecute in parallel:\n\n```bash\n# 1. Top 10 tokens by on-chain net inflow (default solana; replace network param for Base/ETH)\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/top10_netflow\" \\\n  -G --data-urlencode \"network=solana\"\n\n# 2. Stablecoin market cap\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/stablecoin_marketcap\"\n\n# 3. BTC ETF net inflow\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/btc_etf\"\n```\n\nSelect `network` parameter based on user intent: `solana` (default) / `base` / `ethereum`\n\n**Output format**:\n```\n💰 Capital Flow Analysis\n\nOn-chain Trending ([chain]):\n  1. [token] Net inflow $[value]  Market cap $[value]\n  2. ...\n\nStablecoins: USDT [↑/↓] USDC [↑/↓] (expansion/contraction signal)\nInstitutional: ETF today [inflow/outflow] [value] million USD\n```\n\n**Interpretation rules**:\n- Stablecoin market cap expanding → More capital in market, stronger buy potential\n- Stablecoin market cap shrinking → Capital exiting, caution advised\n\n---\n\n## Scenario 3: Macro Environment Assessment\n\n**Triggers**: Macro environment, is it a good time to enter, liquidity, US Treasuries, dollar, M2, big picture\n\nExecute in parallel:\n\n```bash\n# 1. Global M2 supply\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/m2_supply\" \\\n  -G --data-urlencode \"type=1Y\"\n\n# 2. US 10Y Treasury yield\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/us10y\" \\\n  -G --data-urlencode \"type=1M\"\n\n# 3. DXY Dollar Index\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/dxy\" \\\n  -G --data-urlencode \"type=1M\"\n\n# 4. Compliant exchange total assets\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/compliant_total\"\n```\n\n**Output format**:\n```\n🌐 Macro Environment Assessment\n\nGlobal M2: [latest value] YoY [↑/↓][change%] → [expansionary/contractionary]\nUS Treasury Yield (10Y): [latest value]% → [rising/falling trend]\nDollar Index (DXY): [latest value] → [strong/weak]\nCompliant Exchange Assets: $[value] → [inflow/outflow trend]\n\nOverall: [bullish/neutral/bearish] for crypto market\n```\n\n**Interpretation rules**:\n- M2 YoY > 5% → Loose liquidity, favorable for risk assets\n- M2 YoY < 0% → Liquidity tightening, caution\n- DXY rising → Strong dollar, crypto under pressure\n- DXY falling → Weak dollar, crypto benefits\n- Rising Treasury yield → Higher risk-free rate, capital returning to bonds\n- Rising compliant exchange assets → Growing institutional allocation appetite\n\n---\n\n## Scenario 4: Derivatives Market Analysis\n\n**Triggers**: Futures market, long/short positioning, open interest, Binance Bybit OI, leverage risk\n\nExecute in parallel:\n\n```bash\n# 1. Major derivatives platform comparison\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/contract\" \\\n  -G --data-urlencode \"dataType=1D\"\n\n# 2. Exchange snapshot\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/exchanges\" \\\n  -G --data-urlencode \"size=10\"\n\n# 3. Bitfinex BTC long positions\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/bitfinex_long\" \\\n  -G --data-urlencode \"symbol=btc\" --data-urlencode \"type=1D\"\n```\n\n**Output format**:\n```\n⚡ Derivatives Market Analysis\n\nPlatform OI:\n  Binance [value]  Bybit [value]  Hyperliquid [value]\n\nExchange Rankings (by volume):\n  1. [name] Volume $[value]  OI $[value]\n  2. ...\n\nBitfinex BTC Longs: [value] → [increasing/decreasing] (leveraged long sentiment [strong/weak])\n```\n\n**Interpretation rules**:\n- Bitfinex longs persistently increasing → Large players bullish, market confidence growing\n- Bitfinex longs dropping sharply → Watch for long liquidation cascade\n\n---\n\n## Scenario 5: Keyword Search\n\n**Triggers**: search [keyword], find [keyword], [keyword] news, what's happening with [keyword]\n\n```bash\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/search\" \\\n  -G --data-urlencode \"name=[keyword]\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\n```\n\nResponse fields: `title`, `abstract`, `content` (plain text), `type` (0=article, 1=newsflash), `time_cn` (relative time), `img_url`, `url`; pagination object: `total`, `page`, `size`, `total_pages`; `size` max 100\n\n---\n\n## Scenario 6: Newsflash & Article Lists\n\nSelect the appropriate newsflash category or article endpoint based on user intent. Default returns 10 items; use `size` param to adjust.\n\n**Newsflash category triggers and endpoints**:\n\n| User says | Endpoint path |\n|-----------|--------------|\n| latest news / newsflash list / what's new | `/v1/newsflash` |\n| last 24 hours / past 24h / today's all news | `/v1/newsflash/24h` |\n| important news / major events / key headlines | `/v1/newsflash/important` |\n| original newsflash / original coverage | `/v1/newsflash/original` |\n| first-report / exclusive / scoop | `/v1/newsflash/first` |\n| on-chain news / on-chain data / on-chain updates | `/v1/newsflash/onchain` |\n| financing news / fundraising / VC deals / investment rounds | `/v1/newsflash/financing` |\n| prediction market / Polymarket / forecast / betting | `/v1/newsflash/prediction` |\n| AI news / AI updates / AI projects / artificial intelligence | `/v1/newsflash/ai` |\n\n**Article category triggers and endpoints**:\n\n| User says | Endpoint path |\n|-----------|--------------|\n| article list / in-depth articles / latest articles | `/v1/article` |\n| last 24 hours articles / today's articles (up to 50, no pagination) | `/v1/article/24h` |\n| important articles / key reports | `/v1/article/important` |\n| original articles / original analysis | `/v1/article/original` |\n\n**Request example** (AI newsflash):\n\n```bash\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/newsflash/ai\" \\\n  -G --data-urlencode \"page=1\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\n```\n\n**Output format**:\n\n```\n📰 [Category Name] · Latest [N] items\n\n1. [Title] [time_cn]\n   [abstract, if available]\n\n2. [Title] [time_cn]\n   [abstract, if available]\n...\n```\n\n**Notes**:\n- `content` field is HTML; strip tags and display plain text only\n- Article endpoints do NOT have a `url` field; use `link` for the article page URL\n\n---\n\n## Single Endpoint Reference\n\n### Newsflash Endpoints (all support page/size/lang)\n\n| Endpoint | URL |\n|----------|-----|\n| All newsflashes | `GET /v1/newsflash` |\n| Last 24 hours (no pagination) | `GET /v1/newsflash/24h` |\n| Important | `GET /v1/newsflash/important` |\n| Original | `GET /v1/newsflash/original` |\n| First-report | `GET /v1/newsflash/first` |\n| On-chain | `GET /v1/newsflash/onchain` |\n| Financing | `GET /v1/newsflash/financing` |\n| Prediction market | `GET /v1/newsflash/prediction` |\n| AI | `GET /v1/newsflash/ai` |\n\n```bash\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/newsflash/[type]\" \\\n  -G --data-urlencode \"page=1\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\n```\n\n### Article Endpoints\n\n| Endpoint | URL | Params |\n|----------|-----|--------|\n| All articles | `GET /v1/article` | page/size/lang |\n| Last 24 hours (no pagination, up to 50) | `GET /v1/article/24h` | lang only |\n| Important | `GET /v1/article/important` | page/size/lang |\n| Original | `GET /v1/article/original` | page/size/lang |\n\n### RSS Endpoints\n\n| Endpoint | URL | Key Parameters |\n|----------|-----|----------------|\n| Newsflash RSS | `GET /v1/rss/newsflash` | `page` `size` (1-50) |\n| Article RSS | `GET /v1/rss/article` | `page` `size` (1-50) |\n\nRSS endpoints return XML format. Use when user requests RSS feed or wants to subscribe to updates.\n\n### Data Endpoints\n\n| Endpoint | URL | Key Parameters |\n|----------|-----|----------------|\n| BTC ETF net inflow | `GET /v1/data/btc_etf` | none |\n| Daily on-chain volume | `GET /v1/data/daily_tx` | none |\n| IBIT/FBTC net inflow | `GET /v1/data/ibit_fbtc` | none |\n| Stablecoin market cap | `GET /v1/data/stablecoin_marketcap` | none |\n| Compliant exchange assets | `GET /v1/data/compliant_total` | none |\n| US Treasury yield | `GET /v1/data/us10y` | `type=1D/1W/1M` |\n| Dollar Index (DXY) | `GET /v1/data/dxy` | `type=1D/1W/1M` |\n| Global M2 supply | `GET /v1/data/m2_supply` | `type=3M/6M/1Y/3Y` |\n| Bitfinex long positions | `GET /v1/data/bitfinex_long` | `symbol=btc` `type=1D/1W/1M/h24` |\n| Derivatives platform data | `GET /v1/data/contract` | `dataType=1D/1W/1M/3M/6M/12M` |\n| Buy/sell indicator | `GET /v1/data/bottom_top_indicator` | none |\n| Top 10 on-chain net inflow | `GET /v1/data/top10_netflow` | `network=solana/base/ethereum` |\n| Exchange snapshot | `GET /v1/data/exchanges` | `name` `page` `size` |\n\n---\n\n## Time Dimension Mapping\n\n| User says | Parameter |\n|-----------|-----------|\n| today / latest / real-time | `type=1D` or `size=5` |\n| this week / recent | `type=1W` |\n| this month / last 30 days | `type=1M` |\n| this year / long-term trend | `type=1Y` or `type=3Y` |\n| last 24 hours (bitfinex_long only) | `type=h24` |\n\n---\n\n## Intent Mapping\n\n| User intent | Scenario / endpoint |\n|-------------|---------------------|\n| How's the market today / daily overview | Scenario 1: Market Overview |\n| Capital flow / on-chain trends / smart money | Scenario 2: Capital Flow |\n| Macro / M2 / US Treasuries / good time to enter | Scenario 3: Macro Assessment |\n| Futures / open interest / exchange OI / leverage risk | Scenario 4: Derivatives |\n| search [keyword] | Scenario 5: Search |\n| Latest news / newsflash list | `GET /v1/newsflash` |\n| Last 24 hours / today all newsflashes | `GET /v1/newsflash/24h` |\n| Important newsflashes | `GET /v1/newsflash/important` |\n| Original newsflashes | `GET /v1/newsflash/original` |\n| First-report newsflashes | `GET /v1/newsflash/first` |\n| On-chain newsflashes | `GET /v1/newsflash/onchain` |\n| Financing news | `GET /v1/newsflash/financing` |\n| Prediction market / Polymarket | `GET /v1/newsflash/prediction` |\n| AI newsflashes / AI news | `GET /v1/newsflash/ai` |\n| Article list | `GET /v1/article` |\n| Last 24 hours articles / today's articles | `GET /v1/article/24h` |\n| Important articles | `GET /v1/article/important` |\n| Original articles | `GET /v1/article/original` |\n| BTC ETF inflow | `GET /v1/data/btc_etf` |\n| IBIT FBTC | `GET /v1/data/ibit_fbtc` |\n| Stablecoin market cap / USDT USDC | `GET /v1/data/stablecoin_marketcap` |\n| Dollar index / DXY | `GET /v1/data/dxy` |\n| Bitfinex longs / leveraged positions | `GET /v1/data/bitfinex_long` |\n| Buy/sell signal / market sentiment | `GET /v1/data/bottom_top_indicator` |\n| Top inflow tokens / on-chain trending | `GET /v1/data/top10_netflow` |\n| Exchange rankings | `GET /v1/data/exchanges` |\n| On-chain volume / activity | `GET /v1/data/daily_tx` |\n| Compliant exchange assets / institutional custody | `GET /v1/data/compliant_total` |\n\n---\n\n## Data Refresh Frequency\n\n| Endpoint type | Update frequency |\n|---------------|-----------------|\n| Newsflash / articles / search | Real-time |\n| top10_netflow | Near real-time |\n| btc_etf / ibit_fbtc / daily_tx | Daily (T+1) |\n| stablecoin_marketcap / compliant_total | Daily |\n| bottom_top_indicator | Daily |\n| us10y / dxy | Intraday minute-level |\n| m2_supply | Monthly |\n| exchanges / contract | Daily |\n| bitfinex_long | Daily (h24 param is near real-time) |\n\n---\n\n## Error Handling\n\n| Error condition | Response |\n|----------------|----------|\n| `BLOCKBEATS_API_KEY` not set | Prompt: Please set the BLOCKBEATS_API_KEY environment variable. Apply at: https://www.theblockbeats.info/ |\n| status 100 | Missing API key — please provide your api-key header |\n| status 101 | Invalid API key — please verify your key |\n| status 102 | API key expired — please renew your subscription |\n| status 103 | Invalid request method — check that you are using GET |\n| status -1 | General failure — display the `message` field content |\n| Request timeout | Prompt to retry; do not interrupt other parallel requests |\n| data is empty array | Explain possible reasons (non-trading day, data delay, no data for this token) |\n\n## Notes\n\n- `content` field is HTML; strip tags and display plain text only\n- `create_time` field format: `Y-m-d H:i:s`\n- Numeric fields (price/vol etc.) are strings; format as numbers when displaying\n- When running parallel requests, a failure on one endpoint must not block display of others\n\nFile v1.0.1:README.md\n\n# blockbeats-skill\n\nBlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also features robust keyword-based search functionality.\n\n## Installation\n\n```bash\nnpx clawhub@latest install blockbeats-skill\n```\n\nAn [OpenClaw](https://openclaw.dev) skill for querying crypto news, newsflashes, articles, and on-chain market data via the [BlockBeats Pro API](https://www.theblockbeats.info/).\n\n## What Can It Do\n\n### 📊 Market Overview\nAsk: *\"How's the market today?\"* / *\"Give me a daily summary\"*\n\nFetches in parallel:\n- **Sentiment index** — buy/sell zone indicator (< 20 potential buy, > 80 potential sell)\n- **BTC ETF net inflow** — daily & cumulative institutional flow\n- **On-chain transaction volume** — day-over-day change\n- **Top important newsflashes** — latest 5 key headlines\n\n### 💰 Capital Flow Analysis\nAsk: *\"Where is capital flowing?\"* / *\"Which tokens are being bought on-chain?\"*\n\n- **Top 10 on-chain net inflow tokens** — supports Solana / Base / Ethereum\n- **Stablecoin market cap** — USDT & USDC expansion/contraction signal\n- **BTC ETF institutional flow** — daily inflow/outflow\n\n### 🌐 Macro Environment Assessment\nAsk: *\"Is it a good time to enter?\"* / *\"What's the macro situation?\"*\n\n- **Global M2 supply** — YoY trend (expansionary vs contractionary)\n- **US 10Y Treasury yield** — risk-free rate pressure on crypto\n- **DXY Dollar Index** — dollar strength impact on risk assets\n- **Compliant exchange total assets** — institutional allocation appetite\n\n### ⚡ Derivatives Market Analysis\nAsk: *\"What's the futures market doing?\"* / *\"Show me open interest\"*\n\n- **Platform OI comparison** — Binance, Bybit, Hyperliquid side by side\n- **Exchange rankings** — by volume and open interest (top 10)\n- **Bitfinex BTC long positions** — large player leveraged sentiment signal\n\n### 🔍 Keyword Search\nAsk: *\"Search Solana\"* / *\"Find news about BlackRock\"*\n\nFull-text search across all newsflashes and articles. Returns title, abstract, type (article vs newsflash), relative time, and source URL.\n\n### 📰 Newsflash & Article Lists\nAsk for any category:\n\n| Category | Trigger |\n|----------|---------|\n| All newsflashes | latest news, what's new |\n| Last 24h newsflashes | past 24 hours, today's all news |\n| Important | major events, key headlines |\n| Original | exclusive coverage |\n| First-report | scoop, first to report |\n| On-chain | on-chain data updates |\n| Financing | VC deals, fundraising rounds |\n| Prediction market | Polymarket, forecast, betting |\n| AI | AI projects, artificial intelligence news |\n| Articles | in-depth analysis, research |\n| Last 24h articles | today's articles (up to 50) |\n| Important articles | key reports |\n| Original articles | original analysis |\n\n## Data Coverage\n\n| Data | Update Frequency |\n|------|-----------------|\n| Newsflashes & articles | Real-time |\n| Top 10 on-chain net inflow | Near real-time |\n| BTC ETF / daily on-chain volume | Daily (T+1) |\n| Stablecoin market cap | Daily |\n| Sentiment index | Daily |\n| US Treasury yield / DXY | Intraday (minute-level) |\n| Global M2 supply | Monthly |\n| Exchange & derivatives OI | Daily |\n| Bitfinex long positions | Daily (24h param = near real-time) |\n\n## Requirements\n\n- `curl` available in your shell\n- A BlockBeats Pro API key — apply at [theblockbeats.info](https://www.theblockbeats.info/)\n- Set environment variable: `BLOCKBEATS_API_KEY=your_key`\n\n## Supported Platforms\n\nmacOS · Linux · Windows\n\n## License\n\nMIT\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7dybqnmkdzwstxgz8z1nha0s82dwja\",\n  \"slug\": \"blockbeats-skill\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1774177873848\n}\n\nArchive v1.0.0: 3 files, 6958 bytes\n\nFiles: README.md (3565b), SKILL.md (14994b), _meta.json (135b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: blockbeats-skill\ndescription: BlockBeats API skill for querying crypto news, newsflashes, articles, search, and on-chain market data (ETF flows, stablecoin supply, derivatives OI, M2, DXY, Bitfinex long positions, and more). Requires BLOCKBEATS_API_KEY.\nmetadata:\n  openclaw:\n    emoji: \"📰\"\n    requires:\n      bins:\n        - curl\n    os:\n      - darwin\n      - linux\n      - win32\n    tags:\n      - crypto\n      - news\n      - market-data\n      - on-chain\n      - defi\n  version: 1.0.0\n---\n\n# BlockBeats API Skill\n\nQuery crypto newsflashes, articles, search results, and on-chain market data via the BlockBeats Pro API.\n\n**Base URL**: `http://api-pro.theblockbeats.info`\n**Auth**: All requests require Header `api-key: $BLOCKBEATS_API_KEY`\n**Response format**: `{\"status\": 0, \"message\": \"\", \"data\": {...}}` — status 0 = success\n\n---\n\n## Scenario 1: Market Overview\n\n**Triggers**: How's the market today, market overview, daily summary, market conditions\n\nExecute the following four requests in parallel:\n\n```bash\n# 1. Market sentiment index\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/bottom_top_indicator\"\n\n# 2. Important newsflashes (latest 5)\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/newsflash/important\" \\\n  -G --data-urlencode \"size=5\" --data-urlencode \"lang=en\"\n\n# 3. BTC ETF net inflow\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/btc_etf\"\n\n# 4. Daily on-chain transaction volume\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/daily_tx\"\n```\n\n**Output format**:\n```\n📊 Market Overview · [Today's date]\n\nSentiment Index: [value] → [<20 potential buy zone / 20-80 neutral / >80 potential sell zone]\nBTC ETF: Today net inflow [value] million USD, cumulative [value] million\nOn-chain Volume: Today [value] (vs yesterday [↑/↓][change%])\nKey News:\n  · [Title 1] [time]\n  · [Title 2] [time]\n  · [Title 3] [time]\n```\n\n**Interpretation rules**:\n- Sentiment < 20 → Alert user to potential opportunities\n- Sentiment > 80 → Warn about sell-off risk\n- ETF positive inflow 3 days in a row → Institutional accumulation signal\n- ETF net inflow > 500M/day → Strong buy signal\n- Rising on-chain volume → Increasing on-chain activity and market heat\n\n---\n\n## Scenario 2: Capital Flow Analysis\n\n**Triggers**: Where is capital flowing, on-chain trends, which tokens are being bought, stablecoins, smart money\n\nExecute in parallel:\n\n```bash\n# 1. Top 10 tokens by on-chain net inflow (default solana; replace network param for Base/ETH)\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/top10_netflow\" \\\n  -G --data-urlencode \"network=solana\"\n\n# 2. Stablecoin market cap\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/stablecoin_marketcap\"\n\n# 3. BTC ETF net inflow\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/btc_etf\"\n```\n\nSelect `network` parameter based on user intent: `solana` (default) / `base` / `ethereum`\n\n**Output format**:\n```\n💰 Capital Flow Analysis\n\nOn-chain Trending ([chain]):\n  1. [token] Net inflow $[value]  Market cap $[value]\n  2. ...\n\nStablecoins: USDT [↑/↓] USDC [↑/↓] (expansion/contraction signal)\nInstitutional: ETF today [inflow/outflow] [value] million USD\n```\n\n**Interpretation rules**:\n- Stablecoin market cap expanding → More capital in market, stronger buy potential\n- Stablecoin market cap shrinking → Capital exiting, caution advised\n\n---\n\n## Scenario 3: Macro Environment Assessment\n\n**Triggers**: Macro environment, is it a good time to enter, liquidity, US Treasuries, dollar, M2, big picture\n\nExecute in parallel:\n\n```bash\n# 1. Global M2 supply\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/m2_supply\" \\\n  -G --data-urlencode \"type=1Y\"\n\n# 2. US 10Y Treasury yield\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/us10y\" \\\n  -G --data-urlencode \"type=1M\"\n\n# 3. DXY Dollar Index\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/dxy\" \\\n  -G --data-urlencode \"type=1M\"\n\n# 4. Compliant exchange total assets\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/compliant_total\"\n```\n\n**Output format**:\n```\n🌐 Macro Environment Assessment\n\nGlobal M2: [latest value] YoY [↑/↓][change%] → [expansionary/contractionary]\nUS Treasury Yield (10Y): [latest value]% → [rising/falling trend]\nDollar Index (DXY): [latest value] → [strong/weak]\nCompliant Exchange Assets: $[value] → [inflow/outflow trend]\n\nOverall: [bullish/neutral/bearish] for crypto market\n```\n\n**Interpretation rules**:\n- M2 YoY > 5% → Loose liquidity, favorable for risk assets\n- M2 YoY < 0% → Liquidity tightening, caution\n- DXY rising → Strong dollar, crypto under pressure\n- DXY falling → Weak dollar, crypto benefits\n- Rising Treasury yield → Higher risk-free rate, capital returning to bonds\n- Rising compliant exchange assets → Growing institutional allocation appetite\n\n---\n\n## Scenario 4: Derivatives Market Analysis\n\n**Triggers**: Futures market, long/short positioning, open interest, Binance Bybit OI, leverage risk\n\nExecute in parallel:\n\n```bash\n# 1. Major derivatives platform comparison\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/contract\" \\\n  -G --data-urlencode \"dataType=1D\"\n\n# 2. Exchange snapshot\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/exchanges\" \\\n  -G --data-urlencode \"size=10\"\n\n# 3. Bitfinex BTC long positions\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/data/bitfinex_long\" \\\n  -G --data-urlencode \"symbol=btc\" --data-urlencode \"type=1D\"\n```\n\n**Output format**:\n```\n⚡ Derivatives Market Analysis\n\nPlatform OI:\n  Binance [value]  Bybit [value]  Hyperliquid [value]\n\nExchange Rankings (by volume):\n  1. [name] Volume $[value]  OI $[value]\n  2. ...\n\nBitfinex BTC Longs: [value] → [increasing/decreasing] (leveraged long sentiment [strong/weak])\n```\n\n**Interpretation rules**:\n- Bitfinex longs persistently increasing → Large players bullish, market confidence growing\n- Bitfinex longs dropping sharply → Watch for long liquidation cascade\n\n---\n\n## Scenario 5: Keyword Search\n\n**Triggers**: search [keyword], find [keyword], [keyword] news, what's happening with [keyword]\n\n```bash\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/search\" \\\n  -G --data-urlencode \"name=[keyword]\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\n```\n\nResponse fields: `title`, `abstract`, `content` (plain text), `type` (0=article, 1=newsflash), `time_cn` (relative time), `img_url`, `url`; pagination object: `total`, `page`, `size`, `total_pages`; `size` max 100\n\n---\n\n## Scenario 6: Newsflash & Article Lists\n\nSelect the appropriate newsflash category or article endpoint based on user intent. Default returns 10 items; use `size` param to adjust.\n\n**Newsflash category triggers and endpoints**:\n\n| User says | Endpoint path |\n|-----------|--------------|\n| latest news / newsflash list / what's new | `/v1/newsflash` |\n| last 24 hours / past 24h / today's all news | `/v1/newsflash/24h` |\n| important news / major events / key headlines | `/v1/newsflash/important` |\n| original newsflash / original coverage | `/v1/newsflash/original` |\n| first-report / exclusive / scoop | `/v1/newsflash/first` |\n| on-chain news / on-chain data / on-chain updates | `/v1/newsflash/onchain` |\n| financing news / fundraising / VC deals / investment rounds | `/v1/newsflash/financing` |\n| prediction market / Polymarket / forecast / betting | `/v1/newsflash/prediction` |\n| AI news / AI updates / AI projects / artificial intelligence | `/v1/newsflash/ai` |\n\n**Article category triggers and endpoints**:\n\n| User says | Endpoint path |\n|-----------|--------------|\n| article list / in-depth articles / latest articles | `/v1/article` |\n| last 24 hours articles / today's articles (up to 50, no pagination) | `/v1/article/24h` |\n| important articles / key reports | `/v1/article/important` |\n| original articles / original analysis | `/v1/article/original` |\n\n**Request example** (AI newsflash):\n\n```bash\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/newsflash/ai\" \\\n  -G --data-urlencode \"page=1\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\n```\n\n**Output format**:\n\n```\n📰 [Category Name] · Latest [N] items\n\n1. [Title] [time_cn]\n   [abstract, if available]\n\n2. [Title] [time_cn]\n   [abstract, if available]\n...\n```\n\n**Notes**:\n- `content` field is HTML; strip tags and display plain text only\n- Article endpoints do NOT have a `url` field; use `link` for the article page URL\n\n---\n\n## Single Endpoint Reference\n\n### Newsflash Endpoints (all support page/size/lang)\n\n| Endpoint | URL |\n|----------|-----|\n| All newsflashes | `GET /v1/newsflash` |\n| Last 24 hours (no pagination) | `GET /v1/newsflash/24h` |\n| Important | `GET /v1/newsflash/important` |\n| Original | `GET /v1/newsflash/original` |\n| First-report | `GET /v1/newsflash/first` |\n| On-chain | `GET /v1/newsflash/onchain` |\n| Financing | `GET /v1/newsflash/financing` |\n| Prediction market | `GET /v1/newsflash/prediction` |\n| AI | `GET /v1/newsflash/ai` |\n\n```bash\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"http://api-pro.theblockbeats.info/v1/newsflash/[type]\" \\\n  -G --data-urlencode \"page=1\" --data-urlencode \"size=10\" --data-urlencode \"lang=en\"\n```\n\n### Article Endpoints\n\n| Endpoint | URL | Params |\n|----------|-----|--------|\n| All articles | `GET /v1/article` | page/size/lang |\n| Last 24 hours (no pagination, up to 50) | `GET /v1/article/24h` | lang only |\n| Important | `GET /v1/article/important` | page/size/lang |\n| Original | `GET /v1/article/original` | page/size/lang |\n\n### RSS Endpoints\n\n| Endpoint | URL | Key Parameters |\n|----------|-----|----------------|\n| Newsflash RSS | `GET /v1/rss/newsflash` | `page` `size` (1-50) |\n| Article RSS | `GET /v1/rss/article` | `page` `size` (1-50) |\n\nRSS endpoints return XML format. Use when user requests RSS feed or wants to subscribe to updates.\n\n### Data Endpoints\n\n| Endpoint | URL | Key Parameters |\n|----------|-----|----------------|\n| BTC ETF net inflow | `GET /v1/data/btc_etf` | none |\n| Daily on-chain volume | `GET /v1/data/daily_tx` | none |\n| IBIT/FBTC net inflow | `GET /v1/data/ibit_fbtc` | none |\n| Stablecoin market cap | `GET /v1/data/stablecoin_marketcap` | none |\n| Compliant exchange assets | `GET /v1/data/compliant_total` | none |\n| US Treasury yield | `GET /v1/data/us10y` | `type=1D/1W/1M` |\n| Dollar Index (DXY) | `GET /v1/data/dxy` | `type=1D/1W/1M` |\n| Global M2 supply | `GET /v1/data/m2_supply` | `type=3M/6M/1Y/3Y` |\n| Bitfinex long positions | `GET /v1/data/bitfinex_long` | `symbol=btc` `type=1D/1W/1M/h24` |\n| Derivatives platform data | `GET /v1/data/contract` | `dataType=1D/1W/1M/3M/6M/12M` |\n| Buy/sell indicator | `GET /v1/data/bottom_top_indicator` | none |\n| Top 10 on-chain net inflow | `GET /v1/data/top10_netflow` | `network=solana/base/ethereum` |\n| Exchange snapshot | `GET /v1/data/exchanges` | `name` `page` `size` |\n\n---\n\n## Time Dimension Mapping\n\n| User says | Parameter |\n|-----------|-----------|\n| today / latest / real-time | `type=1D` or `size=5` |\n| this week / recent | `type=1W` |\n| this month / last 30 days | `type=1M` |\n| this year / long-term trend | `type=1Y` or `type=3Y` |\n| last 24 hours (bitfinex_long only) | `type=h24` |\n\n---\n\n## Intent Mapping\n\n| User intent | Scenario / endpoint |\n|-------------|---------------------|\n| How's the market today / daily overview | Scenario 1: Market Overview |\n| Capital flow / on-chain trends / smart money | Scenario 2: Capital Flow |\n| Macro / M2 / US Treasuries / good time to enter | Scenario 3: Macro Assessment |\n| Futures / open interest / exchange OI / leverage risk | Scenario 4: Derivatives |\n| search [keyword] | Scenario 5: Search |\n| Latest news / newsflash list | `GET /v1/newsflash` |\n| Last 24 hours / today all newsflashes | `GET /v1/newsflash/24h` |\n| Important newsflashes | `GET /v1/newsflash/important` |\n| Original newsflashes | `GET /v1/newsflash/original` |\n| First-report newsflashes | `GET /v1/newsflash/first` |\n| On-chain newsflashes | `GET /v1/newsflash/onchain` |\n| Financing news | `GET /v1/newsflash/financing` |\n| Prediction market / Polymarket | `GET /v1/newsflash/prediction` |\n| AI newsflashes / AI news | `GET /v1/newsflash/ai` |\n| Article list | `GET /v1/article` |\n| Last 24 hours articles / today's articles | `GET /v1/article/24h` |\n| Important articles | `GET /v1/article/important` |\n| Original articles | `GET /v1/article/original` |\n| BTC ETF inflow | `GET /v1/data/btc_etf` |\n| IBIT FBTC | `GET /v1/data/ibit_fbtc` |\n| Stablecoin market cap / USDT USDC | `GET /v1/data/stablecoin_marketcap` |\n| Dollar index / DXY | `GET /v1/data/dxy` |\n| Bitfinex longs / leveraged positions | `GET /v1/data/bitfinex_long` |\n| Buy/sell signal / market sentiment | `GET /v1/data/bottom_top_indicator` |\n| Top inflow tokens / on-chain trending | `GET /v1/data/top10_netflow` |\n| Exchange rankings | `GET /v1/data/exchanges` |\n| On-chain volume / activity | `GET /v1/data/daily_tx` |\n| Compliant exchange assets / institutional custody | `GET /v1/data/compliant_total` |\n\n---\n\n## Data Refresh Frequency\n\n| Endpoint type | Update frequency |\n|---------------|-----------------|\n| Newsflash / articles / search | Real-time |\n| top10_netflow | Near real-time |\n| btc_etf / ibit_fbtc / daily_tx | Daily (T+1) |\n| stablecoin_marketcap / compliant_total | Daily |\n| bottom_top_indicator | Daily |\n| us10y / dxy | Intraday minute-level |\n| m2_supply | Monthly |\n| exchanges / contract | Daily |\n| bitfinex_long | Daily (h24 param is near real-time) |\n\n---\n\n## Error Handling\n\n| Error condition | Response |\n|----------------|----------|\n| `BLOCKBEATS_API_KEY` not set | Prompt: Please set the BLOCKBEATS_API_KEY environment variable. Apply at: https://www.theblockbeats.info/ |\n| status 100 | Missing API key — please provide your api-key header |\n| status 101 | Invalid API key — please verify your key |\n| status 102 | API key expired — please renew your subscription |\n| status 103 | Invalid request method — check that you are using GET |\n| status -1 | General failure — display the `message` field content |\n| Request timeout | Prompt to retry; do not interrupt other parallel requests |\n| data is empty array | Explain possible reasons (non-trading day, data delay, no data for this token) |\n\n## Notes\n\n- `content` field is HTML; strip tags and display plain text only\n- `create_time` field format: `Y-m-d H:i:s`\n- Numeric fields (price/vol etc.) are strings; format as numbers when displaying\n- When running parallel requests, a failure on one endpoint must not block display of others\n\nFile v1.0.0:README.md\n\n# blockbeats-skill\n\nBlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also features robust keyword-based search functionality.\n\n## Installation\n\n```bash\nnpx clawhub@latest install blockbeats-skill\n```\n\nAn [OpenClaw](https://openclaw.dev) skill for querying crypto news, newsflashes, articles, and on-chain market data via the [BlockBeats Pro API](https://www.theblockbeats.info/).\n\n## What Can It Do\n\n### 📊 Market Overview\nAsk: *\"How's the market today?\"* / *\"Give me a daily summary\"*\n\nFetches in parallel:\n- **Sentiment index** — buy/sell zone indicator (< 20 potential buy, > 80 potential sell)\n- **BTC ETF net inflow** — daily & cumulative institutional flow\n- **On-chain transaction volume** — day-over-day change\n- **Top important newsflashes** — latest 5 key headlines\n\n### 💰 Capital Flow Analysis\nAsk: *\"Where is capital flowing?\"* / *\"Which tokens are being bought on-chain?\"*\n\n- **Top 10 on-chain net inflow tokens** — supports Solana / Base / Ethereum\n- **Stablecoin market cap** — USDT & USDC expansion/contraction signal\n- **BTC ETF institutional flow** — daily inflow/outflow\n\n### 🌐 Macro Environment Assessment\nAsk: *\"Is it a good time to enter?\"* / *\"What's the macro situation?\"*\n\n- **Global M2 supply** — YoY trend (expansionary vs contractionary)\n- **US 10Y Treasury yield** — risk-free rate pressure on crypto\n- **DXY Dollar Index** — dollar strength impact on risk assets\n- **Compliant exchange total assets** — institutional allocation appetite\n\n### ⚡ Derivatives Market Analysis\nAsk: *\"What's the futures market doing?\"* / *\"Show me open interest\"*\n\n- **Platform OI comparison** — Binance, Bybit, Hyperliquid side by side\n- **Exchange rankings** — by volume and open interest (top 10)\n- **Bitfinex BTC long positions** — large player leveraged sentiment signal\n\n### 🔍 Keyword Search\nAsk: *\"Search Solana\"* / *\"Find news about BlackRock\"*\n\nFull-text search across all newsflashes and articles. Returns title, abstract, type (article vs newsflash), relative time, and source URL.\n\n### 📰 Newsflash & Article Lists\nAsk for any category:\n\n| Category | Trigger |\n|----------|---------|\n| All newsflashes | latest news, what's new |\n| Last 24h newsflashes | past 24 hours, today's all news |\n| Important | major events, key headlines |\n| Original | exclusive coverage |\n| First-report | scoop, first to report |\n| On-chain | on-chain data updates |\n| Financing | VC deals, fundraising rounds |\n| Prediction market | Polymarket, forecast, betting |\n| AI | AI projects, artificial intelligence news |\n| Articles | in-depth analysis, research |\n| Last 24h articles | today's articles (up to 50) |\n| Important articles | key reports |\n| Original articles | original analysis |\n\n## Data Coverage\n\n| Data | Update Frequency |\n|------|-----------------|\n| Newsflashes & articles | Real-time |\n| Top 10 on-chain net inflow | Near real-time |\n| BTC ETF / daily on-chain volume | Daily (T+1) |\n| Stablecoin market cap | Daily |\n| Sentiment index | Daily |\n| US Treasury yield / DXY | Intraday (minute-level) |\n| Global M2 supply | Monthly |\n| Exchange & derivatives OI | Daily |\n| Bitfinex long positions | Daily (24h param = near real-time) |\n\n## Requirements\n\n- `curl` available in your shell\n- A BlockBeats Pro API key — apply at [theblockbeats.info](https://www.theblockbeats.info/)\n- Set environment variable: `BLOCKBEATS_API_KEY=your_key`\n\n## Supported Platforms\n\nmacOS · Linux · Windows\n\n## License\n\nMIT\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7dybqnmkdzwstxgz8z1nha0s82dwja\",\n  \"slug\": \"blockbeats-skill\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1774177548833\n}","readmeExcerpt":"Skill: blockbeats--skill Owner: blockbeatsofficial Summary: BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also fea... Tags: latest:1.0.3 Version history: v1.0.3 | 2026-03-24T03:06:59.350Z | user blockbeats-skill 1.0.3 - Updated environment and installation metadata for improved clarity and support (added primaryEnv,","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"curl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\"},{"language":"bash","snippet":"curl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\"},{"language":"bash","snippet":"curl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\"},{"language":"bash","snippet":"curl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\"},{"language":"bash","snippet":"# 1. Market sentiment index\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/bottom_top_indicator\"\n\n# 2. Important newsflashes (latest 5)\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/newsflash/important\" \\\n  -G --data-urlencode \"size=5\" --data-urlencode \"lang=en\"\n\n# 3. BTC ETF net inflow\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/btc_etf\"\n\n# 4. Daily on-chain transaction volume\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\n  \"https://api-pro.theblockbeats.info/v1/data/daily_tx\""},{"language":"text","snippet":"📊 Market Overview · [Today's date]\n\nSentiment Index: [value] → [<20 potential buy zone / 20-80 neutral / >80 potential sell zone]\nBTC ETF: Today net inflow [value] million USD, cumulative [value] million\nOn-chain Volume: Today [value] (vs yesterday [↑/↓][change%])\nKey News:\n  · [Title 1] [time]\n  · [Title 2] [time]\n  · [Title 3] [time]"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: blockbeats-skill\r\ndescription: BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also features robust keyword-based search functionality.\r\nmetadata:\r\n  openclaw:\r\n    emoji: \"📰\"\r\n    primaryEnv: BLOCKBEATS_API_KEY\r\n    install:\r\n      - id: curl\r\n        kind: brew\r\n        formula: curl\r\n        label: curl (HTTP client)\r\n    requires:\r\n      bins:\r\n        - curl\r\n      env:\r\n        - BLOCKBEATS_API_KEY\r\n    os:\r\n      - darwin\r\n      - linux\r\n      - win32\r\n    tags:\r\n      - crypto\r\n      - news\r\n      - market-data\r\n      - on-chain\r\n      - defi\r\n  version: 1.0.3\r\n---\r\n\r\n# BlockBeats API Skill\r\n\r\nQuery crypto newsflashes, articles, search results, and on-chain market data via the BlockBeats Pro API.\r\n\r\n**Base URL**: `https://api-pro.theblockbeats.info`\r\n**Auth**: All requests require Header `api-key: $BLOCKBEATS_API_KEY`\r\n**Response format**: `{\"status\": 0, \"message\": \"\", \"data\": {...}}` — status 0 = success\r\n\r\n---\r\n\r\n## Scenario 1: Market Overview\r\n\r\n**Triggers**: How's the market today, market overview, daily summary, market conditions\r\n\r\nExecute the following four requests in parallel:\r\n\r\n```bash\r\n# 1. Market sentiment index\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/bottom_top_indicator\"\r\n\r\n# 2. Important newsflashes (latest 5)\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/newsflash/important\" \\\r\n  -G --data-urlencode \"size=5\" --data-urlencode \"lang=en\"\r\n\r\n# 3. BTC ETF net inflow\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/btc_etf\"\r\n\r\n# 4. Daily on-chain transaction volume\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/daily_tx\"\r\n```\r\n\r\n**Output format**:\r\n```\r\n📊 Market Overview · [Today's date]\r\n\r\nSentiment Index: [value] → [<20 potential buy zone / 20-80 neutral / >80 potential sell zone]\r\nBTC ETF: Today net inflow [value] million USD, cumulative [value] million\r\nOn-chain Volume: Today [value] (vs yesterday [↑/↓][change%])\r\nKey News:\r\n  · [Title 1] [time]\r\n  · [Title 2] [time]\r\n  · [Title 3] [time]\r\n```\r\n\r\n**Interpretation rules**:\r\n- Sentiment < 20 → Alert user to potential opportunities\r\n- Sentiment > 80 → Warn about sell-off risk\r\n- ETF positive inflow 3 days in a row → Institutional accumulation signal\r\n- ETF net inflow > 500M/day → Strong buy signal\r\n- Rising on-chain volume → Increasing on-chain activity and market heat\r\n\r\n---\r\n\r\n## Scenario 2: Capital Flow Analysis\r\n\r\n**Triggers**: Where is capital flowing, on-chain trends, which tokens are being bought, stablecoins, smart money\r\n\r\nExecute in parallel:\r\n\r\n```bash\r\n# 1. Top 10 tokens by on-chain net inflow (default solana; replace network param for Base/ETH)\r\ncurl -s -H \"api-key: $BLOCKBEATS_API_KEY\" \\\r\n  \"https://api-pro.theblockbeats.info/v1/data/top10_netflow\" \\\r\n  -G --data-urlencode "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dybqnmkdzwstxgz8z1nha0s82dwja\",\n  \"slug\": \"blockbeats-skill\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1774321619350\n}"},{"path":"skill-card.md","content":"## Description:\n\nBlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[blockbeatsofficial](https://clawhub.ai/user/blockbeatsofficial)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to query BlockBeats Pro API news, article, search, RSS, and crypto market-data endpoints. It supports market overview, capital flow, macro, derivatives, keyword search, and news-list workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends market, news, and keyword-search queries to BlockBeats using a user-provided API key.\n\nMitigation: Install only when that data sharing is acceptable, keep BLOCKBEATS_API_KEY in environment configuration, and avoid sensitive keyword searches.\n\nRisk: Market interpretation rules may produce buy, sell, bullish, or bearish commentary.\n\nMitigation: Present those outputs as informational market commentary rather than financial advice.\n\nRisk: Broad trigger phrases such as market overview or search terms may invoke external API calls unexpectedly.\n\nMitigation: Prefer explicit prompts such as 'search BlockBeats for ...' and confirm intent before sending ambiguous queries.\n\nRisk: Results depend on BlockBeats API availability, subscription status, and endpoint data-refresh frequency.\n\nMitigation: Surface API status messages clearly, tolerate partial request failures, and note data delays where endpoint behavior indicates daily or monthly refreshes.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/blockbeatsofficial/skills/blockbeats-skill)\n- [Publisher profile](https://clawhub.ai/user/blockbeatsofficial)\n- [BlockBeats Pro API base URL](https://api-pro.theblockbeats.info)\n- [BlockBeats API access page](https://www.theblockbeats.info/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, guidance]\n\n**Output Format:** [Markdown summaries with inline shell commands and API response interpretation]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires curl and BLOCKBEATS_API_KEY; sends selected market, news, and keyword queries to BlockBeats.]\n\n## Skill Version(s):\n\n1.0.3 (source: release evidence and skill metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also fea... Skill: blockbeats--skill Owner: blockbeatsofficial Summary: BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also fea... Tags: latest:1.0.3 Version history: v1.0.3 | 2026-03-24T03:06:59.350Z | user blockbeats-skill 1.0.3 - Updated environment and installation metadata for improved clarity and support (added primaryEnv,","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1146,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T16:56:41.430Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T16:56:41.430Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T17:24:45.744Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}