1. Abra o site do Gate. Coloque o cursor em cima do ícone do perfil para desplegar o menu e clique em “Gestão de API”.
2. Clique em "Criar Chave API" na página.
3. Criar Chave API
Criar uma Chave APIv2:
① Permissões de IP: Você pode escolher se deseja vincular o IP. Nota: Se optar por não vincular, a Chave API permitirá acesso de qualquer endereço e é válida por 90 dias.
② Tipo de Chave API: Selecione Chave API v2. Cada usuário pode criar apenas 1 conjunto, e o novo substituirá o anterior. Em seguida, você pode defini-la como: “Ler e Escrever” ou “Apenas Ler”.
③ Confirme os detalhes e clique em “Submeter” para enviá-lo.
Nota: A chave API anterior expirará imediatamente quando a nova chave API for gerada.
As chaves API podem ser usadas para consultar informações da conta e também para negociar, retirar fundos, etc.
Por favor, mantenha suas chaves API seguras e nunca as compartilhe com mais ninguém!
Criar uma chave APIv4
①Observações da chave API: Ajuda a identificar e lembrar a chave.
② Permissões de IP: Você pode escolher se deseja vincular o IP. Nota: Se optar por não vincular, a chave API permitirá acesso de qualquer endereço e é válida por 90 dias.
③Tipo de chave API: Selecione a chave API v4.
④Tipo de conta: Escolha Conta Clássica/Negociação de Margem/Testnet.
⑤Permissões: Defina como: “Ler e Escrever” ou “Apenas Ler”. Nota: O par de moedas não pode estar vazio.
⑥Confirme os detalhes e clique em “Enviar” para submetê-lo.
4. Um aviso de risco aparecerá após clicar em "Submeter". Por favor, leia cuidadosamente os avisos de risco e, em seguida, clique em "Aceito" ou "Cancelar" para prosseguir.
Insira a Senha do Fundo, selecione os métodos para a Autenticação 2FA e clique em "Confirmar" para prosseguir.
5. Após criar uma chave API, você pode visualizar, editar ou excluir a chave.
6. Aviso:
① As chaves APIv2/4 têm permissões para retirar e depositar. Para usar a API para retirar, você deve usar o endereço que foi retirado manualmente, e o tempo desde a última retirada manual é superior a 24 horas.
② As diferenças entre APIv2 e APIv4 são as seguintes:
•As chaves APIv2 e APIv4 são independentes entre si.
•As chaves APIv2 são permitidas apenas para realizar negociação à vista, enquanto as chaves APIv4 têm acesso total à negociação à vista, negociação de margem e negociação de contratos.
•Você precisa rolar para baixo até o final da página das suas chaves APIv2 para criar novas chaves APIv2. As chaves APIv4 são criadas em “Centro Pessoal” - “Subconta e API” - “Chaves APIv4”.
Decida entre APIv2 e APIv4 de acordo com as suas próprias necessidades específicas. Consulte este artigo para atualizações sobre as suas funcionalidades.
Se o artigo não puder ajudar com suas perguntas, por favor, nos dê um feedback através de um ticket. Inclua as seguintes informações no ticket:
Seu UID, URL da solicitação original, parâmetros e uma descrição detalhada de sua solicitação, se a chave API é para negociação à vista ou Margem, mainnet ou Testnet, a linguagem de programação (os códigos para enviar a solicitação seriam ótimos), se o SDK é utilizado (se sim, por favor descreva como usá-lo ou comente no GitHub).
7. Os documentos da API podem ser acedidos em "Serviços" - "Desenvolvedores (API)" na parte inferior da página.
8. Regra de limite de frequência.
| 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 |
O limite de taxa é contabilizado contra cada sub-conta ou conta principal.
WebSocket:
• O limite de mensagens enviado ao servidor: ilimitado.
• Número de conexões por IP: ≤ 300
AVISO:
Quando violar repetidamente os limites de taxa, depende de
• o pedido < taxa de explosão, o pedido terá um atraso.
• o pedido > taxa de explosão, o pedido será recusado.
