First Ledger NFT
CrearComprobando si has iniciado sesión

El bot de Discord

El bot de First Ledger da a los miembros de tu Discord roles según los NFT y tokens que tienen, publica las ventas de tu colección al momento y gestiona allowlists, encuestas y sorteos, para cualquier colección del XRP Ledger.

Qué hace

Roles de holder: un miembro vincula sus wallets una vez y el bot le da y le quita roles según compra y vende, normalmente segundos después de la venta.

Feeds: ventas, listings, mints y ofertas de tus colecciones, publicados en los canales que elijas.

Herramientas para tu servidor: floor y número de holders en directo en los nombres de canal, snapshots de holders, un registro de auditoría y un panel web para admins.

Comunidad: allowlists, encuestas para holders, sorteos, eventos y alertas personales.

Es gratis: todas las funciones, para todos los servidores y todas las colecciones.

Añadirlo a tu servidor

Abre la página del bot en First Ledger y elige Añadir a Discord. Necesitas el permiso Gestionar servidor en el servidor donde lo añadas.

Después, Discord muestra los seis permisos que pide el bot. Déjalos todos marcados: se usan todos.

  • Gestionar roles da y quita los roles de holder. Sin él, no se asigna ningún rol.
  • Gestionar canales permite que /setup cree el canal #verify y mantiene al día el floor y el número de holders en los nombres de canal.
  • Ver canales permite al bot ver los canales donde publica.
  • Enviar mensajes publica feeds, el panel de verificación, encuestas, sorteos y eventos.
  • Insertar enlaces muestra cada venta y listing como una tarjeta con la imagen y el precio del NFT.
  • Adjuntar archivos permite que /admin snapshot take envíe su lista de holders como archivo CSV.

Nunca pide Administrador, Gestionar servidor ni poder para expulsar o banear a nadie. El rol del bot no necesita nada más que estos seis, así que deja el resto desactivado.

En Ajustes del servidor → Roles, arrastra el rol del bot por encima de todos los roles que quieras que asigne. Discord solo deja que un bot asigne roles por debajo del suyo.

Ejecuta /check-permissions. Cada línea debería tener un tick verde; cada una en rojo indica qué corregir.

Añade tu colección con /admin collection add. Empieza a escribir su nombre y elígela de la lista.

Crea un rol de holder con /admin role set: elige el rol, la colección y, si quieres niveles, un mínimo y un máximo. También puedes exigir un rasgo o que el NFT se haya mantenido cierto número de días.

Publica el panel de verificación con /setup. Crea un canal #verify, o usa el que indiques, con un botón Verificar que pulsan los miembros.

Todo esto también se puede hacer en el panel, donde inicias sesión con Discord y ves los servidores que gestionas.

Roles de holder

Por cantidad: tener al menos un número de NFTs de una colección y, opcionalmente, como máximo otro, para crear niveles como Holder, Collector y Whale.

Por atributo: tener un NFT con un atributo concreto, como Background: Gold.

Por rareza o ranking: tener un NFT dentro del top N de la colección, o ser uno de sus N mayores holders.

Creador: la wallet creadora o emisora de la colección.

Por saldo: tener una cantidad de XRP, de un token emitido en el XRP Ledger (incluidos los lanzados en First Ledger) o de un token multipropósito. Configúralos con /admin role token: elige el rol, qué comprobar y el mínimo, y el bot suma el saldo de todas las wallets vinculadas del miembro.

Por wallet: una lista de direcciones que pegas.

Combinados: cualquiera de estos unidos con AND, OR y NOT, en el editor avanzado del panel; por ejemplo, tener tres o más AND tener cien XRP.

Todas las wallets de la cuenta de First Ledger de un miembro cuentan juntas, así que mover un NFT entre sus propias wallets nunca le hace perder un rol.

Los roles basados en NFTs se actualizan segundos después de una venta. Los basados en saldos se actualizan en la revisión de cada hora, o al momento cuando el miembro usa /refresh.

Roles que solo el XRP Ledger hace posibles

Los NFTs listados siguen contando. En el XRP Ledger, un NFT que pones a la venta sigue en tu wallet hasta que alguien lo compra, así que listar nunca hace perder el rol. Si quieres premiar a los holders que no listan, hay una regla para el porcentaje de sus NFTs listados.

Tiempo de tenencia: un NFT guardado al menos un número de días. Funciona como el staking, sin bloquear nada.

Pases de membresía: un NFT minteado sin el flag de transferible solo puede volver a su creador, así que no se puede vender. Un pase así crea un rol de miembro que no se puede comprar.

Proveedores de liquidez: tener los tokens de liquidez de un pool AMM, como uno del token de tu proyecto. También se configura con /admin role token.

Holders que pagan royalties: cada NFT de la colección se obtuvo por mint o en una venta que pagó el royalty del creador, no regalado.

Feeds y herramientas del servidor

Crea un feed con /admin feed add: elige el canal, qué tipos de actividad publicar (ventas, listados, mints, transferencias, quemas, ofertas), un precio mínimo y un formato completo o compacto. Varias compras de un mismo comprador en el mismo ledger se publican juntas como un sweep.

Los precios se muestran en la moneda de la venta, con su valor en XRP al lado cuando se conoce.

Crea un canal de estadísticas con /admin stat add: un canal cuyo nombre muestra el precio suelo, los holders, los listados, el volumen del día o los miembros con un rol, actualizado cada diez minutos.

Haz una snapshot con /admin snapshot take: todos los holders de una colección en una hoja de cálculo. Con los ids de Discord activados, solo se nombra a miembros de tu servidor.

Consulta cada rol que el bot dio o quitó, y por qué, con /admin audit.

Allowlists, encuestas, sorteos y eventos

/allowlist create publica un botón Unirse. Los miembros que cumplen el requisito se unen con su wallet vinculada; exporta la lista como hoja de cálculo al cerrarla.

/poll create publica una encuesta. Los votos pueden contar uno por miembro o uno por NFT.

/raffle create publica un botón Participar. Los ganadores se eligen a partir del hash de un ledger del XRP Ledger cerrado después de cerrar las inscripciones, y el anuncio lo muestra para que cualquiera pueda comprobar que el sorteo fue justo.

/event create publica un evento al que los miembros pueden apuntarse, opcionalmente solo para holders y con aforo.

Los miembros pueden activar alertas por MD con /alerts: ofertas sobre sus NFTs, un aviso cuando una oferta parece una estafa, ventas en una colección o listings por debajo de un precio.

Para miembros: verificación

Haz clic en Verificar en el servidor o ejecuta /verify. El bot responde con un enlace que solo tú puedes ver.

El enlace abre First Ledger. Inicia sesión con tu wallet como siempre y elige Continuar.

Discord te pide que confirmes tu cuenta. Confírmala y tus roles aparecerán en unos segundos.

¿Has añadido una wallet a tu cuenta de First Ledger desde entonces? Ejecuta /verify de nuevo y luego /refresh.

Nunca completes una verificación que te haya enviado otra persona. Cada enlace pertenece a quien ejecutó el comando y solo funciona para esa persona.

Todos los comandos

Los comandos de administración requieren el permiso Gestionar servidor, y Discord solo se los muestra a quienes lo tienen. La mayoría de las respuestas solo las ves tú; /floor, /collection y /nft se publican en el canal para todos. Empieza a escribir el nombre de una colección en cualquier opción de colección y elígela de la lista: primero salen las colecciones de tu servidor y luego las del marketplace.

Para todos

/verify

Cualquiera

Te envía un enlace, visible solo para ti, para vincular los wallets de tu cuenta de First Ledger. El enlace es solo tuyo y dura diez minutos. Nunca firmas ninguna transacción.

/wallets

Cualquiera

Muestra tus wallets vinculados, cada uno con enlace a su página en First Ledger.

/refresh

Cualquiera

Recarga tus wallets desde First Ledger y revisa tus roles al momento. Úsalo tras añadir un wallet o si un rol por saldo no se ha actualizado.

/roles

Cualquiera

Muestra los roles de holder de este servidor y qué requiere cada uno, marcando los que tienes.

/floor

Cualquiera

Publica el precio mínimo, su variación en el último día y el número en venta, de una colección o de hasta 15 del servidor.

collection
Una colección. Déjalo vacío para todas las del servidor.

/collection

Cualquiera

Publica las estadísticas de una colección: precio mínimo, mejor oferta, en venta, holders, volumen, ventas, royalty y si está verificada.

collectionobligatorio
La colección.

/nft

Cualquiera

Publica la ficha de un NFT: imagen, propietario, rango de rareza, precio si está en venta, royalty, flags y atributos.

idobligatorio
El NFTokenID del NFT, de 64 caracteres.

/portfolio

Cualquiera

Muestra tus NFTs de todos tus wallets vinculados, agrupados por colección.

/alerts add

Cualquiera

Activa una alerta por MD. Si añades el mismo tipo para la misma colección, se sustituye su precio. Mantén abiertos los MD de miembros del servidor o el bot no podrá contactarte.

kindobligatorio
offer_received ofertas sobre tus NFTs, suspicious_offer un aviso cuando una oferta parece una estafa, collection_sale ventas en una colección o listing_below listados por debajo de un precio.
collection
Necesario para alertas de ventas y listados.
price
En XRP: la venta mínima que se te notificará o, para listados, el precio máximo.

/alerts remove

Cualquiera

Desactiva una alerta.

kindobligatorio
offer_received ofertas sobre tus NFTs, suspicious_offer un aviso cuando una oferta parece una estafa, collection_sale ventas en una colección o listing_below listados por debajo de un precio.
collection
Necesario para alertas de ventas y listados.

/alerts list

Cualquiera

Muestra tus alertas.

/privacy allow

Cualquiera

Permite que una app asociada consulte tus wallets vinculados.

partnerobligatorio
El nombre de la app asociada.

/privacy revoke

Cualquiera

Deja de compartir con una app asociada.

partnerobligatorio
El nombre de la app asociada.

/privacy status

Cualquiera

Muestra las apps asociadas con las que compartes.

/unlink

Cualquiera

Elimina tu vínculo y los roles que el bot te asignó en todos los servidores que compartes con él.

/help

Cualquiera

Muestra si estás vinculado y una breve guía de estos comandos.

Configuración

/setup

Gestionar servidor

Publica el panel Verificar, donde los miembros pulsan para vincular sus wallets, y recuerda su canal. Si no indicas canal, crea #verify.

channel
Dónde publicar el panel. Si lo dejas vacío, el bot crea #verify, lo que requiere Gestionar canales.

/check-permissions

Gestionar servidor

Comprueba cada permiso que necesita el bot, cada regla de rol (que el rol siga existiendo y esté por debajo del rol del bot) y cada canal de feed, con un tick o una cruz y qué corregir. Avisa si el bot tiene Administrador, que no necesita.

/admin collection add

Gestionar servidor

Sigue una colección para que su actividad llegue a tus feeds y sus holders a tus roles. Avisa si el marketplace ha marcado la colección.

collectionobligatorio
La colección.

/admin collection remove

Gestionar servidor

Deja de seguir una colección.

collectionobligatorio
La colección.

/admin collection list

Gestionar servidor

Muestra las colecciones que sigue este servidor.

Roles de holder

/admin role set

Gestionar servidor

Da un rol a los miembros que tengan suficientes NFTs de una colección. Volver a configurarlo en el mismo rol sustituye la regla. Los miembros vinculados se revisan al momento.

roleobligatorio
Un rol simple por debajo del rol del bot. El bot rechaza @everyone, los roles gestionados por otra app y cualquier rol con permisos de administración o moderación.
collectionobligatorio
La colección.
min
El mínimo de NFTs que hay que tener, de 1 a 100.000. Por defecto, 1.
max
El máximo, para niveles como Holder, Collector y Whale.
trait
Type:Value, como Background:Gold. Separa varios con | y vale cualquiera.
held-days
Exige además tener un NFT durante al menos estos días, de 1 a 3650.

/admin role token

Gestionar servidor

Da un rol según el saldo, sumado entre las wallets vinculadas de un miembro: XRP, un token emitido en el XRP Ledger, un token multipropósito o los tokens de liquidez de un pool AMM. Los saldos se revisan cada hora o cuando un miembro usa /refresh.

roleobligatorio
Un rol simple por debajo del rol del bot. El bot rechaza @everyone, los roles gestionados por otra app y cualquier rol con permisos de administración o moderación.
kindobligatorio
xrp, token para un token emitido en el XRP Ledger, mpt para un token multipropósito o lp para los tokens de liquidez de un pool AMM.
minobligatorio
El saldo mínimo, mayor que cero.
issuer
Para token: la dirección del emisor.
currency
Para token: su código, como RLUSD.
issuance-id
Para mpt: el id de emisión de 48 caracteres.
pool
Para lp: la dirección de la cuenta del pool AMM.

/admin role set-json

Gestionar servidor

Da un rol según una regla escrita en JSON que combine cualquiera de las condiciones siguientes.

roleobligatorio
Un rol simple por debajo del rol del bot. El bot rechaza @everyone, los roles gestionados por otra app y cualquier rol con permisos de administración o moderación.
ruleobligatorio
La regla, hasta 6000 caracteres.

/admin role remove

Gestionar servidor

Elimina la regla de un rol y quita el rol a los miembros a los que se lo dio el bot.

roleobligatorio
Un rol simple por debajo del rol del bot. El bot rechaza @everyone, los roles gestionados por otra app y cualquier rol con permisos de administración o moderación.

/admin role list

Gestionar servidor

Muestra cada regla de rol en palabras y si está activa.

Feeds y herramientas del servidor

/admin feed add

Gestionar servidor

Publica la actividad en un canal. El bot envía primero un mensaje de prueba para que sepas que puede publicar allí. Añadir un feed a un canal que ya tiene uno lo actualiza.

channelobligatorio
Un canal de texto o de anuncios.
kinds
Separados por comas, entre sale, list, delist, mint, transfer, burn, buy_offer_created, buy_offer_cancelled, offer_expired y uri_modified. Por defecto, sale.
collection
Una colección. Déjalo vacío para todas las del servidor.
min-price
Omite todo lo que esté por debajo de esta cantidad de XRP. La actividad sin precio, como una transferencia, también se omite.
layout
full o compact.

/admin feed layout

Gestionar servidor

Cambia un feed entre el diseño completo y el compacto.

channelobligatorio
El canal.
layoutobligatorio
full o compact.

/admin feed remove

Gestionar servidor

Elimina el feed de un canal.

channelobligatorio
El canal.

/admin feed list

Gestionar servidor

Muestra tus feeds, qué publica cada uno y si está activo.

/admin stat add

Gestionar servidor

Crea un canal de voz bloqueado cuyo nombre muestra un número en directo, como el precio suelo. Se actualiza cuando cambia el número, como mucho cada 10 minutos.

kindobligatorio
floor, holders, volume para el volumen del día, listed o role para el número de miembros con un rol.
collection
Obligatorio para todos los tipos excepto role.
role
Obligatorio para role.
template
El nombre del canal, de 3 a 90 caracteres, con al menos uno de {floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}.

/admin stat remove

Gestionar servidor

Deja de actualizar un canal de estadísticas. El canal se mantiene.

channelobligatorio
El canal.

/admin snapshot take

Gestionar servidor

Te envía todos los holders de una colección en un archivo CSV: dirección, nombre de usuario, cuántos tienen y su porcentaje.

collectionobligatorio
La colección.
min
Solo quienes tengan al menos esta cantidad.
with-discord
Añade una columna con el id de Discord. Solo se nombra a los miembros vinculados de este servidor.

/admin snapshot list

Gestionar servidor

Muestra las snapshots recientes.

/admin audit

Gestionar servidor

Muestra los últimos 25 cambios de roles y reglas, y el motivo de cada uno.

user
Solo los cambios de este miembro.

/admin reconcile

Gestionar servidor

Revisa ahora a todos los miembros vinculados. Los cambios aparecen en /admin audit.

Allowlists, encuestas, sorteos y eventos

/allowlist create

Gestionar servidor

Publica una allowlist con un botón Unirse. Un miembro que cumpla los requisitos se une con su primera wallet vinculada.

nameobligatorio
Su nombre, hasta 60 caracteres, distinto de las demás allowlists del servidor.
max-entries
El máximo de personas que pueden unirse.
closes-in-hours
Cerrar tras estas horas, hasta 2160 (90 días).
eligibility-collection
Solo pueden participar quienes tengan NFTs de esta colección. Déjalo vacío para abrirlo a cualquiera con una wallet vinculada.
eligibility-min
Cuántos deben tener. Por defecto, 1.
rule-json
O cualquier regla en JSON, como en /admin role set-json.

/allowlist close

Gestionar servidor

Cierra una allowlist ahora.

nameobligatorio
Su nombre, hasta 60 caracteres, distinto de las demás allowlists del servidor.

/allowlist export

Gestionar servidor

Te envía las entradas de una allowlist en un archivo CSV.

nameobligatorio
Su nombre, hasta 60 caracteres, distinto de las demás allowlists del servidor.

/allowlist list

Gestionar servidor

Muestra las allowlists del servidor, con sus entradas y cuándo cierran.

/poll create

Gestionar servidor

Publica una encuesta con un botón por opción. Los miembros pueden cambiar su voto hasta que se cierre.

questionobligatorio
Hasta 200 caracteres.
optionsobligatorio
De 2 a 10 opciones separadas por |, cada una de hasta 80 caracteres.
duration-hoursobligatorio
Cuánto dura, en horas, hasta 2160 (90 días).
weighting
member: un voto o participación por persona; nft: uno por cada NFT que tenga.
weight-collection
Qué colección contar, para nft.
eligibility-collection
Solo pueden participar quienes tengan NFTs de esta colección. Déjalo vacío para abrirlo a cualquiera con una wallet vinculada.
eligibility-min
Cuántos deben tener. Por defecto, 1.

/poll close

Gestionar servidor

Cierra una encuesta ahora y publica los resultados.

idobligatorio
El id que aparece al pie de la publicación.

/raffle create

Gestionar servidor

Publica un sorteo con un botón Participar.

prizeobligatorio
Hasta 200 caracteres.
winnersobligatorio
De 1 a 100.
duration-hoursobligatorio
Cuánto dura, en horas, hasta 2160 (90 días).
weighting
member: un voto o participación por persona; nft: uno por cada NFT que tenga.
weight-collection
Qué colección contar, para nft.
eligibility-collection
Solo pueden participar quienes tengan NFTs de esta colección. Déjalo vacío para abrirlo a cualquiera con una wallet vinculada.
eligibility-min
Cuántos deben tener. Por defecto, 1.

/raffle draw

Gestionar servidor

Cierra las inscripciones y elige a los ganadores ahora. El sorteo usa como semilla el hash de un ledger validado, que aparece en el anuncio, así que cualquiera puede recalcularlo.

idobligatorio
El id que aparece al pie de la publicación.

/event create

Gestionar servidor

Publica un evento al que los miembros pueden apuntarse hasta que empiece o se llene.

titleobligatorio
Hasta 100 caracteres.
startsobligatorio
Horas a partir de ahora, como 48, o una fecha y hora con zona horaria, como 2026-12-01T18:00Z. Dentro de 90 días.
description
Hasta 1000 caracteres.
location
Hasta 200 caracteres.
capacity
Máximo de personas que pueden confirmar asistencia.
eligibility-collection
Solo pueden participar quienes tengan NFTs de esta colección. Déjalo vacío para abrirlo a cualquiera con una wallet vinculada.
eligibility-min
Cuántos deben tener. Por defecto, 1.

/event cancel

Gestionar servidor

Cancela un evento y actualiza su publicación.

idobligatorio
El id que aparece al pie de la publicación.

/event attendees

Gestionar servidor

Muestra quién asiste.

idobligatorio
El id que aparece al pie de la publicación.

Avanzado: reglas en JSON

/admin role set-json acepta una regla escrita en JSON, para todo lo que /admin role set y /admin role token no pueden crear. El editor avanzado del panel escribe las mismas reglas por ti.

Combina condiciones con and o or, cada uno con entre 1 y 20 reglas, e invierte una con not. Una regla puede anidarse hasta 6 niveles y contener hasta 30 condiciones.

Cada condición se comprueba en todas las wallets vinculadas de un miembro a la vez, y es falsa para quien no tenga ninguna wallet vinculada. Si el bot no puede comprobar una condición, por ejemplo cuando no se puede acceder al ledger, el miembro conserva los roles que tiene.

Las condiciones, según su tipo JSON. Las colecciones se indican por su slug del marketplace.

  • holds con collection, min y un max opcional: tiene esa cantidad de NFTs de la colección.
  • holds_trait con collection, traits (de 1 a 12, cada uno escrito Type:Value) y min: tiene esa cantidad de NFTs con cualquiera de los atributos.
  • holds_any_verified con min: tiene esa cantidad de NFTs de colecciones verificadas, sean cuales sean.
  • holds_non_transferable con collection y min: tiene esa cantidad de NFTs soulbound de la colección, los que no se pueden vender.
  • held_for con collection, days (de 1 a 3650) y min: ha tenido esa cantidad durante al menos esos días.
  • rarity_rank con collection y max_rank: tiene un NFT con ese rango de rareza o superior.
  • listed_ratio con collection y max, una fracción de cero a uno: no ha listado más de esa proporción de sus NFTs. Falso si no tiene ninguno.
  • top_holders con collection y n (de 1 a 1000): está entre los mayores holders de la colección.
  • is_creator con collection: uno de sus wallets creó o emitió la colección.
  • royalty_compliant con collection: todos los NFTs que tiene de ella se mintearon o compraron en una venta que pagó la royalty.
  • xrp_balance con min: tiene al menos esa cantidad de XRP.
  • token_balance con issuer, currency (un código como RLUSD, o su forma hex de 40 caracteres) y min: tiene al menos esa cantidad del token.
  • mpt_balance con issuance_id (48 caracteres hex) y min: tiene al menos esa cantidad del token multipropósito.
  • amm_lp_balance con amm_account y min: tiene al menos esa cantidad de tokens de liquidez del pool.
  • wallet_in con addresses (de 1 a 10.000): uno de sus wallets está en la lista.

Límites

  • 25 colecciones seguidas por servidor.
  • 50 reglas de rol por servidor, una por rol.
  • 20 feeds por servidor, uno por canal.
  • 10 canales de estadísticas por servidor, renombrados como mucho cada 10 minutos.
  • Una instantánea de holders por servidor cada 10 minutos, de hasta unos 100.000 holders.
  • 25 alertas por miembro y como mucho 30 mensajes de alerta por hora.
  • Las encuestas admiten de 2 a 10 opciones; los sorteos eligen de 1 a 100 ganadores; las allowlists, encuestas, sorteos y eventos pueden durar hasta 90 días.
  • Cada miembro puede usar el bot 20 veces por minuto. Si se pasa, le pedirá que vaya más despacio.

Privacidad y seguridad

Al verificar, el bot recibe las direcciones de los wallets de tu cuenta de First Ledger. Nunca ve ninguna clave y nunca se te pedirá que firmes una transacción. Si alguien te lo pide, no es este bot.

El bot solo pide los permisos que usa y nunca el de Administrador. Se niega a asignar roles con permisos de moderación o administración.

Solo quita los roles que él asignó. Si un moderador te dio un rol manualmente, se mantiene.

Otras apps solo pueden ver tus wallets vinculados si las autorizas por nombre con /privacy allow, y puedes revocarlo cuando quieras.

/unlink elimina tu vínculo y quita los roles que el bot te asignó en todos los servidores.

Solución de problemas

No tienes rol tras verificar: ejecuta /refresh. Si sigue sin aparecer, pide a un admin que ejecute /check-permissions; probablemente el rol del bot está por debajo del rol de holder.

El enlace dice que ha caducado: cada enlace dura diez minutos y solo funciona una vez. Vuelve a ejecutar /verify.

«Otra cuenta de Discord»: confirmaste con una cuenta de Discord distinta a la que ejecutó el comando. Cambia de cuenta en Discord y vuelve a ejecutar /verify.

Un feed ha dejado de publicar: ejecuta /admin feed list. Si el bot ya no podía publicar en un feed, se desactiva, y /admin audit indica el motivo.

Un rol por saldo no ha cambiado: se actualizan en la revisión de cada hora. Ejecuta /refresh para comprobarlo ahora.