Skip to main content

POST /aged-wallets/import/:orderId

Add the wallets of a FULFILLED order to your Orbitt wallets, server side — the private keys never leave Orbitt.

Repeating the call is harmless: wallets you already hold are reported in alreadyOwned and not added again. Concurrent calls from the same user are queued one after another.

Use case​

Use bought wallets in bots straight away, without handling keys.

Path params​

ParamRequiredDescription
orderIdyesAged-wallets order id.

Response 200​

{
"orderId": "665f1c2e9b1d4a0012345678",
"imported": ["<public key>"],
"alreadyOwned": [],
"missing": []
}
FieldDescription
importedPublic keys added to your account by this call.
alreadyOwnedPublic keys you already held.
missingPublic keys whose key material could not be read.

Errors​

StatusMeaning
400orderId malformed, or the import would exceed the per-user wallet maximum.
404Order not found or not yours.
409Order is not FULFILLED yet.

Example​

curl -X POST "$BASE_URL/aged-wallets/import/<orderId>" \
-H "Authorization: Bearer $ACCESS" -H "x-user-id: $USER_ID"