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-goldIs 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
- 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
| Endpoint | Method | Use |
|---|---|---|
/trading/gold-price | GET | Get current gold price (Pyth oracle) |
/trading/estimate/buy | POST | Calculate USDC cost for gold amount |
/trading/estimate/sell | POST | Calculate USDC received for selling gold |
/trading/purchases/user | POST | Buy gold for a user |
/trading/purchases/partner | POST | Buy gold into partner treasury |
/trading/sales/user | POST | Sell user's gold |
/trading/sales/partner | POST | Sell partner's gold reserves |
/users | POST | Create a user (KYC'd) |
/users/{id} | GET | Get user details + balance |
/distribution/partner/me | GET | Get partner details |
Quick Scripts
See references/ for detailed patterns:
references/price-checker.md- Simple gold price fetchreferences/balance-checker.md- Check user gold balancereferences/buy-gold.md- Purchase gold flowreferences/sell-gold.md- Sell gold flowreferences/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
- Price Agent - Fetch + alert on gold price movements
- DCA Agent - Auto-buy gold on schedule
- Balance Agent - Track agent/user gold holdings
- Tip Jar - Agent-to-agent gold rewards (via treasury)
How can the creator link this skill?
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>