BINANCE SAPI · CAPITAL

API de Dirección de Depósito

Obtén la dirección de depósito de criptomonedas asociada a una cuenta de Binance, con selección opcional de red para activos compatibles en múltiples redes blockchain.

ENDPOINT

GET /sapi/v1/capital/deposit/address

Autenticación SIGNED

Grupo API Capital

Método GET

Respuesta JSON

Descripción General

Este endpoint devuelve la dirección de depósito actualmente asociada con la criptomoneda seleccionada. Resulta muy útil para aplicaciones que necesitan obtener los datos de depósito de Binance de forma dinámica en lugar de almacenar previamente las direcciones de las billeteras.

Cuando un activo se encuentra disponible en más de una red blockchain, la solicitud puede incluir un identificador de red para seleccionar la ruta de depósito adecuada.

Parámetros de la Solicitud

Parámetros aceptados por el endpoint.

Parámetro	Tipo	Requerido	Descripción
`coin`	STRING	Requerido	Símbolo de la criptomoneda para la cual se solicita la dirección de depósito.
`network`	STRING	Opcional	Red blockchain utilizada para realizar el depósito.
`timestamp`	LONG	Requerido	Marca de tiempo actual de la solicitud en milisegundos.
`recvWindow`	LONG	Opcional	Define el período durante el cual la solicitud firmada sigue siendo válida.

La selección de red es fundamental

Si un activo admite múltiples redes blockchain, asegúrate de que la red seleccionada coincida exactamente con la red que se utilizará para la transacción de depósito.

Ejemplo de Solicitud

Ejemplo de solicitud utilizando cURL.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/capital/deposit/address?coin=USDT&network=TRX&timestamp=YOUR_TIMESTAMP&signature=YOUR_SIGNATURE' \
-H 'X-MBX-APIKEY: YOUR_API_KEY'

Mantén la privacidad de tus credenciales API

Nunca coloques tu clave secreta de API de Binance en código del lado del navegador, repositorios públicos o aplicaciones cliente donde pueda quedar expuesta.

Respuesta

Ejemplo de respuesta devuelta por la API.

RESPONSE 200 OK

{
    "address": "TXXXXXXXXXXXXXXX",
    "tag": "",
    "isDefault": true
}

Campos de la Respuesta

Campo	Tipo	Descripción
`address`	STRING	Dirección de depósito devuelta para el activo y la red solicitados.
`tag`	STRING	Identificador de destino adicional cuando lo requiere el activo o la red seleccionada.
`isDefault`	BOOLEAN	Indica si la dirección devuelta corresponde a la dirección de depósito predeterminada.

Cómo Funciona

Flujo típico para obtener una dirección de depósito en Binance.

01 Seleccionar Activo Elige la criptomoneda.

02 Seleccionar Red Especifica la blockchain cuando sea necesario.

03 Enviar Solicitud Autentica y envía la petición.

04 Recibir Dirección Utiliza los datos de depósito devueltos.

✓

Consejo práctico

No definas direcciones de depósito estáticas en el código si puedes consultarlas mediante la API. Obtener la dirección actual permite que la integración trabaje con la información de depósito específica de cada cuenta y red.

Casos de Uso Comunes

Automatización de Depósitos

Obtén los detalles de depósito como parte de un flujo de trabajo automatizado para depósitos de criptomonedas.

Integración con Billeteras

Muestra el destino de depósito actual de Binance dentro de tu aplicación.

Activos en Múltiples Redes

Selecciona la red blockchain adecuada cuando un activo se encuentra disponible a través de varias redes.