Picnic agents is in early access — read-only access only for now.
PT
Docs
Ferramentas
get_profile

get_profile

Obtém o identificador da conta do utilizador autenticado, KYC dos on/off-ramps por moeda fiat, produtos de cartão e a configuração de segurança Picnic. Dados pessoais sensíveis (nome, taxId, data de nascimento, fotografia, morada, telefone, material criptográfico bruto da passkey) são intencionalmente omitidos.

Âmbito necessário: read:profile

Parâmetros: nenhum.

Campos devolvidos:

CampoTipoDescrição
userIdstringID interno do utilizador Picnic.
emailstring | nullEmail da conta.
ramps.<moeda>arrayLista de entradas de KYC do utilizador para esse on/off-ramp fiat (ex.: ramps.brl, ramps.eur). A chave da moeda só aparece se o utilizador fez onboarding em pelo menos um provider — um ramps: {} vazio significa nenhum onboarding fiat. Vários providers podem servir a mesma moeda (ex.: BRLA e Avenia para BRL).
ramps.<moeda>[].providerstringProvider subjacente — brla, avenia, monerium.
ramps.<moeda>[].statusstringEstado de KYC normalizado — um de none, pending, approved, rejected.
ramps.<moeda>[].levelnumberNível bruto de KYC do provider (BRLA, Avenia). Presente quando o provider expõe um nível numérico.
ramps.<moeda>[].statestringEstado bruto do perfil Monerium — um de created, pending, approved, rejected, blocked.
cardsarrayLista de produtos de cartão do utilizador. [] vazio se não tiver nenhum.
cards[].providerstringProvider do cartão — atualmente sempre gnosisPay.
cards[].statusstringEstado normalizado — um de none, pending, approved, rejected.
cards[].rawstringEstado bruto do provider. Para o Gnosis Pay, um de: notStarted, documentsRequested, pending, processing, resubmissionRequested, requiresAction, approved, rejected, temporaryRejected, error.
security.levelnumberTier de segurança Picnic — 1 (apenas EOA) ou 2 (passkey + recovery). O agents-server só admite utilizadores L2, por isso é efetivamente sempre 2.
security.activebooleanSe a configuração de segurança está ativa.
security.setup.signerstringTipo de signer — tipicamente passkey.
security.setup.recoverystringMétodo de recuperação — tipicamente magic.
security.activePasskey.signerAddressstringEndereço EOA derivado da passkey ativa, útil para cruzar com o signer em get_smart_accounts.

Os subcampos de security são igualmente omitidos quando não configurados.

Exemplo de resposta:

{
  "userId": "...",
  "email": "user@example.com",
  "ramps": {
    "brl": [
      { "provider": "brla", "status": "approved", "level": 2 },
      { "provider": "avenia", "status": "pending", "level": 1 }
    ],
    "eur": [
      { "provider": "monerium", "status": "approved", "state": "approved" }
    ]
  },
  "cards": [
    { "provider": "gnosisPay", "status": "approved", "raw": "approved" }
  ],
  "security": { "level": 2, "active": true, "setup": { "signer": "passkey", "recovery": "magic" }, "activePasskey": { "signerAddress": "0x..." } }
}

Exemplo de pergunta:

"Qual é o email da minha conta Picnic, tier de segurança e em que ramps fiat estou com KYC?"