📘 Documentação da API - GetMoons

🔐 Autenticação

Todas as requisições exigem o seguinte cabeçalho HTTP:

Authorization: Bearer <seu_token>
Content-Type: application/json

Exemplo:

Authorization: Bearer SEU_TOKEN

🪙 1. Listar criptomoedas e redes

Endpoint: GET https://api.getmoons.com/v1/assets

Descrição: Permite consultar todas as criptomoedas e redes suportadas pela plataforma para operações

Response

{
  "success": true,
  "data": [
    {
    "name": "Tether",
    "currency": "USDT",
    "network": "POLYGON",
    "enabled": true,
    "payin": true,
    "payout": true,
    "buy": true,
    "sell": false,
    "explorerHash": "https:\/\/polygonscan.com\/tx\/{{txid}}",
    "protocol": "POLYGON",
    "tagName": ""
    }
  ]
}

🛒 2. Criar Compra

Endpoint: POST https://api.getmoons.com/v1/buy/create

Descrição: Cria um pedido de compra de criptoativos com pagamento em BRL (Pix).

Request

{
  "amount": "4",
  "address": "0x2b4CB68b1999C771B350A34456a80f82863B4101",
  "currency": "usdt",
  "network": "polygon"
}

Response

{
  "success": true,
  "data": {
    "id": "4d2da7b59b195b522ef71b1734053af7",
    "status": "pending",
    "payin": {
      "amount": "4",
      "currency": "BRL",
      "network": "FIAT",
      "address": "00020101021226860014br.gov.bcb.pix2564qrcode.fitbank.com.br/QR/cob/B392A50CC87828792F5BE7C1E0CF6C7A5EB5204000053039865802BR5925PLEBANK.COM.BR SOLUCOES E6007BARUERI61080645400062070503***63047119",
      "hash": ""
    },
    "payout": {
      "amount": "0.3366",
      "currency": "USDT",
      "network": "POLYGON",
      "address": "0x2b4CB68b1999C771B350A34456a80f82863B4101",
      "hash": ""
    },
    "paidAt": "",
    "creationAt": "2025-05-09T15:50:31.667Z",
    "updatedAt": "2025-05-09T15:50:31.667Z",
    "expirationAt": "2025-05-09T16:10:31.667Z"
  }
}

🔎 3. Consultar Status da Compra

Endpoint: GET https://api.getmoons.com/v1/buy/status/{id}

Exemplo: GET https://api.getmoons.com/v1/buy/status/fdb985e1d3841f369751dd1c84fa8e29

Response

{
  "success": true,
  "data": {
    "id": "fdb985e1d3841f369751dd1c84fa8e29",
    "status": "completed",
    "payin": {
      "amount": "4",
      "currency": "BRL",
      "network": "FIAT",
      "address": "00020101021226860014br.gov.bcb.pix2564qrcode.fitbank.com.br/QR/cob/75E1866E466807ADD570C5BC3814C7CE4955204000053039865802BR5925PLEBANK.COM.BR SOLUCOES E6007BARUERI61080645400062070503***6304747C",
      "hash": ""
    },
    "payout": {
      "amount": "0.3366",
      "currency": "USDT",
      "network": "POLYGON",
      "address": "0x2b4CB68b1999C771B350A34456a80f82863B4101",
      "hash": "0x402ad8e9d6f0da0d01012ac7fe506e42dd8f50ce3a8855e335c4ea35133b5356"
    },
    "paidAt": "2025-05-09T15:52:31.667Z",
    "creationAt": "2025-05-09T15:50:31.667Z",
    "updatedAt": "2025-05-09T15:54:31.667Z",
    "expirationAt": "2025-05-09T16:10:31.667Z"
  }
}

💱 4. Cotação de Criptoativos

Endpoint: GET https://api.getmoons.com/v1/buy/quote/{currency}/{network}/{amount}

Exemplo: GET https://api.getmoons.com/v1/buy/quote/usdt/polygon/15

Response

{
  "success": true,
  "data": {
    "payoutAmount": "1.1373"
  }
}

📌 5. Status Possíveis de Pedido

Observação: Utilize sempre o status completed para confirmar que a transação foi concluída com êxito.

Status	Descrição
pending	Aguardando pagamento do usuário via Pix
reviewing	Pagamento recebido, em análise
confirmed	Pagamento PIX confirmado
processing	Cripto sendo enviada para o endereço informado
completed	Transação concluída com sucesso
refunded	Valor devolvido ao usuário
canceled	Pedido cancelado

Endpoint

O endpoint (URL) para receber o webhook precisa ser informado previamente à getmoons.com, para que as notificações de status sejam enviadas corretamente. Certifique-se de que seu servidor esteja pronto para receber requisições POST autenticadas com Bearer Token.

POST https://seu-dominio.com/webhook

Header de Autenticação

Authorization: Bearer SEU_TOKEN_DO_WEBHOOK
Content-Type: application/json

Payload Enviado

{
  "data": {
    "id": "fdb985e1d3841f369751dd1c84fa8e29",
    "status": "completed",
    "payin": {
      "amount": "4",
      "currency": "BRL",
      "network": "FIAT",
      "address": "00020101021226860014br.gov.bcb.pix2564qrcode.fitbank.com.br/QR/cob/75E1866E466807ADD570C5BC3814C7CE4955204000053039865802BR5925PLEBANK.COM.BR SOLUCOES E6007BARUERI61080645400062070503***6304747C",
      "hash": ""
    },
    "payout": {
      "amount": "0.3366",
      "currency": "USDT",
      "network": "POLYGON",
      "address": "0x2b4CB68b1999C771B350A34456a80f82863B4101",
      "hash": "0x402ad8e9d6f0da0d01012ac7fe506e42dd8f50ce3a8855e335c4ea35133b5356"
    },
    "paidAt": "2025-05-09T15:52:31.667Z",
    "creationAt": "2025-05-09T15:50:31.667Z",
    "updatedAt": "2025-05-09T15:54:31.667Z",
    "expirationAt": "2025-05-09T16:10:31.667Z"
  }
}