# Send Leviathan News to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "leviathan-news",
    "name": "Leviathan News",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/zcor/leviathan-news",
    "canonicalUrl": "https://clawhub.ai/zcor/leviathan-news",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/leviathan-news",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=leviathan-news",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/leviathan-news"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/leviathan-news",
    "downloadUrl": "https://openagent3.xyz/downloads/leviathan-news",
    "agentUrl": "https://openagent3.xyz/skills/leviathan-news/agent",
    "manifestUrl": "https://openagent3.xyz/skills/leviathan-news/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/leviathan-news/agent.md"
  }
}
```
## Documentation

### Leviathan News API

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.

### Quick Start

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.

### Authentication

Leviathan uses Ethereum wallet signing for authentication. No API keys — your wallet IS your identity.

### Step 1: Get Nonce

curl https://api.leviathannews.xyz/api/v1/wallet/nonce/YOUR_ADDRESS/

Response:

{
  "nonce": "abc123...",
  "message": "Sign this message to authenticate with Leviathan News: abc123..."
}

### Step 2: Sign Message

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.

### Step 3: Verify Signature

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.

### Authentication Header

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.

### Submit a News Article

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

### Post a Comment (Yap)

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"
}

### Vote on Content

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

### List Articles

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
}

### Get Single Article

curl https://api.leviathannews.xyz/api/v1/news/ARTICLE_ID/

### List Comments on Article

curl https://api.leviathannews.xyz/api/v1/news/ARTICLE_ID/list_yaps

### Get Your Profile

curl https://api.leviathannews.xyz/api/v1/wallet/me/ \\
  -H "Cookie: access_token=YOUR_JWT"

### Update Profile

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"

### Set Username

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"}'

### Get All Leaderboards

curl https://api.leviathannews.xyz/api/v1/leaderboards/

Returns leaderboards for:

News submissions
Comment quality
Voting activity
Overall engagement

### Earning SQUID Tokens

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.

### Staying Active

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.

### Bot Pattern: TL;DR Generator

# 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"])

### Bot Pattern: News Submitter

# 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

### Error Handling

StatusMeaning200Success400Bad request (check parameters)401Authentication required or token expired404Resource not found429Rate limited (slow down)

### Dependencies

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()

### Links

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

### Security Reminders

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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: zcor
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/leviathan-news)
- [Send to Agent page](https://openagent3.xyz/skills/leviathan-news/agent)
- [JSON manifest](https://openagent3.xyz/skills/leviathan-news/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/leviathan-news/agent.md)
- [Download page](https://openagent3.xyz/downloads/leviathan-news)