AI Wars: Guia do Participante

Bem-vindo à Arena: The Path to Alpha Awakening

AI Wars: WEEX Alpha Awakens – Hackathon Global de Trading com IA!

Neste confronto decisivo, os melhores programadores, quants e traders de todo o mundo vão libertar os seus algoritmos em batalhas no mercado real, competindo por um dos maiores pools de prémios da história do trading de cripto com IA: 880 000 USD, incluindo um Bentley Bentayga S para o campeão.

Este guia orienta em todos os passos necessários, desde a inscrição até ao início oficial da competição.

Siga o caminho e comece a sua viagem:

Inscreva-se e forme a sua equipa → Passe nos testes de API → Ajuste o modelo → Início oficial

Passo 1. Inscreva-se, crie e submeta o seu BUIDL para obter a sua chave de API

Objetivo: Conclua a sua inscrição oficial, crie ou junte-se a uma equipa (BUIDL) e, após aprovação na análise, receba a sua chave de API dedicada.

Resultado: Serão atribuídas credenciais de API exclusivas para ligar o seu sistema à WEEX — marcando o seu primeiro passo na competição.

1.1 Visite a página do evento AI Wars: WEEX Alpha Awakens

1. Visite a página do evento: https://www.weex.com/pt-pt/events/ai-trading
2. Encontre obotão "Submeter BUIDL" e clique.

1.2 Encontre uma equipa ou crie a sua

Um BUIDL é a unidade básica de participação nesta competição e representa uma equipa.

Os BUIDLs existentes representam equipas que já foram criadas. Pode juntar-se a uma destas BUIDLs ou criar a sua própria equipa do zero.

Se optar por submeter o seu próprio BUIDL, as informações devem incluir:

• Perfil: Nome do BUIDL, logótipo, visão, categoria, GitHub (opcional) e links para redes sociais
• Detalhes: Uma breve introdução ao seu BUIDL
• Equipa: Informações sobre a equipa. Também pode convidar ou recrutar membros da equipa para esta secção.
• Contacto: Nome de utilizador do Telegram e dados de contacto alternativos
• Submissão:
  • UID da WEEX (KYC necessário)
  • Endereço IP (este IP será adicionado à lista de permissões da WEEX OpenAPI para permitir chamadas de API bem-sucedidas)
  • Linguagens de programação preferidas
  • Experiência com grandes modelos de linguagem (LLM), trading assistido por IA, bots de trading automatizados ou API de outras exchanges
  • Número de ordens que a sua estratégia irá colocar por dia

Dica: A participação individual é permitida, mas recomendamos uma equipa multifuncional de 2 a 5 membros (programador + investigador quant + trader).

Dica rápida de submissão 1: Como concluir o KYC e encontrar o seu WEEX UID

Para se inscrever no Hackathon Global de Trading com IA da WEEX, será necessário fornecer o WEEX UID com KYC verificado. Veja como encontrá-lo:

1. Registe a sua conta

Clique no link para visitar o website oficial da WEEX. Selecione “Registar-se“ no canto superior direito e, em seguida, registe-se utilizando o seu e-mail ou número de telemóvel.

Nota: Se já tem uma conta, clique em “Iniciar sessão“ no canto superior direito para aceder ao seu painel de controlo.

2. Conclua a verificação de identidade

Clique no ícone do avatar no canto superior direito e selecione “Verificação“ para concluir o seu KYC.

Nota: O KYC é obrigatório — as submissões sem KYC não podem ser aprovadas.

3. Encontre o seu UID

Clique novamente no ícone do avatar e verá o seu UID exibido logo abaixo do seu e-mail.

Dica rápida de submissão 2: Como encontrar o seu endereço IP

Parte 1: Método recomendado (servidores na nuvem)

Para maior estabilidade, recomenda-se vivamente a utilização de um servidor na nuvem com IP público estático e suporte para funcionamento ininterrupto 24/7, como por exemplo: AWS (Amazon Web Services), Alibaba Cloud e Tencent Cloud.

Parte 2: Método alternativo (computador local)

Se optar por executar o seu bot de trading a partir de um computador pessoal ou rede doméstica, deve confirmar que o seu endereço IP de saída é estático. Alterações no IP resultarão em problemas de conectividade.

Tem duas opções principais para garantir um IP de saída estável:

1. Use um IP estático fornecido pelo seu fornecedor de serviços de Internet (ISP).

2. Utilize um serviço de VPN ou proxy com um IP de saída fixo (e certifique-se de que a VPN/proxy se mantém sempre ativa, sem trocar de servidor).

Passos para encontrar o seu IP público local:

• Desative todas as VPN ou mantenha apenas a VPN cujo IP pretende colocar na lista de permissões.
• Visite whatismyip.com no seu navegador.
• A página mostrará o seu endereço IPv4 público.
• Copie este IP e submeta-o à lista de permissões.

Nota: A maioria dos endereços IPv4 de banda larga doméstica são dinâmicos e podem mudar periodicamente. É altamente recomendável usar um ambiente de servidor na nuvem para evitar falhas de conexão durante a competição.

1.3 Informações em falta? Entraremos em contacto

Após submeter o seu BUIDL, a equipa WEEX irá analisar a sua candidatura com base nos requisitos da competição. O processo de análise normalmente leva um dia útil.

Se alguma informação estiver em falta ou precisar de esclarecimento, a nossa equipa entrará em contacto consigo através de um dos seguintes canais:

• Sistema de mensagens DoraHacks
• Sistema oficial de mensagens WEEX
• As suas informações de contacto registadas (Telegram, X, etc.)

Mantenha os seus dados de contacto ativos e acessíveis.

Após a aprovação do seu BUIDL, será atribuída a sua conta da competição e a chave de API exclusiva, permitindo avançar para a fase seguinte: Testes de API e integração de modelos.

1.4 O seu kit inicial

Após o seu BUIDL passar na análise, a WEEX criará uma conta de competição dedicada e fornecerá as credenciais de API e as informações de teste necessárias para a fase seguinte. Estes dados serão enviados através do sistema de mensagens da DoraHacks e dos e-mails oficiais da WEEX Labs.

Receberá:

• Chave de API: O identificador da sua conta de competição e um parâmetro obrigatório para todos os pedidos de API.
• Chave secreta: Chave gerada pelo sistema utilizada para assinatura de pedidos e verificação de segurança.
• Frase-passe: Necessária para realizar operações de API.
• Link para a página de testes de API: Um miniambiente de testes onde é possível consultar os requisitos, as especificações e os critérios de conclusão dos testes de API.

Com isto, a sua inscrição fica concluída e está tudo pronto para os testes de API.

Passo 2. Passe o gateway: Conclua os seus testes de API

Objetivo: Certifique-se de que o seu sistema consegue interagir com sucesso com a API da WEEX e executar as operações de teste exigidas.

Resultado: Irá garantir a qualificação oficial de participação, receber fundos iniciais para testes de depuração e obter uma compreensão clara de todos os requisitos prévios à competição.

2.1 Instruções

• Conclua todas as operações necessárias indicadas na página de Testes de API.
• Os participantes que concluírem e passarem nos testes de API obterão oficialmente a elegibilidade para a competição.
• Os participantes que não concluírem ou não passarem nos testes de API não poderão avançar para as fases de integração de modelos e de competição formal.

Após receber as informações acima, mantenha as sua credenciais de API em segurança e siga as instruções para aceder à página de Testes de API e concluir os testes necessários.

2.2 Ligar e testar

Os participantes precisam de concluir um teste simples de API para se qualificarem para a ronda preliminar do hackathon. Leia atentamente a documentação oficial da WEEX API e utilize a chave de API fornecida para concluir o teste.

Testes de API: Utilize a API para chamar o endpoint de colocação de ordens e executar uma operação de cerca de 10 USDT em cmt_btcusdt.

2.2.1 Preparação da integração

1. Leia atentamente a documentação oficial da WEEX API: https://www.weex.com/pt-pt/api-doc/ai/intro

2. Ligue-se a um servidor na nuvem e execute o código abaixo. Deverá receber uma resposta que confirme se a ligação de rede está a funcionar corretamente.

curl -s --max-time 10 "https://api-contract.weex.com/capi/v2/market/time"

{"epoch":"1765423487.896","iso":"2025-12-11T03:24:47.896Z","timestamp":1765423487896}

3. Se o seu projeto for desenvolvido em Java ou Python, pode usar diretamente os exemplos de código correspondentes fornecidos na documentação. Para outras linguagens de programação, adapte os exemplos de acordo com a documentação oficial da API para se adequar à sua implementação.

Documentação de código de exemplo: https://www.weex.com/api-doc/ai/QuickStart/RequestInteraction

4. A plataforma oferece dois tipos de API:

• API públicas: Utilizadas para aceder a detalhes de configuração, dados de mercado e outras informações públicas. Não é necessária autenticação.
• API privadas: Utilizadas para gestão de ordens, operações de conta e outras ações sensíveis. A autenticação é obrigatória.

Ao chamar API privadas, inclua os seguintes dados de autenticação nos cabeçalhos dos pedidos HTTP:

Preencha "https://api-contract.weex.com" em BASE_URL

Códigos de estado HTTP:

• 200 Success – Resposta bem-sucedida
• 400 Bad Request – Formato do pedido inválido
• 403 Forbidden – Não tem acesso ao recurso solicitado
• 404 Not Found – Pedido não encontrado
• 429 Too Many Requests – Pedido muito frequente, tente novamente mais tarde
• 500 Internal Server Error – Ocorreu um problema no nosso servidor
• 521 Web Server is Down – IP não incluído na lista de permissões

Outros códigos de erro: https://www.weex.com/api-doc/contract/ErrorCodes/ExampleOfErrorCode

Pode iniciar os testes de API assim que os passos acima forem concluídos. As instruções seguintes utilizam BTC como ativo de exemplo.

2.2.2 Verifique o saldo da conta

1. Utilize a Account Balance API para obter o saldo atual da sua conta

Código de exemplo:

import time
import hmac
import hashlib
import base64
import requests

api_key = ""
secret_key = ""
access_passphrase = ""

def generate_signature_get(secret_key, timestamp, method, request_path, query_string):
  message = timestamp + method.upper() + request_path + query_string
  signature = hmac.new(secret_key.encode(), message.encode(), hashlib.sha256).digest()
  return base64.b64encode(signature).decode()

def send_request_get(api_key, secret_key, access_passphrase, method, request_path, query_string):
  timestamp = str(int(time.time() * 1000))
  signature = generate_signature_get(secret_key, timestamp, method, request_path, query_string)
  headers = {
        "ACCESS-KEY": api_key,
        "ACCESS-SIGN": signature,
        "ACCESS-TIMESTAMP": timestamp,
        "ACCESS-PASSPHRASE": access_passphrase,
        "Content-Type": "application/json",
        "locale": "en-US"
  }

  url = "https://api-contract.weex.com/"  # Substitua pelo endereço real da API
  if method == "GET":
    response = requests.get(url + request_path+query_string, headers=headers)
  return response

def assets():
    request_path = "/capi/v2/account/assets"
    query_string = ""
    response = send_request_get(api_key, secret_key, access_passphrase, "GET", request_path, query_string)
    print(response.status_code)
    print(response.text)

if __name__ == '__main__':
    assets()

2. Verifique a resposta

O exemplo abaixo indica uma resposta bem-sucedida

[
  {
    "coinName": "USDT",
    "available": "5413.06877369",
    "equity": "5696.49288823",
    "frozen": "81.28240000",
    "unrealizePnl": "-34.55300000"
  }
]

Se o pedido falhar, consulte aqui os códigos de erro detalhados: https://www.weex.com/api-doc/contract/ErrorCodes/ExampleOfErrorCode ou contacte o apoio técnico no grupo TG: https://t.me/weexaiwars.

2.2.3 Obtenha o preço do ativo

1. Utilize a Price Ticker API para obter o preço mais recente de cmt_btcusdt

Código de exemplo:

import requests

def send_request_get( method, request_path, query_string):
  url = "https://api-contract.weex.com/"  # Substitua pelo endereço real da API
  if method == "GET":
    response = requests.get(url + request_path+query_string)
  return response

def ticker():
    request_path = "/capi/v2/market/ticker"
    query_string = "?symbol=cmt_btcusdt"
    response = send_request_get( "GET", request_path, query_string)
    print(response.status_code)
    print(response.text)

if __name__ == '__main__':
    ticker()

2. Verifique a resposta:

O exemplo abaixo indica uma resposta bem-sucedida

{
  "symbol": "cmt_btcusdt",
  "last": "90755.3",
  "best_ask": "90755.4",
  "best_bid": "90755.3",
  "high_24h": "91130.0",
  "low_24h": "90097.3",
  "volume_24h": "2321170547.37995",
  "timestamp": "1764482511864",
  "priceChangePercent": "0.000474",
  "base_volume": "25615.0755",
  "markPrice": "90755.2",
  "indexPrice": "90797.161"
}

Se o pedido falhar, consulte aqui os códigos de erro detalhados: https://www.weex.com/api-doc/contract/ErrorCodes/ExampleOfErrorCode ou contacte o apoio técnico no grupo TG: https://t.me/weexaiwars.

2.2.4 Defina a alavancagem

Nota: A alavancagem máxima permitida nesta competição é de 20x; cumpra as regras no website oficial da WEEX.

1. Utilize a Leverage Adjustment API para modificar a alavancagem em margem cruzada para cmt_btcusdt

Código de exemplo:

import time
import hmac
import hashlib
import base64
import requests
importar json

api_key = ""
secret_key = ""
access_passphrase = ""

def generate_signature(secret_key, timestamp, method, request_path, query_string, body):
  message = timestamp + method.upper() + request_path + query_string + str(body)
  signature = hmac.new(secret_key.encode(), message.encode(), hashlib.sha256).digest()
  return base64.b64encode(signature).decode()

def send_request_post(api_key, secret_key, access_passphrase, method, request_path, query_string, body):
  timestamp = str(int(time.time() * 1000))
  body = json.dumps(body)
  signature = generate_signature(secret_key, timestamp, method, request_path, query_string, body)
  headers = {
        "ACCESS-KEY": api_key,
        "ACCESS-SIGN": signature,
        "ACCESS-TIMESTAMP": timestamp,
        "ACCESS-PASSPHRASE": access_passphrase,
        "Content-Type": "application/json",
        "locale": "en-US"
  }
  url = "https://api-contract.weex.com/"  # Substitua pelo endereço real da API
  if method == "POST":
    response = requests.post(url + request_path, headers=headers, data=body)
  return response

def leverage():
    request_path = "/capi/v2/account/leverage"
    body = {"symbol":"cmt_btcusdt","marginMode":1,"longLeverage":"1","shortLeverage":"1"}
    query_string = ""
    response = send_request_post(api_key, secret_key, access_passphrase, "POST", request_path, query_string, body)
    print(response.status_code)
    print(response.text)

if __name__ == '__main__':
    leverage()

Pode definir outros valores de alavancagem (até 20×) da mesma forma — basta substituir os números de alavancagem em conformidade. Os valores de alavancagem são seguidos pelos pares de trading.

2. Verifique a resposta:

O exemplo abaixo indica uma resposta bem-sucedida

{
    "msg": "success",
    "requestTime": 1713339011237,
    "code": "200"
}

Se o pedido falhar, consulte aqui os códigos de erro detalhados: https://www.weex.com/api-doc/contract/ErrorCodes/ExampleOfErrorCode ou contacte o apoio técnico no grupo TG: https://t.me/weexaiwars.

2.2.5 Coloque uma ordem

Nota: Apenas os seguintes pares de trading são permitidos nesta competição:

cmt_btcusdt, cmt_ethusdt, cmt_solusdt, cmt_dogeusdt, cmt_xrpusdt, cmt_adausdt, cmt_bnbusdt e cmt_ltcusdt A alavancagem máxima é de 20x; cumpra as regras no website oficial da WEEX.

1.Utilize a Get Futures Information para obter as informações do contrato para cmt_btcusdt (precisão das ordens, precisão de preço, tamanho máximo/mínimo da ordem, etc.)

Código de exemplo:

import requests

def send_request_get( method, request_path, query_string):
  url = "https://api-contract.weex.com/"  # Substitua pelo endereço real da API
  if method == "GET":
    response = requests.get(url + request_path+query_string)
  return response

def contracts():
    request_path = "/capi/v2/market/contracts"
    query_string = "?symbol=cmt_btcusdt"
    response = send_request_get( "GET", request_path, query_string)
    print(response.status_code)
    print(response.text)

if __name__ == '__main__':
    contracts()

2. Verifique a resposta:

O exemplo abaixo indica uma resposta bem-sucedida

[
    {
        "buyLimitPriceRatio": "0.01",
        "coin": "USDT",
        "contract_val": "0.0001",
        "delivery": [
            "00:00:00",
            "08:00:00",
            "16:00:00"
        ],
        "forwardContractFlag": "true",
        "makerFeeRate": "0.0002",
        "markerRate": "0.0002",
        "marketOpenLimitSize": "100",
        "maxLeverage": "400",
        "maxOrderSize": "1200",
        "maxPositionSize": "1000000",
        "minLeverage": "1",
        "minOrderSize": "0.0001",
        "priceEndStep": "1",
        "quote_currency": "USDT",
        "sellLimitPriceRatio": "0.01",
        "simulation": "false",
        "size_increment": "4",
        "symbol": "cmt_btcusdt",
        "takerFeeRate": "0.0008",
        "takerRate": "0.0008",
        "tick_size": "1",
        "underlying_index": "BTC"
    }
]

Se o pedido falhar, consulte aqui os códigos de erro detalhados: https://www.weex.com/api-doc/contract/ErrorCodes/ExampleOfErrorCode ou contacte o apoio técnico no grupo TG: https://t.me/weexaiwars.

Nota: A resposta da API pode mostrar uma alavancagem máxima mais elevada (por exemplo, 400x) disponível na plataforma. No entanto, para esta competição, a alavancagem máxima que pode utilizar está estritamente limitada a 20x.

3. Utilize a Place Order API para abrir uma posição longa em cmt_btcusdt com um preço limite de 100000.0 e 0.0001 BTC, utilizando as informações do contrato do Passo 1 (precisão das ordens, precisão de preço e tamanho máximo/mínimo da ordem) para construir os parâmetros..

Código de exemplo:

import time
import hmac
import hashlib
import base64
import requests
importar json

api_key = ""
secret_key = ""
access_passphrase = ""

def generate_signature(secret_key, timestamp, method, request_path, query_string, body):
  message = timestamp + method.upper() + request_path + query_string + str(body)
  signature = hmac.new(secret_key.encode(), message.encode(), hashlib.sha256).digest()
  return base64.b64encode(signature).decode()

def send_request_post(api_key, secret_key, access_passphrase, method, request_path, query_string, body):
  timestamp = str(int(time.time() * 1000))
  body = json.dumps(body)
  signature = generate_signature(secret_key, timestamp, method, request_path, query_string, body)
  headers = {
        "ACCESS-KEY": api_key,
        "ACCESS-SIGN": signature,
        "ACCESS-TIMESTAMP": timestamp,
        "ACCESS-PASSPHRASE": access_passphrase,
        "Content-Type": "application/json",
        "locale": "en-US"
  }
  url = "https://api-contract.weex.com/"  # Substitua pelo endereço real da API
  if method == "POST":
    response = requests.post(url + request_path, headers=headers, data=body)
  return response

def placeOrder():
    request_path = "/capi/v2/order/placeOrder"
    body = {
        "symbol": "cmt_btcusdt",
        "client_oid": "test",
        "size": "0.0001",
        "type": "1",
        "order_type": "0",
        "match_price": "0",
        "price": "100000.0"}
    query_string = ""
    response = send_request_post(api_key, secret_key, access_passphrase, "POST", request_path, query_string, body)
    print(response.status_code)
    print(response.text)

if __name__ == '__main__':
    placeOrder()

4. Verifique a resposta:

O exemplo abaixo indica uma resposta bem-sucedida

{
        "client_oid": null,
        "order_id": "596471064624628269"
}

Se o pedido falhar, consulte aqui os códigos de erro detalhados: https://www.weex.com/api-doc/contract/ErrorCodes/ExampleOfErrorCode ou contacte o apoio técnico no grupo TG: https://t.me/weexaiwars.

2.2.6 Obtenha detalhes de trade de ordens concluídas

1. Utilize a Trade Details API para obter o seu histórico de trades.

Código de exemplo:

import time
import hmac
import hashlib
import base64
import requests

api_key = ""
secret_key = ""
access_passphrase = ""

def generate_signature_get(secret_key, timestamp, method, request_path, query_string):
  message = timestamp + method.upper() + request_path + query_string
  signature = hmac.new(secret_key.encode(), message.encode(), hashlib.sha256).digest()
  return base64.b64encode(signature).decode()

def send_request_get(api_key, secret_key, access_passphrase, method, request_path, query_string):
  timestamp = str(int(time.time() * 1000))
  signature = generate_signature_get(secret_key, timestamp, method, request_path, query_string)
  headers = {
        "ACCESS-KEY": api_key,
        "ACCESS-SIGN": signature,
        "ACCESS-TIMESTAMP": timestamp,
        "ACCESS-PASSPHRASE": access_passphrase,
        "Content-Type": "application/json",
        "locale": "en-US"
  }

  url = "https://api-contract.weex.com/"  # Substitua pelo endereço real da API
  if method == "GET":
    response = requests.get(url + request_path+query_string, headers=headers)
  return response

def fills():
    request_path = "/capi/v2/order/fills"
    query_string = "?symbol=cmt_btcusdt&orderId=YOUR_ORDER_ID"
    response = send_request_get(api_key, secret_key, access_passphrase, "GET", request_path, query_string)
    print(response.status_code)
    print(response.text)
if __name__ == '__main__':
    fills()

2. Verifique a resposta:

O exemplo abaixo indica uma resposta bem-sucedida

{
  "list": [
    {
      "tradeId": 0,
      "orderId": 0,
      "symbol": "cmt_btcusdt",
      "marginMode": "SHARED",
      "separatedMode": "SEPARATED",
      "positionSide": "LONG",
      "orderSide": "BUY",
      "fillSize": "67",
      "fillValue": "12",
      "fillFee": "67",
      "liquidateFee": "MAKER",
      "realizePnl": "83",
      "direction": "OPEN_LONG",
      "liquidateType": "FORCE_LIQUIDATE",
      "legacyOrdeDirection": "OPEN_LONG",
      "createdTime": 1716712170527
    }
  ],
  "nextFlag": false,
  "totals": 0
}

Se o pedido falhar, consulte aqui os códigos de erro detalhados: https://www.weex.com/api-doc/contract/ErrorCodes/ExampleOfErrorCode ou contacte o apoio técnico no grupo TG: https://t.me/weexaiwars.

A nossa equipa de apoio ao cliente entrará em contacto consigo assim que passar no teste.

2.3 Financiamento e testes do modelo

Depois de concluir os testes de API e passar na análise de qualificação, a sua conta receberá os fundos iniciais necessários para os testes do modelo de IA. Pode utilizar livremente estes fundos até 5 de janeiro de 2026 para otimizar o seu modelo de IA.

Se tiver algum problema técnico ou ficar sem fundos para testes, contacte o nosso grupo oficial de apoio técnico para obter assistência.

2.4 Preparação pré-competição e redefinição da conta

Após a fase de testes do modelo, a lista oficial de participantes será publicada. Mantenha-se atualizado através da lista oficial de participantes na página do evento. Para garantir a equidade antes do início oficial da competição, todas as contas dos participantes serão redefinidas para um estado inicial unificado, com os saldos dos fundos de competição repostos para 1000 USDT, todas as ordens abertas canceladas e todas as posições fechadas.

Neste momento, todas as preparações pré-competição estão concluídas. Certifique-se de que o seu modelo de IA está totalmente integrado com a sua chave de API e pronto para negociar assim que a competição tiver início.

Nota: Todos os anúncios oficiais, listas de participantes e atualizações das regras serão publicados na página oficial do evento da WEEX. As agendas detalhadas, as regras de classificação e os termos de gestão de risco serão fornecidos no Manual Oficial das Regras da Competição ou através de avisos separados antes do evento.

Referência

• Perguntas frequentes
• Para perguntas específicas ou apoio adicional: Fazer pergunta
• Cronograma do hackathon

Pré-inscrição: Agora – 30 de dezembro de 2025

Pré-temporada (online): Início de janeiro de 2026 (20 dias)

Finais (online): Final de fevereiro de 2026 (17 dias)

Cerimónia de entrega de prémios (Dubai): Março de 2026

Agora tem todas as informações necessárias para se inscrever, preparar e participar com sucesso no AI Wars: WEEX Alpha Awakens. Siga cada passo cuidadosamente para garantir que o seu modelo de IA esteja totalmente integrado, testado e pronto para o dia da competição.

Inscreva-se agora para garantir o seu lugar: https://www.weex.com/pt-pt/events/ai-trading. Boa sorte e que os melhores algoritmos vençam!