Skip to main content

​
Integration Guides

These guides walk you through end-to-end integration flows, from initial authentication to executing trades and managing your treasury. Each guide builds on the previous one and includes copy-pasteable code examples.

​
Before You Begin

Make sure you have:
  • A registered Distribution Partner account with Oro
  • Your executive authority wallet (Solana keypair)
  • Node.js 18+ and @solana/web3.js installed (for transaction signing)
  • Access to the devnet API at https://oro-tradebook-devnet.up.railway.app

​
Guides

Authentication & Setup

Generate API keys, configure scopes, and verify your partner setup.

Creating & Managing Users

Create KYC-verified users for custodial or self-custody flows.

Buying Gold

Get estimates, create purchase transactions for users or partners, and sign and submit on-chain.

Selling Gold

Get estimates, create sell transactions, and convert gold back to USDC with slippage protection.

Withdrawals & Partner Management

Withdraw funds, rotate executive authority wallets, and batch transactions.
Follow the guides in order for a complete integration:
  1. Authentication & Setup — Get your API key and verify your partner account
  2. Creating & Managing Users — Onboard users with KYC verification
  3. Buying Gold — Execute your first gold purchase
  4. Selling Gold — Sell gold back to USDC
  5. Withdrawals & Partner Management — Manage your treasury and partner settings