1. Abra el sitio web Gate. Coloque el cursor encima del ícono de perfil para desplegar el menú y haga clic en "Administración de API".
2. Haga clic en "Crear clave API" en la página.
3. Crear clave API
Cree una clave APIv2:
① Permisos de IP: puede elegir si desea vincular la IP.
Nota: Si opta por no vincularse, la clave API permitirá el acceso desde cualquier dirección y será válida por 90 días.
② Tipo de clave API: seleccione Clave API v2. Cada usuario solo puede crear 1 conjunto y el nuevo sobrescribirá el anterior. Luego puede configurarlo para que sea: "Lectura y escritura" o "Sólo lectura".
③ Confirme los detalles y haga clic en "Enviar" para enviarlo.
Nota: La clave API anterior caducará inmediatamente cuando se genere la nueva clave API.
Las claves API se pueden utilizar para consultar información de la cuenta y también para operar, retirar fondos, etc.
Mantenga sus claves API seguras y nunca las comparta con nadie más.
Cree una clave APIv4:
① Observaciones de la clave API: ayuda a identificar y recordar la clave.
② Permisos de IP: puede elegir si desea vincular la IP.
Nota: Si no se vincula, la clave será válida por 90 días.
③ Tipo de clave API: seleccione Clave API v4.
④ Tipo de cuenta: elija Cuenta clásica / MarginTrading / Testnet.
⑤ Permisos: configúrelo como “Leer y escribir” o “Solo lectura”.
Nota: El par de divisas no puede estar vacío.
⑥ Confirme los detalles y haga clic en "Enviar" para crear la clave.
4. Aparecerá un recordatorio de riesgo después de hacer clic en "Enviar".
Lea atentamente las advertencias de riesgo y luego haga clic en "Acepto" o "Cancelar" para continuar.
Ingrese la contraseña del fondo, seleccione los métodos de autenticación 2FA y haga clic en "Confirmar" para continuar.
5. Después de crear una clave API, puede ver, editar o eliminar la clave.
6. Aviso:
① Las claves APIv2/4 tienen permisos para retirar y depositar.
Para utilizar la API para retirar, debe utilizar la dirección que se ha retirado manualmente y el tiempo desde el último retiro manual debe ser superior a 24 horas.
② Las diferencias entre APIv2 y APIv4 son las siguientes:
• Las claves APIv2 y las claves APIv4 son independientes entre sí.
• Las claves APIv2 solo pueden realizar operaciones al contado, mientras que las claves APIv4 tienen acceso completo a operaciones al contado, con margen y contratos.
• Para crear claves APIv2, desplácese hasta la parte inferior de la página "Claves APIv2".
• Las claves APIv4 se crean en "Centro personal" - "Subcuenta y API" - "Claves APIv4".
Decida entre APIv2 y APIv4 según sus necesidades específicas. Consulte este artículo para obtener actualizaciones sobre sus funciones.
Si el artículo no resuelve sus dudas, contáctenos a través de un ticket.
Por favor incluya la siguiente información:
- Su UID
- URL de la solicitud original
- Parámetros y descripción detallada
- Tipo de API (spot / margin / testnet / mainnet)
- Lenguaje de programación (con código de ejemplo si es posible)
- Si usa SDK, describa cómo lo implementa o deje un comentario en GitHub.
7. Se puede acceder a los documentos API en "Servicios" - "Desarrolladores (API)" en la parte inferior de la página.
8. Regla de límite de frecuencia
| Markets | Endpoints | Limits | Based On | Include |
|---|---|---|---|---|
| All public endpoints | Public endpoints | 200r/10s per endpoint | IP | Orderbook, Candlestick, Ticker, etc. |
| Wallet | Private endpoints | Withdrawal(POST /withdrawals) : 1r/3s UID transfer(POST /withdrawals/push) 1r/10s Transfer between trading accounts (POST /wallet/transfers) 80r/10s Transfer between main and sub accounts (POST /wallet/sub_account_transfers) 80r/10s Transfer from a sub-account to another sub-account (POST /wallet/sub_account_to_sub_account) 80r/10s Retrieve user's total balances (GET /wallet/total_balance) 80r/10s Retrieve sub account balances (GET /wallet/sub_account_balances) 80r/10s Query sub accounts' margin balances (GET /wallet/sub_account_margin_balances) 80r/10s Query sub accounts' futures account balances (GET /wallet/sub_account_futures_balances) 80r/10s Query subaccount's cross_margin account info(GET /wallet/sub_account_cross_margin_balances) 80r/10s The Others: 200r/10s per endpoint |
UID | Withdrawal. Query personal account balance. Query subaccount balance. |
| Spot | Private endpoints | The rate limit for batch/single order placement and amend an order are total of 10r/s (UID+Market) The rate limit for batch/single order cancellation is total of 200r/s The Others: 200r/10s per endpoint |
UID | Spot order placement and cancellation. Trade history and fee rates. |
| Perpetual Futures | Private endpoints | The rate limit for batch/single order placement and amend an order are total of 100r/s The maximum rate limit for the order cancellation (bulk/single) is 200r/s The Others: 200r/10s per endpoint |
UID | Futures order placement and cancellation Trade history and fee rates |
| Delivery | Private endpoints | The maximum rate limit for the order placement (bulk/single) is 500r/10s The maximum rate limit for the order cancellation (bulk/single) is 500r/10s The Others: 200r/10s per endpoint |
UID | Order placement and cancellation |
| Options | Private endpoints | The maximum rate limit for the order placement (bulk/single) is 200r/s The maximum rate limit for the order cancellation (bulk/single) is 200r/s The Others: 200r/10s per endpoint |
UID | Order placement and cancellation |
| Subaccount | Private endpoints | 80r/10s per endpoint | UID | Create a sub-account. Retrieve the list of sub-accounts. Disable or enable API key for a sub-account. |
| Unified | Private endpoints | Borrow or repay 15/10s | UID | Borrow or repay(POST /unified/loans) |
| Other Private endpoints | Private endpoints | 150r/10s per endpoint | UID | Earning, collateral etc |
El límite de tasa se cuenta contra cada subcuenta o cuenta principal.
WebSocket:
• Límite de mensajes enviados al servidor: ilimitado
• Número de conexiones por IP: ≤ 300
AVISO:
Cuando se violan repetidamente los límites de tarifas:
• Si la solicitud < tasa de ráfaga, se aplicará un retraso
• Si la solicitud > tasa de ráfaga, se rechazará
