Quickstart

From zero to your first buy in about five minutes — all in sandbox, no real money.

1. Get a sandbox key

2. Create a test user

Trusted server-to-server registration returns a persistent user_code you replay on later calls.

POST/partner/users/init

curl -X POST https://api.oropocket.com/partner/users/init \
  -H "Authorization: Bearer oro_test_xxx" \
  -d '{"flow":"api","mobile":"9000000001"}'

3. Quote and buy gold

Buys are two steps: get a quote, then confirm it. Sandbox uses real prices and simulates settlement.

POST/partner/buy/quote

POST/partner/buy/confirm

# 1) quote
curl -X POST https://api.oropocket.com/partner/buy/quote \
  -H "Authorization: Bearer oro_test_xxx" \
  -d '{"user_code":"usr_test_abc","asset_type":"gold","amount_inr":100}'

# 2) confirm with the returned quote_id
curl -X POST https://api.oropocket.com/partner/buy/confirm \
  -H "Authorization: Bearer oro_test_xxx" \
  -d '{"quote_id":"tqt_xxx"}'

4. Check the portfolio

GET/partner/users/:user_code/portfolio

curl https://api.oropocket.com/partner/users/usr_test_abc/portfolio \
  -H "Authorization: Bearer oro_test_xxx"

Try all of this without writing code in the Playground. When you're ready for production, follow the free Go Live flow.

← Overview Authentication →