# Oro Grail

## Docs

- [Create API Key](https://docs.grail.oro.finance/api-reference/authentication/create-api-key.md): Step 2 of the API key mint flow. Exchanges a signed challenge for a PARTNER scope API key.
- [Request API Key Challenge](https://docs.grail.oro.finance/api-reference/authentication/request-challenge.md): Step 1 of the API key mint flow. Returns a nonce message that the partner wallet must sign.
- [List Denominations](https://docs.grail.oro.finance/api-reference/denominations/list-denominations.md): Returns the active physical-gold denominations available for redemption in a given country.
- [Health Check](https://docs.grail.oro.finance/api-reference/general/health.md): Liveness probe. Returns a simple JSON body. No authentication required.
- [API Overview](https://docs.grail.oro.finance/api-reference/overview.md): Shape, conventions, and authentication model for the GRAIL API.
- [List API Keys](https://docs.grail.oro.finance/api-reference/partner/list-api-keys.md): Returns metadata for every API key minted against the authenticated partner's wallet.
- [Revoke API Key](https://docs.grail.oro.finance/api-reference/partner/revoke-api-key.md): Permanently revokes an API key. Revocation is immediate and irreversible.
- [Cancel Redemption](https://docs.grail.oro.finance/api-reference/redemptions/cancel-redemption.md): Requests cancellation of a submitted redemption. Only valid before ORO starts physical preparation.
- [Get Redemption](https://docs.grail.oro.finance/api-reference/redemptions/get-redemption.md): Fetches a single redemption by ID. Returns 404 while the redemption is at the internal quoted state.
- [List Redemptions](https://docs.grail.oro.finance/api-reference/redemptions/list-redemptions.md): Lists redemptions for the authenticated partner. Excludes the internal quoted state.
- [Quote Redemption](https://docs.grail.oro.finance/api-reference/redemptions/quote-redemption.md): Quotes a physical-gold redemption. Returns a partially-signed transaction for the user to co-sign.
- [Submit Redemption](https://docs.grail.oro.finance/api-reference/redemptions/submit-redemption.md): Broadcasts the user-signed redemption transaction to Solana. Pure passthrough.
- [Get Trade](https://docs.grail.oro.finance/api-reference/trades/get-trade.md): Fetches a single trade by ID. Returns 404 until the indexer has written the row.
- [List Trades](https://docs.grail.oro.finance/api-reference/trades/list-trades.md): Lists trades for the authenticated partner, with optional filters.
- [Quote Buy](https://docs.grail.oro.finance/api-reference/trades/quote-buy.md): Stateless quote for buying $GOLD with USDC. Returns a partially-signed Solana transaction to co-sign and submit.
- [Quote Sell](https://docs.grail.oro.finance/api-reference/trades/quote-sell.md): Stateless quote for selling $GOLD for USDC. Returns a partially-signed Solana transaction to co-sign and submit.
- [Submit Buy](https://docs.grail.oro.finance/api-reference/trades/submit-buy.md): Broadcasts the fully-signed buy transaction to Solana. Pure passthrough — no database write.
- [Submit Sell](https://docs.grail.oro.finance/api-reference/trades/submit-sell.md): Broadcasts the fully-signed sell transaction to Solana. Pure passthrough — no database write.
- [Create User](https://docs.grail.oro.finance/api-reference/users/create-user.md): Registers an end-user under the authenticated partner. KYC is flexible JSON — core fields are required, provider-specific data lives in kyc_data.
- [Get User](https://docs.grail.oro.finance/api-reference/users/get-user.md): Fetches a user's profile and KYC record. Only users belonging to the authenticated partner are accessible.
- [List Users](https://docs.grail.oro.finance/api-reference/users/list-users.md): Lists users for the authenticated partner, with optional filters.
- [Conclusion](https://docs.grail.oro.finance/conclusion.md)
- [Contact](https://docs.grail.oro.finance/contact.md)
- [Why Partner with GRAIL](https://docs.grail.oro.finance/grail-overview/advantages-for-dstribution-partners.md)
- [API Support](https://docs.grail.oro.finance/grail-overview/api-support.md)
- [Features](https://docs.grail.oro.finance/grail-overview/features.md)
- [Roadmap](https://docs.grail.oro.finance/grail-overview/future-expansion.md)
- [Overview](https://docs.grail.oro.finance/grail-overview/overview.md)
- [Security and Compliance](https://docs.grail.oro.finance/grail-overview/security-and-compliance.md)
- [Workflow Breakdown](https://docs.grail.oro.finance/grail-overview/workflow-breakdown.md)
- [Authentication & Setup](https://docs.grail.oro.finance/guides/authentication-and-setup.md): Mint a PARTNER API key via challenge-response and verify it against a protected endpoint.
- [Buying Gold](https://docs.grail.oro.finance/guides/buying-gold.md): Quote a buy, co-sign the returned transaction with partner + user wallets, submit, and wait for on-chain confirmation.
- [Creating & Managing Users](https://docs.grail.oro.finance/guides/creating-and-managing-users.md): Register end-users under your partner with flexible-JSON KYC. Users must reach kyc_level: full before they can trade or redeem.
- [Integration Guides](https://docs.grail.oro.finance/guides/overview.md): Step-by-step guides for integrating with the Oro GRAIL API.
- [Redeeming Physical Gold](https://docs.grail.oro.finance/guides/redeeming-physical-gold.md): Convert a user's $GOLD tokens into a physical-gold denomination for pickup. Two-signer transaction (GRAIL + user), and a multi-step admin lifecycle for fulfillment.
- [Selling Gold](https://docs.grail.oro.finance/guides/selling-gold.md): Mirror of the buy flow — quote a sell, co-sign with partner + user, submit, and wait for indexer confirmation.
- [GRAIL](https://docs.grail.oro.finance/index.md): Digital gold infrastructure for modern finance

## OpenAPI Specs

- [openapi](https://docs.grail.oro.finance/openapi.json)