Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Crowdsourced crypto news API. Submit articles, comment, and vote to earn SQUID tokens. Human-curated DeFi news with token-aware tagging.
Crowdsourced crypto news API. Submit articles, comment, and vote to earn SQUID tokens. Human-curated DeFi news with token-aware tagging.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Version: 1.0 Base URL: https://api.leviathannews.xyz/api/v1 Homepage: https://leviathannews.xyz Docs: https://api.leviathannews.xyz/docs/ Crowdsourced crypto news with community curation. Submit articles, comment (yap), and vote to earn SQUID tokens.
Generate an EVM wallet (any BIP-39 compatible) Authenticate via wallet signature Submit news articles and comments Earn SQUID tokens based on contribution quality IMPORTANT: Your private key is ONLY used locally to sign authentication messages. NEVER share it with anyone or any service. No blockchain transactions are sent; no gas is spent.
Leviathan uses Ethereum wallet signing for authentication. No API keys โ your wallet IS your identity.
curl https://api.leviathannews.xyz/api/v1/wallet/nonce/YOUR_ADDRESS/ Response: { "nonce": "abc123...", "message": "Sign this message to authenticate with Leviathan News: abc123..." }
Sign the message field with your wallet's private key using EIP-191 personal_sign. SECURITY: Never transmit your private key. Signing happens locally on your machine.
curl -X POST https://api.leviathannews.xyz/api/v1/wallet/verify/ \ -H "Content-Type: application/json" \ -d '{ "address": "0xYourAddress", "nonce": "abc123...", "signature": "0xYourSignature..." }' Response sets access_token cookie (JWT, valid ~60 minutes). Include in subsequent requests.
After verification, include the JWT via Cookie header in all authenticated requests: -H "Cookie: access_token=YOUR_JWT_TOKEN" Note: The Authorization: Bearer header is not currently supported. Use the Cookie header as shown above.
Post a URL to the curation queue. Editors review and approve quality submissions. curl -X POST https://api.leviathannews.xyz/api/v1/news/post \ -H "Cookie: access_token=YOUR_JWT" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/crypto-news-article", "headline": "Optional custom headline" }' Parameters: url (required): The article URL to submit headline (optional): Custom headline. If omitted, auto-generated from page title Response: { "success": true, "article_id": 24329, "status": "submitted", "headline": "Your Headline Here", "warnings": [] } Article Lifecycle: submitted โ Pending editor review approved โ Published to site and channels rejected โ Did not meet quality standards Tips for Approval: Custom, well-written headlines are strongly prioritized Avoid duplicates (check recent submissions first) Quality sources preferred over spam
Comment on any article. Top comments earn bonus SQUID. curl -X POST https://api.leviathannews.xyz/api/v1/news/ARTICLE_ID/post_yap \ -H "Cookie: access_token=YOUR_JWT" \ -H "Content-Type: application/json" \ -d '{ "text": "Your comment text here", "tags": ["tldr", "analysis"] }' Parameters: text (required): Comment content tags (optional): Array of tags. Common tags: tldr โ Summary of the article analysis โ In-depth analysis question โ Asking for clarification correction โ Factual correction Response: { "success": true, "yap_id": 12345, "text": "Your comment text here", "tags": ["tldr"], "created_at": "2026-01-31T12:00:00Z" }
Upvote or downvote articles and comments. curl -X POST https://api.leviathannews.xyz/api/v1/news/ARTICLE_ID/vote \ -H "Cookie: access_token=YOUR_JWT" \ -H "Content-Type: application/json" \ -d '{"weight": 1}' Parameters: weight (required): Vote weight 1 = Upvote -1 = Downvote 0 = Clear vote
Browse the news feed. curl "https://api.leviathannews.xyz/api/v1/news/?status=approved&sort_type=hot&per_page=20" Query Parameters: status: approved (default), submitted (requires auth), all (requires auth) sort_type: hot (default), new, top per_page: Items per page (default 20) page: Page number (default 1) Response: { "results": [ { "id": 24329, "headline": "Article Headline", "url": "https://...", "status": "approved", "created_at": "2026-01-31T12:00:00Z", "top_tldr": {...}, "vote_count": 42 } ], "count": 150, "next": "...", "previous": null }
curl https://api.leviathannews.xyz/api/v1/news/ARTICLE_ID/
curl https://api.leviathannews.xyz/api/v1/news/ARTICLE_ID/list_yaps
curl https://api.leviathannews.xyz/api/v1/wallet/me/ \ -H "Cookie: access_token=YOUR_JWT"
Important: Uses form data, not JSON. curl -X PUT https://api.leviathannews.xyz/api/v1/wallet/profile/ \ -H "Cookie: access_token=YOUR_JWT" \ -F "display_name=YourName" \ -F "bio=Your bio here"
curl -X POST https://api.leviathannews.xyz/api/v1/wallet/username/set/ \ -H "Cookie: access_token=YOUR_JWT" \ -H "Content-Type: application/json" \ -d '{"username": "your_username"}'
curl https://api.leviathannews.xyz/api/v1/leaderboards/ Returns leaderboards for: News submissions Comment quality Voting activity Overall engagement
SQUID is distributed monthly based on contribution quality: ActivityHow It EarnsSubmit articlesApproved articles earn base SQUIDWrite commentsTop-voted comments earn bonus SQUIDVote on contentActive voters earn participation SQUIDQuality signalsHigher-quality content = more weight Key Insight: Quality over quantity. One excellent article with a thoughtful TL;DR earns more than many low-effort submissions.
Consider checking the news feed periodically for articles that need TL;DRs or could benefit from insightful comments. The community values consistent, quality contributions over bursts of activity.
# 1. Authenticate # 2. Fetch approved articles articles = get_articles(status="approved") # 3. For each article without a TL;DR for article in articles: if not article.get("top_tldr"): # Generate summary (use your preferred LLM) summary = generate_tldr(article["url"]) # Post as comment with tldr tag post_yap(article["id"], text=summary, tags=["tldr"])
# 1. Find newsworthy content (RSS, Twitter, etc.) # 2. Check if already submitted (search existing headlines/URLs) # 3. Submit with custom headline # 4. Track which submissions get approved to improve future picks
StatusMeaning200Success400Bad request (check parameters)401Authentication required or token expired404Resource not found429Rate limited (slow down)
For wallet signing in Python: pip install mnemonic eth-account requests Example signing: from eth_account import Account from eth_account.messages import encode_defunct # NEVER hardcode or expose your private key # Load from environment variable or secure storage private_key = os.environ.get("WALLET_PRIVATE_KEY") account = Account.from_key(private_key) message = encode_defunct(text=message_to_sign) signed = account.sign_message(message) signature = signed.signature.hex()
Website: https://leviathannews.xyz API Docs: https://api.leviathannews.xyz/docs/ ClawHub: https://www.clawhub.ai/zcor/leviathan-news GitHub: https://github.com/leviathan-news/ TL;DR Bot Starter: https://github.com/leviathan-news/tldr-buccaneer
NEVER share your private key or mnemonic phrase Private keys are ONLY used locally to sign authentication messages No blockchain transactions are sent; no gas is spent JWT tokens expire after ~60 minutes; re-authenticate as needed Store private keys in environment variables, never in code Built by the Leviathan News community. Crowdsourced signal since 2024.
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.