Consultar una wallet
GET
/v1/partner/wallets/{publicId}wallets:readConsulta una wallet por su ULID. Ajena o inexistente responde 404.
Propósito
Obtiene los datos de una wallet específica usando su publicId (ULID devuelto por POST /wallets).
Estados posibles
ACTIVE: la wallet está lista y tieneaddressasignado.PENDING: el proveedor no confirmó todavía.addressseránull. Se resuelve automáticamente.
Seguridad
Un publicId de otro partner o inexistente responde 404 — nunca 403.
Parámetros de ruta
publicId- La wallet, de `POST /wallets` o de `GET /wallets`. ULID de 26 caracteres; ajeno o inexistente ⇒ 404 (nunca 403: un 403 confirmaría que existe). Ejemplo:
01JKX7MNDR0000000000000037
Respuesta 200
Los dos estados que un integrador se encuentra de verdad
admite null
Ejemplo:
"0xabcdef1234567890abcdef1234567890abcdef12"chainstringEjemplo:
"BASE"createdAtstringEjemplo:
"2026-09-04T15:04:05.000Z"networkstringEjemplo:
"MAINNET"ownerPublicIdstringEjemplo:
"01JKX7PEND0000000000000036"providerCodestringEjemplo:
"CROSSMINT"publicIdstringEjemplo:
"01JKX7MNDR0000000000000037"purposestringEjemplo:
"PAYMENTS"statusenumPENDINGACTIVEFAILEDDISABLEDMIGRATINGEjemplo:
"ACTIVE"
Errores
| Estado | Códigos | Cuándo |
|---|---|---|
401 | sin code | Sin x-api-key válida |
403 | sin code | La llave no tiene el scope wallets:read |
404 | WALLET_NOT_FOUND | No existe o no es de este partner |
429 | RATE_LIMITED | Limite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`. |