Un caso de uso común es ver la cantidad de wallets integrados con su proyecto. Contamos con varios endpoints que pueden usarse para rastrear y reportar datos detallados como dispositivo, país y más, para que pueda identificar con precisión a sus usuarios.

Reemplace las variables PROJECT_ID y SECRET_API_ACCESS_KEY con el ID de su proyecto y el token secreto de Sequence Builder.

Obtener wallets por intervalo de tiempo para un project ID

Aquí puede pasar un rango de fechas específico junto con el parámetro dateInterval para obtener los wallets dentro de un intervalo de tiempo. Los endpoints pueden usar “DAY”, “WEEK” o “MONTH” como opciones posibles.

curl 'https://api.sequence.build/rpc/Analytics/WalletsDaily' \

  -H 'accept: */*' \

  -H 'authorization: BEARER <SECRET_API_ACCESS_KEY>' \

  -H 'content-type: application/json' \

  --data-raw '{"filter":{"projectId":<PROJECT_ID>,"startDate":"2024-04-23","endDate":"2024-05-23", "dateInterval":"DAY"}}'

Obtener wallets por país

También puede obtener wallets por país para ver desde dónde se conectan sus usuarios.

curl 'https://api.sequence.build/rpc/Analytics/WalletsByCountry' \

  -H 'accept: */*' \

  -H 'authorization: BEARER <SECRET_API_ACCESS_KEY>' \

  -H 'content-type: application/json' \

  --data-raw '{"filter":{"projectId":<PROJECT_ID>,"startDate":"2024-04-23","endDate":"2024-05-23", "dateInterval":"DAY"}}'

Obtener wallets por dispositivo

Adicionalmente, puede consultar por dispositivo para obtener un resumen agregado de desde dónde se están autenticando sus usuarios.

curl 'https://api.sequence.build/rpc/Analytics/WalletsByDevice' \

  -H 'accept: */*' \

  -H 'authorization: BEARER <SECRET_API_ACCESS_KEY>' \

  -H 'content-type: application/json' \

  --data-raw '{"filter":{"projectId":<PROJECT_ID>,"startDate":"2024-04-23","endDate":"2024-05-23", "dateInterval":"DAY"}}'

Obtener transacciones por wallets

Por último, puede obtener la cantidad de transacciones por wallets; estos pueden consultarse como total o por un intervalo de tiempo fijo.

Total

curl 'https://api.sequence.build/rpc/Analytics/WalletsTxnSentTotal' \

  -H 'accept: */*' \

  -H 'authorization: BEARER <SECRET_API_ACCESS_KEY>' \

  -H 'content-type: application/json' \

  --data-raw '{"filter":{"projectId":<PROJECT_ID>,"startDate":"2024-04-23","endDate":"2024-05-23"}}'

Intervalo de tiempo

curl 'https://api.sequence.build/rpc/Analytics/WalletsTxnSentDaily' \

  -H 'accept: */*' \

  -H 'authorization: BEARER <SECRET_API_ACCESS_KEY>' \

  -H 'content-type: application/json' \

  --data-raw '{"filter":{"projectId":<PROJECT_ID>,"startDate":"2024-04-23","endDate":"2024-05-23", "dateInterval":"DAY"}}'

Esquema

Todos los endpoints de analytics de wallet siguen un esquema de solicitud similar

  • Solicitud: POST
  • Content-Type: application/json
  • Cuerpo (en JSON):
    • projectId (uint64) — projectID de su proyecto, puede encontrarlo en la URL del proyecto en Builder.
    • startDate (timestamp) — fecha de inicio de la consulta en formato YYYY—MM—DD
    • endDate (timestamp) — fecha de fin de la consulta en formato YYYY—MM—DD
    • dateInterval (string) — intervalo de fechas para la consulta, opciones: “DAY”, “WEEK” o “MONTH”
  • Respuesta (en JSON):
    • walletStats (walletStats[])
      • value (uint64) — cantidad de wallets que cumplen con la consulta
      • label (string) — etiqueta asociada al endpoint correspondiente