> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arbitragem-crypto.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Histórico de funding

> GET /v1/funding-rates/history — observações locais por contrato

`GET /v1/funding-rates/history?exchange=Gate.io&contract=BTC_USDT`

| Parâmetro  | Comportamento                                                                      |
| ---------- | ---------------------------------------------------------------------------------- |
| `exchange` | Obrigatório; mesma identificação do ranking.                                       |
| `contract` | Obrigatório; identificador original retornado pelo ranking, máximo 100 caracteres. |
| `from`     | UTC/RFC3339, inclusivo; padrão sete dias antes de `to`.                            |
| `to`       | UTC/RFC3339, exclusivo; padrão agora, não pode estar no futuro.                    |

O intervalo precisa ser positivo e de no máximo 30 dias. Dados anteriores à
retenção não são retornados. A resposta é `{ "data": [...] }`, com os mesmos
campos das observações do ranking, em ordem cronológica e até 2.880 pontos.
O campo `stale` do ranking não é uma avaliação da validade histórica dos pontos.

Cada ponto é a primeira observação válida de uma janela UTC de 15 minutos.
Não há importação retroativa, preenchimento de lacunas ou representação de
pagamentos liquidados. Nenhum ponto encontrado retorna `{ "data": [] }`.

Erros: 400 para parâmetros inválidos, 429 pelo limitador compartilhado de
arbitragem e 503 quando a consulta ao MongoDB falha.