aetherx-oracle

SDK Python oficial para a Aether-X Port Congestion Oracle API — sinais preditivos de congestão portuária, atraso de ETA e volatilidade de frete para portos globais.

Instalação

pip install aetherx-oracle

Uso rápido

from aetherx import OracleClient

client = OracleClient(api_key="SUA_RAPIDAPI_KEY")

risk = client.get_port_risk("BRSSZ")

print(risk.port_name)                 # Santos
print(risk.country)                   # Brasil
print(risk.congestion_score)          # 0.78
print(risk.eta_delay_days)            # 1.6
print(risk.waiting_vessels)           # 12
print(risk.freight_volatility_index)  # 0.42
print(risk.updated_at)                # 2026-09-17 15:46:53

Campos retornados (PortRisk)

Configuração avançada

client = OracleClient(
    api_key="SUA_RAPIDAPI_KEY",
    host="aether-x-port-congestion-oracle.p.rapidapi.com",  # default
    timeout=30.0,                                            # segundos
)

Portos suportados

Portos com dados de exemplo: BRSSZ, BRRIO, CNSHA, CNNGB, SGSIN, NLRTM, USLAX, USNYC, DEHAM, MPTNG, AEDXB, KRPUS, GBLGP, ZACPT, MXZLO.

Portos não cadastrados retornam uma estimativa global (country="Global").

Uso assíncrono (async)

Para consultar múltiplos portos em paralelo (ideal para bots e fundos quantitativos). Requer o extra async:

pip install "aetherx-oracle[async]"

import asyncio
from aetherx import OracleClient

async def main():
    client = OracleClient(api_key="SUA_RAPIDAPI_KEY")

    # Um porto
    risk = await client.get_port_risk_async("BRSSZ")
    print(risk.congestion_score)

    # Vários portos em paralelo
    risks = await client.get_ports_risk_async(["BRSSZ", "CNSHA", "NLRTM"])
    for r in risks:
        print(r.port_id, r.congestion_score)

asyncio.run(main())

Termos de uso

Os sinais são fornecidos "AS IS", sem garantia e não constituem aconselhamento de investimento. Consulte os Termos de Serviço.

Licença

O código deste SDK é distribuído sob a licença MIT (veja LICENSE). O uso da API hospedada está sujeito aos Termos de Serviço.