> For the complete documentation index, see [llms.txt](https://docs.trybit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.trybit.com/pt/referencia-da-api-v2/withdrawals.md).
# Levantamento de fundos
### Autenticação
Deve ser usada uma chave de API separada para autenticação. Pode ser gerada na secção «Segurança» nas definições da sua conta. A chave é apresentada apenas uma vez, por isso certifique-se de a guardar num local seguro e não a divulgar.
### O que o método permite fazer
* Cria um pedido de levantamento na moeda especificada.
* Intervalo mínimo entre pedidos — 12 segundos.
### Endpoint
`POST` `https://api.trybit.com/v2/invoice/api/out/create`
### Cabeçalhos
| Nome | Tipo | Exemplo | Descrição |
| -------------------------------------------------- | ------ | ----------------------------------- | -------------------------------------------------------------- |
| Autorização\* | string | Token eyJ0eXAiOiJK<...>4npi1ksS8tSY | Chave de API da secção «Segurança» nas definições da sua conta |
### Corpo da solicitação
Parâmetros principais
| Nome | Tipo | Exemplo | Descrição |
| ----------------------------------------------------- | ------ | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| currency\_code\* | string | ETH | Código da moeda:
BTC, LTC, TRX, SOL, TON, BNB, ETH, ETH\_ARB, ETH\_BASE, ETH\_OPT, USDT\_ARB, USDT\_BSC, USDT\_ERC20, USDT\_OPT, USDT\_SOL, USDT\_TON, USDT\_TRC20, USDC\_ARB, USDC\_BASE, USDC\_BSC, USDC\_ERC20, USDC\_OPT, USDC\_SOL, DAI\_ARB, DAI\_BASE, DAI\_BSC, DAI\_ERC20, DAI\_OPT, USDD\_TRC20, PYUSD\_ERC20, PYUSD\_SOL, XAUT\_ERC20, XAUT\_TON, ARB\_ARB, OP\_OPT, PEPE\_BSC, PEPE\_ERC20, SHIB\_BSC, SHIB\_ERC20, TRUMP\_SOL
|
| to\_address\* | string | 0x396343<...>210945346fb82Aa49 | Endereço da carteira do destinatário |
| amount\* | float | 0.003 | Montante do pedido de levantamento na moeda especificada |
### Exemplos de solicitação
Estes exemplos mostram como criar um pedido de levantamento.
{% tabs %}
{% tab title="cURL" %}
```bash
curl -X POST \\
https://api.trybit.com/v2/invoice/api/out/create \
-H 'Authorization: Token YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"currency_code": "BTC",
"to_address": "YOUR_RECIPIENT_ADDRESS",
"amount": 0.00023
}'
```
{% endtab %}
{% tab title="Python" %}
```python
import requests
from typing import Optional
class PayoutAPIClient:
def __init__(self, api_key: str):
self.api_key = api_key
self.base_url = 'https://api.trybit.com'
self.headers = {
'Authorization': f'Token {self.api_key}',
'Content-Type': 'application/json'
}
def create_payout(self, currency_code: str, to_address: str, amount: float) -> dict:
"""
Cria um pedido de levantamento.
:param currency_code: Código da moeda (por exemplo, “BTC”, “ETH”, “USDT”, “LTC”).
:param to_address: Endereço do destinatário.
:param amount: Quantidade a enviar.
:return: Resposta da API no formato dict.
"""
url = f"{self.base_url}/v2/invoice/api/out/create"
payload = {
"currency_code": currency_code,
"to_address": to_address,
"amount": amount
}
response = requests.post(url, json=payload, headers=self.headers)
if response.status_code == 200:
return response.json()
else:
raise PayoutAPIError(response.status_code, response.json())
class PayoutAPIError(Exception):
def __init__(self, status_code: int, error_data: Optional[dict] = None):
self.status_code = status_code
self.error_data = error_data or {}
message = f"O pedido da API falhou com o estado {status_code}: {self.error_data}"
super().__init__(message)
# Exemplo de uso:
if __name__ == "__main__":
# Configuração do cliente
api_key = ""
client = PayoutAPIClient(api_key)
try:
result = client.create_payout(
currency_code="BTC",
to_address="",
amount=0.00023
)
print("Sucesso:", result)
except PayoutAPIError as e:
print("Ocorreu um erro:", e)
```
{% endtab %}
{% tab title="JavaScript " %}
{% code title="Axios.js:" %}
```javascript
/**
* Erro personalizado para tratar falhas nas respostas da API de levantamento.
*/
class PayoutAPIError extends Error {
/**
* @param {number} statusCode - Código de estado HTTP devolvido pela API.
* @param {object} [errorData={}] - Detalhes do erro devolvidos pela API.
*/
constructor(statusCode, errorData = {}) {
super(`O pedido da API falhou com o estado ${statusCode}: ${JSON.stringify(errorData)}`);
this.name = 'PayoutAPIError';
this.statusCode = statusCode;
this.errorData = errorData;
}
}
/**
* Cliente para interagir com a Trybit Payout API.
*/
class PayoutAPIClient {
/**
* @param {string} apiKey - Token da API usado para autenticação.
*/
constructor(apiKey) {
this.apiKey = apiKey;
this.baseUrl = 'https://api.trybit.com';
this.headers = {
'Authorization': `Token ${this.apiKey}`,
'Content-Type': 'application/json'
};
}
/**
* Cria um pedido de pagamento.
*
* @param {string} currencyCode - Código da moeda (por exemplo, "BTC", "ETH", "USDT", "LTC").
* @param {string} toAddress - Endereço do destinatário.
* @param {number} amount - Quantidade a enviar.
* @returns {Promise} - Dados da resposta da API.
* @throws {PayoutAPIError} - Em caso de falha no pedido.
*/
async createPayout(currencyCode, toAddress, amount) {
const url = `${this.baseUrl}/v2/invoice/api/out/create`;
const payload = {
currency_code: currencyCode,
to_address: toAddress,
amount: amount
};
try {
const response = await axios.post(url, payload, {
headers: this.headers
});
return response.data;
} catch (error) {
const status = error.response?.status || 500;
const data = error.response?.data || {};
throw new PayoutAPIError(status, data);
}
}
}
// Exemplo de utilização com Axios
(async () => {
const client = new PayoutAPIClient('');
try {
const result = await client.createPayout("BTC", "", 0.00023);
console.log("Sucesso:", result);
} catch (error) {
console.error("Ocorreu um erro:", error);
}
})();
```
{% endcode %}
{% code title="Fetch.js:" %}
```javascript
const apiKey = '';
const payload = {
currency_code: 'BTC',
to_address: '',
amount: 0.00023
};
fetch('https://api.trybit.com/v2/invoice/api/out/create', {
method: 'POST',
headers: {
'Authorization': `Token ${apiKey}`,
'Content-Type': 'application/json'
},
body: JSON.stringify(payload)
})
.then(response => {
if (!response.ok) throw new Error(`Erro HTTP ${response.status}`);
return response.json();
})
.then(data => console.log('Sucesso:', data))
.catch(err => console.error('Erro:', err));
```
{% endcode %}
{% code title="Ajax.js:" %}
```javascript
const apiKey = '';
const xhr = new XMLHttpRequest();
xhr.open("POST", "https://api.trybit.com/v2/invoice/api/out/create");
xhr.setRequestHeader("Authorization", `Token ${apiKey}`);
xhr.setRequestHeader("Content-Type", "application/json");
xhr.onload = function () {
if (xhr.status === 200) {
console.log("Sucesso:", JSON.parse(xhr.responseText));
} else {
console.error("Erro:", xhr.status, xhr.responseText);
}
};
const payload = {
currency_code: 'BTC',
to_address: '',
amount: 0.00023
};
xhr.send(JSON.stringify(payload));
```
{% endcode %}
{% endtab %}
{% tab title="PHP" %}
<?php
/**
* Classe PayoutAPIError
*
* Exceção personalizada para erros da API.
*/
class PayoutAPIError extends Exception
{
public int $statusCode;
public array $errorData;
/**
* Construtor de PayoutAPIError.
*
* @param int $statusCode
* @param array $errorData
*/
public function __construct(int $statusCode, array $errorData = [])
{
$this->statusCode = $statusCode;
$this->errorData = $errorData;
$message = "O pedido da API falhou com o estado $statusCode: " . json_encode($errorData);
parent::__construct($message, $statusCode);
}
}
/**
* Classe PayoutAPIClient
*
* Cliente para criar pagamentos cripto através da API da Trybit.
*/
class PayoutAPIClient
{
private string $apiKey;
private string $baseUrl;
private array $headers;
/**
* Construtor de PayoutAPIClient.
*
* @param string $apiKey
*/
public function __construct(string $apiKey)
{
$this->apiKey = $apiKey;
$this->baseUrl = 'https://api.trybit.com';
$this->headers = [
'Authorization: Token ' . $this->apiKey,
'Content-Type: application/json'
];
}
/**
* Criar pedido de pagamento.
*
* @param string $currencyCode Código da moeda (por exemplo, BTC, ETH).
* @param string $toAddress Endereço do destinatário.
* @param float $amount Quantidade a enviar.
* @return array Resposta da API.
* @throws PayoutAPIError Em caso de falha na API.
*/
public function createPayout(string $currencyCode, string $toAddress, float $amount): array
{
$url = $this->baseUrl . '/v2/invoice/api/out/create';
$payload = json_encode([
'currency_code' => $currencyCode,
'to_address' => $toAddress,
'amount' => $amount,
]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, $this->headers);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$decoded = json_decode($response, true);
curl_close($ch);
if ($httpCode === 200) {
return $decoded;
} else {
throw new PayoutAPIError($httpCode, $decoded ?? []);
}
}
}
// Exemplo de utilização
try {
$client = new PayoutAPIClient('<your_api_key_here>');
$response = $client->createPayout('BTC', '<recipient_address>', 0.00023);
echo "Sucesso:\n";
print_r($response);
} catch (PayoutAPIError $e) {
echo "Ocorreu um erro:\n" . $e->getMessage();
}
Nome Tipo Exemplo Descrição invoice_id string INV-89UX09KA Identificador único do pedido de levantamento com o prefixo INV status string created Estado do pedido de levantamento — sempre created quando o pedido é submetido currency string ETH Código da criptomoeda selecionada no pedido de levantamento amount float 0.0029 Montante do pedido de levantamento em criptomoeda
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.trybit.com/pt/referencia-da-api-v2/withdrawals.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.