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
| Param | Required | Description |
|---|---|---|
orderId | yes | Aged-wallets order id. |
Response 200
{
"orderId": "665f1c2e9b1d4a0012345678",
"imported": ["<public key>"],
"alreadyOwned": [],
"missing": []
}
| Field | Description |
|---|---|
imported | Public keys added to your account by this call. |
alreadyOwned | Public keys you already held. |
missing | Public keys whose key material could not be read. |
Errors
| Status | Meaning |
|---|---|
400 | orderId malformed, or the import would exceed the per-user wallet maximum. |
404 | Order not found or not yours. |
409 | Order is not FULFILLED yet. |
Example
curl -X POST "$BASE_URL/aged-wallets/import/<orderId>" \
-H "Authorization: Bearer $ACCESS" -H "x-user-id: $USER_ID"