Saltar al contenido
Docs

Referencia

Listar wallets

GET/v1/partner/walletswallets:read

Lista 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 de nextCursor de la respuesta anterior.
  • Cuando nextCursor es null, 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 WalletResponseDto
    • addressstringpuede venir null

      admite null

      Ejemplo: "0xabcdef1234567890abcdef1234567890abcdef12"

    • chainstring

      Ejemplo: "BASE"

    • createdAtstring

      Ejemplo: "2026-09-04T15:04:05.000Z"

    • networkstring

      Ejemplo: "MAINNET"

    • Ejemplo: "01JKX7PEND0000000000000036"

    • Ejemplo: "CROSSMINT"

    • publicIdstring

      Ejemplo: "01JKX7MNDR0000000000000037"

    • purposestring

      Ejemplo: "PAYMENTS"

    • statusenum

      PENDINGACTIVEFAILEDDISABLEDMIGRATING

      Ejemplo: "ACTIVE"

  • nextCursorstringpuede venir null

    Cursor de la página siguiente; null si es la última.

    admite null

    Ejemplo: "MDFKS1g3TUpQTjAwMDAwMDAwMDAwMDAwMDE"

Errores

EstadoCódigosCuándo
400CURSOR_INVALIDError con code: CURSOR_INVALID
401sin codeSin x-api-key válida
403sin codeLa llave no tiene el scope wallets:read
429RATE_LIMITEDLimite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`.