mcpField
O
oro-gold

oro-gold

github.com/behfar-devOther070 installsUpdated 35w ago
Repository

About oro-gold

oro-gold is a reference skill for building agents that use ORO GRAIL gold infrastructure, intended for integrators and automation developers. It documents authentication, trading APIs, user and balance endpoints, and common agent workflows for buying and selling gold.

Key features

  1. 01Describe wallet-signature authentication and API key setup
  2. 02Retrieve gold prices and buy or sell estimates
  3. 03Buy or sell gold for users or partners
  4. 04Create users and retrieve details and balances
  5. 05Include reference scripts for pricing, balances, and DCA

Use cases

  1. 01Monitor gold prices and send alerts
  2. 02Buy gold automatically on a schedule
  3. 03Track gold holdings for users or agents
  4. 04Issue agent rewards through a partner treasury

Install

Copy the command and run it in a terminal.

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

After installing, type/oro-goldin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
README.md
LICENSE
.vscode/
settings.json
tasks.json
references/
dca-agent.md
balance-checker.md
price-checker.md
buy-gold.md
sell-gold.md
references/public/fonts/
README.md
scripts/
oro_dca.py
__init__.py
oro_gold.py

Details

From the project README

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)

Comments

Markdown supported