Listar wallets
GET
/v1/partner/walletswallets:readLista las wallets de todos los usuarios de este partner, paginadas por cursor
Propósito
Obtiene todas las wallets de los usuarios que diste de alta. Incluye wallets en estado PENDING.
Paginación
limit: tamaño de página (máx 100).cursor: valor denextCursorde la respuesta anterior.- Cuando
nextCursoresnull, ya no hay más páginas.
Nota
Las wallets PENDING no se ocultan — se resuelven automáticamente cada 15 minutos.
Parámetros de consulta
limit- Tamaño de página. Default 20, tope 100 aplicado en el repositorio.
cursor- Cursor opaco: el `nextCursor` de la página anterior, tal cual. No es un offset y no se interpreta; basura ⇒ 400 CURSOR_INVALID. En la primera página se omite.
Respuesta 200
Última página: nextCursor en null significa que ya no hay más
itemsarray de WalletResponseDtoadmite null
Ejemplo:
"0xabcdef1234567890abcdef1234567890abcdef12"chainstringEjemplo:
"BASE"createdAtstringEjemplo:
"2026-09-04T15:04:05.000Z"networkstringEjemplo:
"MAINNET"ownerPublicIdstringEjemplo:
"01JKX7PEND0000000000000036"providerCodestringEjemplo:
"CROSSMINT"publicIdstringEjemplo:
"01JKX7MNDR0000000000000037"purposestringEjemplo:
"PAYMENTS"statusenumPENDINGACTIVEFAILEDDISABLEDMIGRATINGEjemplo:
"ACTIVE"
Cursor de la página siguiente; null si es la última.
admite null
Ejemplo:
"MDFKS1g3TUpQTjAwMDAwMDAwMDAwMDAwMDE"
Errores
| Estado | Códigos | Cuándo |
|---|---|---|
400 | CURSOR_INVALID | Error con code: CURSOR_INVALID |
401 | sin code | Sin x-api-key válida |
403 | sin code | La llave no tiene el scope wallets:read |
429 | RATE_LIMITED | Limite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`. |