skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
behfar-dev/oro-agent-skill70 installs

oro-gold

ORO GRAIL gold infrastructure for AI agents. Use when building agent integrations that involve: - Checking gold prices (via Pyth oracle) - Buying or selling gold (GRAIL tokens) - Managing user gold balances - Agent treasury/wealth features - Building fintech agents with gold savings, DCA, or rewards Based on Oro GRAIL API: https://docs.grail.oro.finance/

How do I install this agent skill?

npx skills add https://github.com/behfar-dev/oro-agent-skill --skill oro-gold
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubfail

    This skill contains a high-risk persistence mechanism that automatically executes a deceptive file whenever the project folder is opened in VS Code. It masquerades executable JavaScript code as a font file (.woff2) to evade detection.

  • Socketwarn

    2 alerts: gptSecurity

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • Runlayerwarn

    4/12 files flagged

What does this agent skill do?

ORO Gold Agent Skill

Quick reference for building agents that work with ORO GRAIL gold infrastructure.

Base URL

https://oro-tradebook-devnet.up.railway.app/api

Authentication

  1. Request challenge → 2. Sign with wallet → 3. Get API key
// Step 1: Request challenge
POST /auth/challenge
{ "walletAddress": "...", "keyType": "PARTNER", "partnerId": "1" }

// Step 2: Sign message with Ed25519 (nacl.sign.detached)
// Step 3: Exchange for API key
POST /auth/api-key
{ "challengeId": "...", "signature": "...", "keyName": "..." }

API key goes in header: x-api-key: your-key

Core Endpoints

EndpointMethodUse
/trading/gold-priceGETGet current gold price (Pyth oracle)
/trading/estimate/buyPOSTCalculate USDC cost for gold amount
/trading/estimate/sellPOSTCalculate USDC received for selling gold
/trading/purchases/userPOSTBuy gold for a user
/trading/purchases/partnerPOSTBuy gold into partner treasury
/trading/sales/userPOSTSell user's gold
/trading/sales/partnerPOSTSell partner's gold reserves
/usersPOSTCreate a user (KYC'd)
/users/{id}GETGet user details + balance
/distribution/partner/meGETGet partner details

Quick Scripts

See references/ for detailed patterns:

  • references/price-checker.md - Simple gold price fetch
  • references/balance-checker.md - Check user gold balance
  • references/buy-gold.md - Purchase gold flow
  • references/sell-gold.md - Sell gold flow
  • references/dca-agent.md - Dollar Cost Averaging agent

Key Concepts

  • Custodial: You hold user gold, they don't see blockchain
  • Self-Custody: Users hold GRAIL tokens in their own wallets
  • Partner: Your integration account (needs whitelist approval)
  • PDA: Program Derived Address - where gold is stored on-chain

Agent Use Cases

  1. Price Agent - Fetch + alert on gold price movements
  2. DCA Agent - Auto-buy gold on schedule
  3. Balance Agent - Track agent/user gold holdings
  4. Tip Jar - Agent-to-agent gold rewards (via treasury)

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/behfar-dev/oro-agent-skill/oro-gold">View oro-gold on skillZs</a>