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.

For the same journey with screenshots of each screen, see Run a test buy in the dashboard tutorials.

← Overview Authentication →