Litbit API

Qué es Litbit

Litbit es un libro contable de BitBook Lite que se utiliza para dar seguimiento a los balances y movimientos de las monedas internas de la plataforma.
Litbit es el registro que mantiene el seguimiento de tokens como LTB, BBLUSD y BBLBTC.
LTB (Litbit) es el token principal, y lleva el mismo nombre que el libro contable, pero no deben confundirse.
Más información sobre Litbit

Qué permite hacer la Litbit API

Realizar transferencias de cualquier token interno de BitBook Lite.
Consultar el balance de cualquier token interno de BitBook Lite.
Obtener la lista de movimientos de cualquier token interno de BitBook Lite.

Puntos clave

Para acceder a la API necesitas tus credenciales de acceso (usuario y contraseña) que encontrarás aquí.
LTB es el token principal de BitBook Lite y lleva el mismo nombre que el libro contable (Litbit), pero no debes confundirlos.

Métodos y ejemplos

Los ejemplos están escritos en sentencias CURL. Puedes convertir las sentencias CURL a PHP usando esta página web. Para otros lenguajes de programación deberás utilizar una librería CURL correspondiente.

litbit_get_movements

Obtener una lista de tus movimientos.

Ejemplo

curl https://bitbooklite.com/api/v2/?apiUser=00000-AAAAA-00000-AAAAA-00000&apiPassword=000000-AAAAAA-000000-AAAAAA-000000
        -d 'api_consult_type=litbit_get_movements'
        -d 'operation_data={"currency":"LTB","limit":10}'

Endpoint

https://bitbooklite.com/api/v2/

GET parameters

apiUser (obligatorio - string): Usuario de tu credencial de acceso API.
apiPassword (obligatorio - string): Contraseña de tu credencial de acceso API.

POST parameters

api_consult_type (obligatorio - string): Método de la API, en este caso, "litbit_get_movements".
operation_data (obligatorio - json encoded array):
- currency (obligatorio - string): Sigla de la moneda.
- limit (obligatorio - integer): Limite de movimientos a obtener (máximo 500).
- limitStart (opcional - integer): Inicio del límite, útil para paginación de resultados. DEFAULT = 0
- orderMode (opcional - string): Modo de ordenar los resultados según su fecha de creación, ascendente o descendente. Valores admitidos: ["ASC", "DESC"]. DEFAULT = "DESC"

Valores devueltos

JSON


            {
                "error":false,
                "errores":[],
                "answer":{
                    "movements":[
                        {
                            "amount":10.56,
                            "amount_action":0,
                            "amount_formated":"-10.56",
                            "code":100,
                            "code_description":"Transferencia saliente",
                            "currency":"LTB",
                            "date":"2023-05-15 21:20:31",
                            "date_formated":"16/05/2023 00:20:31 GMT+0",
                            "id":170,
                            "other_user_id":59,
                            "total_balance":562.2332,
                            "total_balance_formated":"562,23",
                            "user_id":14,
                        }
                    ]
                }
            }

error (obligatorio - boolean): "true" en caso de error.
errores (obligatorio - array): Conjunto de strings con los errores producidos, si existen.
answer (obligatorio - array): respuesta del servidor.
- movements (obligatorio - array): lista de movimientos.
  - amount (obligatorio - float): monto del movimiento.
  - amount_action (obligatorio - integer): 0 si el movimiento es negativo y 1 si es positivo.
  - code_description (obligatorio - string): descripción del movimiento.
  - currency (obligatorio - string): moneda del movimiento.
  - id (obligatorio - integer): ID del movimiento.
  - user_id (obligatorio - integer): ID del usuario que realizó el movimiento.
  - total_balance (obligatorio - float): nuevo balance del usuario después del movimiento.
  - other_user_id (obligatorio - integer): ID de un usuario relacionado con el movimiento. En el caso de una transferencia, será el emisor o receptor de la misma. Puede ser 0.
  - ...

litbit_create_transfer

Enviar una transferencia.

Ejemplo

curl https://bitbooklite.com/api/v2/?apiUser=00000-AAAAA-00000-AAAAA-00000&apiPassword=000000-AAAAAA-000000-AAAAAA-000000
        -d 'api_credentials_tat=7c0df7889f9930e684a17d76d2488681a1873968c64e04b683b671bfc3bbae44'
        -d 'api_consult_type=litbit_create_transfer'
        -d 'operation_data={"currency":"LTB","amount":10.43,"receiver_user_id":14,"receiver_user_id_type":"id"}'

Endpoint

https://bitbooklite.com/api/v2/

GET parameters

apiUser (obligatorio - string): Usuario de tu credencial de acceso API.
apiPassword (obligatorio - string): Contraseña de tu credencial de acceso API.

POST parameters

api_credentials_tat (obligatorio - string): credencial de acceso TAT actual. Debes generarlo siguiendo estas instrucciones.
api_consult_type (obligatorio - string): Método de la API, en este caso, "litbit_create_transfer".
operation_data (obligatorio - json encoded array):
- currency (obligatorio - string): Sigla de la moneda a transferir.
- amount (obligatorio - float): Monto a transferir. Se redondea a 6 decimales.
- receiver_user_id (obligatorio - string): ID del usuario receptor.
- receiver_user_id_type (obligatorio - string): Tipo de ID del usuario receptor. Debe ser una de estas opciones: ["id", "id_stringed", "mini_id"].

Valores devueltos

JSON


            {
                "error":false,
                "errores":[],
                "answer":{
                    "amount":10.43,
                    "currency":"LTB",
                    "receiver_movement_id":173,
                    "sender_movement_id":172,
                }
            }

error (obligatorio - boolean): "true" en caso de error.
errores (obligatorio - array): Conjunto de strings con los errores producidos, si existen.
answer (obligatorio - array): respuesta del servidor.
- amount (obligatorio - float as string): monto transferido.
- currency (obligatorio - string): sigla de la moneda transferida.
- receiver_movement_id (obligatorio - integer): ID del movimiento para el receptor.
- sender_movement_id (obligatorio - integer): ID del movimiento para el emisor (tú).

litbit_get_balance

Obtener tu balance.

Ejemplo

curl https://bitbooklite.com/api/v2/?apiUser=00000-AAAAA-00000-AAAAA-00000&apiPassword=000000-AAAAAA-000000-AAAAAA-000000
        -d 'api_consult_type=litbit_get_balance'
        -d 'operation_data={"currency":"LTB"}'

Endpoint

https://bitbooklite.com/api/v2/

GET parameters

apiUser (obligatorio - string): Usuario de tu credencial de acceso API.
apiPassword (obligatorio - string): Contraseña de tu credencial de acceso API.

POST parameters

api_consult_type (obligatorio - string): Método de la API, en este caso, "litbit_get_balance".
operation_data (obligatorio - json encoded array):
- currency (obligatorio - string): Sigla de la moneda sobre la que deseas obtener tu balance.
- use_freeze_system (opcional - integer) Si se establece en 1, se utilizará el Freeze System para obtener el balance. Activar este parámetro asegurará la fiabilidad del balance retornado a la máxima precisión, pero provocará que no se puedan realizar otras operaciones Litbit sobre tu usuario durante algunos milisegundos. Recomendamos activar este parámetro únicamente cuando se vaya a tomar una desición en base al balance.

Valores devueltos

JSON


            {
                "error":false,
                "errores":[],
                "answer":{
                    "balance":105.43,
                }
            }

error (obligatorio - boolean): "true" en caso de error.
errores (obligatorio - array): Conjunto de strings con los errores producidos, si existen.
answer (obligatorio - array): respuesta del servidor.
- balance (obligatorio - float): tu balance.

litbit_withdraw_bblusd

Solicitar un retiro de BBLUSD a tu método de retiro configurado.

Ejemplo

curl https://bitbooklite.com/api/v2/?apiUser=00000-AAAAA-00000-AAAAA-00000&apiPassword=000000-AAAAAA-000000-AAAAAA-000000
        -d 'api_credentials_tat=7c0df7889f9930e684a17d76d2488681a1873968c64e04b683b671bfc3bbae44'
        -d 'api_consult_type=litbit_withdraw_bblusd'
        -d 'operation_data={"amount":10.43}'

Endpoint

https://bitbooklite.com/api/v2/

GET parameters

apiUser (obligatorio - string): Usuario de tu credencial de acceso API.
apiPassword (obligatorio - string): Contraseña de tu credencial de acceso API.

POST parameters

api_credentials_tat (obligatorio - string): credencial de acceso TAT actual. Debes generarlo siguiendo estas instrucciones.
api_consult_type (obligatorio - string): Método de la API, en este caso, "litbit_withdraw_bblusd".
operation_data (obligatorio - json encoded array):
- amount (obligatorio - float): Monto a retirar. Será redondeado a 2 decimales.

Valores devueltos

JSON


            {
                "error":false,
                "errores":[],
                "answer":{
                    "withdraw_id":1850,
                    "amount":10.43,
                    "currency":"BBLUSD"
                }
            }

error (obligatorio - boolean): "true" en caso de error.
errores (obligatorio - array): Conjunto de strings con los errores producidos, si existen.
answer (obligatorio - array): respuesta del servidor.
- withdraw_id (obligatorio - integer): ID del retiro.
- amount (obligatorio - float): monto retirado.
- currency (obligatorio - string): sigla de la moneda retirada.

(obsoleto) litbit_withdraw_ppusd

Solicitar un retiro de PPUSD a tu cuenta de PayPal.

⚠️ Obsoleto: este método corresponde a una función de BitBook Lite que ya no existe. Se deja aquí solo a modo de referencia.

Ejemplo

curl https://bitbooklite.com/api/v2/?apiUser=00000-AAAAA-00000-AAAAA-00000&apiPassword=000000-AAAAAA-000000-AAAAAA-000000
        -d 'api_credentials_tat=7c0df7889f9930e684a17d76d2488681a1873968c64e04b683b671bfc3bbae44'
        -d 'api_consult_type=litbit_withdraw_ppusd'
        -d 'operation_data={"amount":10.43}'

Endpoint

https://bitbooklite.com/api/v2/

GET parameters

apiUser (obligatorio - string): Usuario de tu credencial de acceso API.
apiPassword (obligatorio - string): Contraseña de tu credencial de acceso API.

POST parameters

api_credentials_tat (obligatorio - string): credencial de acceso TAT actual. Debes generarlo siguiendo estas instrucciones.
api_consult_type (obligatorio - string): Método de la API, en este caso, "litbit_withdraw_ppusd".
operation_data (obligatorio - json encoded array):
- amount (obligatorio - float): Monto a retirar. Será redondeado a 2 decimales.

Valores devueltos

JSON


            {
                "error":false,
                "errores":[],
                "answer":{
                    "withdraw_id":1853,
                    "amount":10.43,
                    "currency":"PPUSD"
                }
            }

error (obligatorio - boolean): "true" en caso de error.
errores (obligatorio - array): Conjunto de strings con los errores producidos, si existen.
answer (obligatorio - array): respuesta del servidor.
- withdraw_id (obligatorio - integer): ID del retiro.
- amount (obligatorio - float): monto retirado.
- currency (obligatorio - string): sigla de la moneda retirada.

Volver atrás

Nuevo post

Categorías del post

Qué es Litbit

Qué permite hacer la Litbit API

Puntos clave

Métodos y ejemplos

litbit_get_movements

Ejemplo

Endpoint

GET parameters

POST parameters

Valores devueltos

litbit_create_transfer

Ejemplo

Endpoint

GET parameters

POST parameters

Valores devueltos

litbit_get_balance

Ejemplo

Endpoint

GET parameters

POST parameters

Valores devueltos

litbit_withdraw_bblusd

Ejemplo

Endpoint

GET parameters

POST parameters

Valores devueltos

(obsoleto) litbit_withdraw_ppusd

Ejemplo

Endpoint

GET parameters

POST parameters

Valores devueltos