Saltar al contenido
Docs

Referencia

Consultar una wallet

GET/v1/partner/wallets/{publicId}wallets:read

Consulta 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 tiene address asignado.
  • PENDING: el proveedor no confirmó todavía. address será 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

  • 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"

Errores

EstadoCódigosCuándo
401sin codeSin x-api-key válida
403sin codeLa llave no tiene el scope wallets:read
404WALLET_NOT_FOUNDNo existe o no es de este partner
429RATE_LIMITEDLimite de uso: 120 por minuto por credencial. Respeta la cabecera `Retry-After`.