← 返回 Skills 市场
evilboyajay

Alura

作者 Ajay Gautam · GitHub ↗ · v1.0.0
cross-platform ✓ 安全检测通过
526
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install alura
功能描述
Integrate with Alura Trading testnet API for user auth, trading sessions, market data, leaderboard, referrals, and USDC verification using Bearer token.
使用说明 (SKILL.md)

Alura Backend API

Use this skill when integrating with or calling the Alura Trading backend API. The testnet API base URL is https://testnet-api.alura.fun.

Base URL

https://testnet-api.alura.fun
  • Swagger docs: https://testnet-api.alura.fun/api/docs
  • All authenticated endpoints require Authorization: Bearer \x3CJWT>

Authentication (EVM Wallet)

1. Get challenge

POST /auth/evm/challenge
Content-Type: application/json

{ "address": "0x..." }

Returns { address, nonce, message }.

2. Sign & verify

User signs message with MetaMask (personal_sign). Then:

POST /auth/evm/verify
Content-Type: application/json

{ "address": "0x...", "signature": "0x...", "referralCode": "OPTIONAL" }

Returns { ok: true, accessToken, tokenType: "Bearer", expiresIn: 86400, ... }. Use accessToken for subsequent requests.

Trading Sessions

Base path: /trading-sessions. All require Bearer token.

Quick trade – create session

POST /trading-sessions
Authorization: Bearer \x3Ctoken>
Content-Type: application/json

{
  "budget": 100,
  "profitTarget": 40,
  "lossThreshold": 5,
  "maxPositions": 3,
  "assetIndex": 0
}

Required: budget (min 10), profitTarget (max 500), assetIndex (Hyperliquid perp index: 0=BTC, 1=ETH, 2=SOL, etc.).

Advance trade – create session

POST /trading-sessions/advance
Authorization: Bearer \x3Ctoken>
Content-Type: application/json

{
  "amount": 100,
  "executionStrategy": "Conservative" | "Aggressive" | "Degen",
  "strategyDuration": "1D" | "3D" | "7D" | "30D" | "90D" | "365D",
  "assetIndex": 0,
  "maxWalletBudget": false
}

Other trading endpoints

Method Path Description
GET /trading-sessions/active List active sessions
GET /trading-sessions/current-trade Current trade with positions
GET /trading-sessions/:sessionId/logs Session logs
GET /trading-sessions/trades/:tradeId/logs Trade logs (paginated)
POST /trading-sessions/positions/:positionId/close Close a position
POST /trading-sessions/positions/:positionId/close-signature Get signed close tx for frontend
POST /trading-sessions/trades/:tradeId/close Close trade (all positions)
POST /trading-sessions/trigger-cron Manually trigger cron (testing)

User

Base path: /user. All require Bearer token.

Method Path Description
GET /user/profile Current user profile
POST /user/fills/sync Sync fills from Hyperliquid
POST /user/withdraw Withdraw funds
POST /user/close-position Close position by assetIndex
POST /user/close-all-positions Close all positions
POST /user/send-usdc Send USDC
GET /auth/evm/trading-key Get trading agent key (auth)
POST /user/claim-reward Claim rewards

Indicators & Market Data

Base path: /api/indicators. Most are public.

Method Path Description
GET /api/indicators/health Service health
GET /api/indicators/candles/latest Latest candles
GET /api/indicators/candles/history/:symbol Historical candles
GET /api/indicators/candles/:symbol/:interval Candles by symbol/interval
GET /api/indicators/candles/aggregated/symbols Available symbols
GET /api/indicators/signals/:symbol/:interval Signals for symbol
GET /api/indicators/signals/all/:interval All symbols signals

Leaderboard

Base path: /api/leaderboard.

Method Path Description
GET /api/leaderboard/stats Leaderboard stats
GET /api/leaderboard/rankings Rankings
GET /api/leaderboard/user/:userId User ranking
GET /api/leaderboard/analytics Analytics
GET /api/leaderboard/health Health

Referrals

Base path: /referrals.

Method Path Description
GET /referrals/:userId User referral info
GET /referrals/:userId/stats Referral stats
POST /referrals/:userId/code Create referral code
POST /referrals/check Check referral code

USDC Verification

Base path: /usdc-verification.

Method Path Description
POST /usdc-verification/verify Verify USDC deposit
GET /usdc-verification/my-transactions My transactions
GET /usdc-verification/total-deposited Total deposited

Health

Method Path Description
GET /health Basic health
GET /health/kafka Kafka health

Asset Indices (Hyperliquid Perps)

Common perp asset indices:

Symbol Index
BTC 0
ETH 1
SOL 2
XRP 3
DOGE 4
AVAX 5

Error Handling

  • 401: Missing/invalid Bearer token. Re-auth via /auth/evm/challenge and /auth/evm/verify.
  • 400: Validation error. Check message in response body.
  • 429: Rate limit. Retry with backoff.
  • Common messages: Duplicate asset index: you already have an active trading session for this asset, Builder fee approval failed: HTTP request failed: status 429.
安全使用建议
This is an instruction-only testnet API integration and appears coherent, but the package origin is unverified (no homepage/source). Before installing or using: 1) Verify you trust the alura.testnet domain and the project (look for an official repo or docs). 2) Never paste or upload private keys; signing must be performed locally (MetaMask or other wallet) — the skill expects you to sign messages and return the signature to /auth/evm/verify. 3) Treat any accessToken/JWT as sensitive; do not share it outside intended requests. 4) Be cautious when using withdraw/send-USDC endpoints — confirm you are on testnet and not mainnet to avoid real fund transfers. 5) If you need higher assurance, ask the publisher for a homepage or source repo and double-check the API responses and rate limits mentioned in SKILL.md.
功能分析
Type: OpenClaw Skill Name: alura Version: 1.0.0 The skill bundle defines interactions with the Alura Trading backend API, including authentication, trading sessions, user profiles, and financial operations like withdrawals and sending USDC. While these financial operations are inherently high-risk if misused, the `SKILL.md` file provides a straightforward description of the API endpoints and their usage without any evidence of malicious intent, prompt injection attempts, data exfiltration, unauthorized execution, or obfuscation. The content is purely descriptive and aligns with the stated purpose of integrating with a trading platform.
能力评估
✓ Purpose & Capability
The name/description (Alura Trading testnet integration) matches the SKILL.md content: documented endpoints, EVM-wallet challenge/verify flow, trading session and market-data endpoints. The skill does not request unrelated credentials or binaries.
✓ Instruction Scope
Instructions are narrowly scoped to HTTP calls against the provided base URL and standard auth flow (personal_sign -> /auth/evm/verify -> Bearer token). The SKILL.md does not instruct the agent to read arbitrary files, env vars, or system state, nor to exfiltrate data to unexpected endpoints.
✓ Install Mechanism
There is no install spec and no code files; this is instruction-only, so nothing is written to disk or executed by the platform as part of install.
✓ Credentials
The skill declares no required environment variables or credentials. The API uses ephemeral JWT Bearer tokens obtained at runtime via wallet signature, which is appropriate for the documented endpoints. No unrelated secrets are requested.
✓ Persistence & Privilege
Skill is not forced-always, and does not request persistent privileges. Autonomous invocation is permitted (platform default) but not unusual here and not combined with other risky requests.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install alura
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /alura 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of Alura backend API integration. - Provides endpoints for trading sessions, user authentication (EVM wallet), market indicators, leaderboard, referrals, and USDC verification. - Supports quick and advanced trade session creation with asset index mapping. - Includes user actions: withdraw, claim rewards, and USDC transfer. - Exposes leaderboard stats, signals, analytics, and referral management routes. - Details error handling and authentication requirements for all endpoints. - Offers testnet base URL and comprehensive endpoint documentation links.
元数据
Slug alura
版本 1.0.0
许可证 —
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Alura 是什么？

Integrate with Alura Trading testnet API for user auth, trading sessions, market data, leaderboard, referrals, and USDC verification using Bearer token. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 526 次。

如何安装 Alura？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install alura」即可一键安装，无需额外配置。

Alura 是免费的吗？

是的，Alura 完全免费（开源免费），可自由下载、安装和使用。

Alura 支持哪些平台？

Alura 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Alura？

由 Ajay Gautam（@evilboyajay）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463556 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259610 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200551 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191226 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190235 · by oswalpalash

💬 留言讨论