# Bullionwale API

> Customer API documentation for placing and reading Bullionwale bullion orders with an API key.

- [Bullionwale API](https://docs.bullionwale.com/index.md): Place and read bullion orders from your own systems with an API key.
- [Quickstart](https://docs.bullionwale.com/quickstart.md): From a test key to your first simulated order.
- [Getting API access and credentials](https://docs.bullionwale.com/getting-access.md): How API access is turned on for your account and how your API keys are issued.
- [Test and production environments](https://docs.bullionwale.com/environments.md): Two environments with the same calls: simulated orders in test, real orders in production.
- [Your first test order](https://docs.bullionwale.com/first-test-order.md): Place a simulated order, replay it safely, list your orders, read your positions and see the common errors.
- [Order status, history and positions](https://docs.bullionwale.com/orders-and-positions.md): What an order looks like, how its status changes, which orders you see, and how positions relate to your weight allocation.
- [Idempotency and safe retries](https://docs.bullionwale.com/idempotency.md): How the Idempotency-Key header makes a retry after a timeout safe, and how to find out what happened to an order.
- [Credential rotation, expiry and revocation](https://docs.bullionwale.com/credentials.md): How to replace a key without downtime, what happens when a key expires, and how to stop a key at once.
- [Rate limits, errors and troubleshooting](https://docs.bullionwale.com/errors.md): The error format, every error code, the rate limits, and what to do when a call fails.
- [Production access requirements](https://docs.bullionwale.com/production-access.md): What must be in place before you can place a real order, and how to tell whether it is.
- [OpenAPI spec and Postman collection](https://docs.bullionwale.com/openapi-and-postman.md): Download the machine-readable API description and a ready-made Postman collection.
- [API reference](https://docs.bullionwale.com/api-reference/overview.md): Every endpoint of the Bullionwale API, generated from its OpenAPI spec.
- [Who am I (test)](https://docs.bullionwale.com/api-reference/test-environment/who-am-i-test.md): **Available on request.** Ask the Bullionwale desk to turn on API access for your account and issue a test key. Test orders are simulated; nothing is booked.
- [Place a simulated order (test)](https://docs.bullionwale.com/api-reference/test-environment/place-a-simulated-order-test.md): **Available on request.** Ask the Bullionwale desk to turn on API access for your account and issue a test key. Test orders are simulated; nothing is booked.
- [List simulated orders (test)](https://docs.bullionwale.com/api-reference/test-environment/list-simulated-orders-test.md): **Available on request.** Ask the Bullionwale desk to turn on API access for your account and issue a test key. Test orders are simulated; nothing is booked.
- [One simulated order (test)](https://docs.bullionwale.com/api-reference/test-environment/one-simulated-order-test.md): **Available on request.** Ask the Bullionwale desk to turn on API access for your account and issue a test key. Test orders are simulated; nothing is booked.
- [Test positions](https://docs.bullionwale.com/api-reference/test-environment/test-positions.md): **Available on request.** Ask the Bullionwale desk to turn on API access for your account and issue a test key. Test orders are simulated; nothing is booked.
- [Who am I (production)](https://docs.bullionwale.com/api-reference/production-environment/who-am-i-production.md): **Switched off.** Production trading is implemented but not available: orders are refused with `403 production_trading_disabled`. Once it opens, Bullionwale enables production access per account (see Production access requirements).
- [Place a REAL market order (production)](https://docs.bullionwale.com/api-reference/production-environment/place-a-real-market-order-production.md): **Switched off.** Production trading is implemented but not available: orders are refused with `403 production_trading_disabled`. Once it opens, Bullionwale enables production access per account (see Production access requirements).
- [List orders (production)](https://docs.bullionwale.com/api-reference/production-environment/list-orders-production.md): **Switched off.** Production trading is implemented but not available: orders are refused with `403 production_trading_disabled`. Once it opens, Bullionwale enables production access per account (see Production access requirements).
- [One order (production)](https://docs.bullionwale.com/api-reference/production-environment/one-order-production.md): **Switched off.** Production trading is implemented but not available: orders are refused with `403 production_trading_disabled`. Once it opens, Bullionwale enables production access per account (see Production access requirements).
- [Production positions](https://docs.bullionwale.com/api-reference/production-environment/production-positions.md): **Switched off.** Production trading is implemented but not available: orders are refused with `403 production_trading_disabled`. Once it opens, Bullionwale enables production access per account (see Production access requirements).

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.