A digital gold API you can ship this week
Your interface, your rules.
Buy, sell and hold 24K gold and silver server-to-server — priced in INR, backed by physical bullion. You own every pixel and every step; we own the settlement.
No card. No approval queue. No sales call.
Two calls to buy
Quote locks a rate for ten minutes; confirm settles it. Idempotent, so a retry is always safe.
KYC through the same API
Email, PAN and Aadhaar verification, with the rejected path available in sandbox so you can handle it.
Never poll
Signed webhooks, retried across six hours, replayable by you at any time.
Quote it. Confirm it. Get told when it lands.
The same sequence the guide walks through, so you can see the shape before you read a line of reference.
- Your server:
Register the user
Trusted registration returns a persistent user_code. You own their UX and their OTP — we never message them.
POST/partner /users /init - Your server:
Lock a quote
Quote a rupee amount of gold or silver. The rate and the price block it was struck against are frozen.
POST/partner /buy /quote Held for 10 minutes.
- Your server:
Confirm it
Send the quote_id with an Idempotency-Key. Your float is debited and the user is credited.
POST/partner /buy /confirm A replay returns the original response rather than buying twice.
- OroPocket:
It settles, or it refunds
If fulfilment fails after the debit, the wallet is credited back and the order voided automatically.
- OroPocket:
We call your webhook
Signed, timestamped and retried across six hours. Selling mirrors the same quote-then-confirm shape.
Two calls, or one.
# 1. quote — locks the rate for 10 minutes
curl -X POST https://api.oropocket.com/partner/buy/quote \
-H "Authorization: Bearer oro_test_xxx" \
-d '{"user_code":"usr_xxx","asset_type":"gold","amount_inr":1000}'
# 2. confirm — safe to retry with the same key
curl -X POST https://api.oropocket.com/partner/buy/confirm \
-H "Authorization: Bearer oro_test_xxx" \
-H "Idempotency-Key: 8f14e45f-ea0a-4d1b-9c7e-2b1f0c3a5d6e" \
-d '{"quote_id":"tqt_xxx"}'What you are not building.
The parts of this that are hard are the parts you would otherwise have to write, test and operate yourself.
Retry without fear
Send an Idempotency-Key and a replay returns the original response rather than a second purchase. Keys are scoped per environment, so a key you exercised in sandbox can never satisfy a live request.
Failures refund themselves
If your float is debited and fulfilment then fails, the wallet is credited back automatically and the order voided. You get a clear error instead of a silent hole in your ledger.
A sandbox with a balance sheet
Your sandbox wallet starts at ₹1,00,000 and every test buy debits it, so insufficient-funds is a state you can actually reach. Prices are the live feed; only settlement is simulated.
Your position, already reconciled
Every asset your integration puts in a user's hands moves in a per-partner ledger, in the same transaction as the balance. You can reconcile without running a ledger of your own.
You are paid to integrate, not charged for it.
There are no per-call fees, no monthly minimums and nothing to pay to go live. Buys by users attributed to your integration earn 1%, or 2% on Pro. Buys debit your float and credit the end user — you collect from your user on your side, so the money never sits still.
Frequently asked.
- What is a digital gold API?
- A REST API to programmatically buy, sell and hold 24K digital gold and silver backed by physical bullion, priced in INR and settled in India. OroPocket exposes it server-to-server, so you build and own the entire interface.
- How fast can I integrate?
- Verify a mobile number and your sandbox key is on screen — no card, no approval step. The buy path is two calls: quote, then confirm. Going live is a free four-step wizard and most applications are approved within one business day.
- Does it support silver too?
- At full parity. Every operation takes an asset_type of gold or silver, and quoting, buying, selling, sending and physical delivery all work identically for both. There is no gold-only endpoint.
- What happens if a confirm call times out?
- Send an Idempotency-Key and retry. The replay returns the original response, flagged as a replay, rather than buying twice. Quotes are row-locked as well, so two concurrent confirms can never both settle.
- Is there a fee?
- No platform fee, no per-call fee and no charge to go live. You earn 1% commission on buys by users attributed to you, rising to 2% on the optional Pro tier. You only pay for the assets you actually buy.
Start with a key, not a meeting.
Verify a mobile number, pick what you are building, and your sandbox key is on the screen.