Overview
Browse inventory, reserve a lot, pay on-chain, take delivery of the keys, and fund the wallets you own.
The marketplace sells wallets that already have a history: an age, a balance, a transaction record, a funding origin. This API is how your organisation buys them and manages them afterwards.
Everything here happens under one organisation. Whatever credential you present resolves to exactly one org, and every list, quote, wallet and balance you can reach belongs to it.
The shape of a purchase
Four calls, and the third one is mostly waiting.
- Browse.
GET /catalogreturns listed wallets matching your filters, each priced the way a quote would price it. - Reserve.
POST /quotetakes wallets out of the catalog, holds them for you, and mints a fresh payment address. - Pay. Send the exact amount to that address. Settlement is automatic: the API watches the chain and closes the order itself when the money lands.
- Collect.
GET /quote/{id}/keyshands back the private keys.
There is no card, no invoice, no callback to a payment provider. The payment address is the checkout, and the order settles once its balance covers the amount due.
What else is here
Authentication
API keys for integrations, user sessions for people. Which one each endpoint wants, and why.
Conventions
Amounts, chains, pagination, errors. Read this once and the rest reads itself.
Catalog
Filtering inventory, reading facets, and where a wallet's price comes from.
Quotes
Reserving a lot, the two expiry clocks, and how payment turns into a sale.
Purchases
Order history, what was in each one, and the record of the orders that never closed.
Wallets & keys
Your inventory after the sale: key retrieval, key formats, and buyer references.
Security
How private keys are stored, where the decryption key lives, and the two moments a key exists in plaintext.
Top up wallets
Getting native currency into wallets, bundled with an order or on its own.
Balance
What accrues to your organisation, and how to take it out.
Organisation
Markup, API keys, users, invitations, and the numbers on your dashboard.
Base URL
https://marketplace-api.hushxima.comThe machine-readable description is served by the API itself at
/openapi.json, and this
site is generated from it. There is a Swagger UI at /swagger-ui if you would
rather poke at it there.
GET /health is the only unauthenticated endpoint.
Response Body
application/json
curl -X GET "https://example.com/health"{ "status": "string"}Last updated on