Velocity API — Documentación Pública

Endpoints

GET /api/rates

Tipos de cambio en tiempo real para Guaranies (PYG). Devuelve cotizaciones actualizadas contra las principales monedas de comercio exterior.

Respuesta JSON

{
  "success": true,
  "base": "USD",
  "timestamp": "2026-05-21T14:30:00Z",
  "rates": {
    "PYG": 7850,
    "CNY_PYG": 1082,
    "EUR_PYG": 8790,
    "BRL_PYG": 1380
  },
  "source": "velocity.com.py"
}

GET /api/estimate

Estimador de costos de importacion desde China. Calcula costo total de internacion incluyendo flete, aranceles e IVA.

Parametro	Tipo	Descripcion
product_value	number	Valor del producto en USD
weight_kg	number	Peso total en kilogramos
volume_cbm	number	Volumen en metros cubicos (CBM)
shipping_method	string	`sea` o `air`

                    Ejemplo de request
                
                    /api/estimate?product_value=5000&weight_kg=200&volume_cbm=2&shipping_method=sea

Respuesta JSON

{
  "success": true,
  "estimate": {
    "product_value_usd": 5000,
    "product_value_pyg": 39250000,
    "shipping_cost_usd": 800,
    "customs_duty_percent": 12,
    "customs_duty_pyg": 4710000,
    "iva_percent": 10,
    "iva_pyg": 4396000,
    "total_landed_cost_pyg": 48356000,
    "cost_per_kg_usd": 29
  }
}

Calculadora interactiva

Valor producto (USD)

Peso (kg)

Volumen (CBM)

Metodo de envio

Resultado de estimacion

GET /api/aranceles

Tabla de aranceles por categoria de producto. Retorna los porcentajes de derechos aduaneros aplicables segun clasificacion.

Categoria	Arancel
Electronica	12%
Textiles	20%
Juguetes	15%
Alimentos	10%
Maquinaria	5%
Cosmeticos	18%
Automotriz	25%
General	15%

Respuesta JSON

{
  "success": true,
  "aranceles": [
    { "category": "Electronica", "duty_percent": 12 },
    { "category": "Textiles", "duty_percent": 20 },
    { "category": "Juguetes", "duty_percent": 15 },
    { "category": "Alimentos", "duty_percent": 10 },
    { "category": "Maquinaria", "duty_percent": 5 },
    { "category": "Cosmeticos", "duty_percent": 18 },
    { "category": "Automotriz", "duty_percent": 25 },
    { "category": "General", "duty_percent": 15 }
  ]
}

Ejemplos de codigo

JavaScript — fetch

var baseUrl = 'https://velocity.com.py/api';

fetch(baseUrl + '/rates')
  .then(function(res) { return res.json(); })
  .then(function(data) {
    console.log('USD/PYG:', data.rates.PYG);
  })
  .catch(function(err) {
    console.error('Error:', err);
  });

// Estimacion de costos
var params = '?product_value=5000&weight_kg=200&volume_cbm=2&shipping_method=sea';
fetch(baseUrl + '/estimate' + params)
  .then(function(res) { return res.json(); })
  .then(function(data) {
    console.log('Costo total:', data.estimate.total_landed_cost_pyg, 'PYG');
  });

Python — requests

import requests

base_url = "https://velocity.com.py/api"

# Tipos de cambio
response = requests.get(f"{base_url}/rates")
data = response.json()
print(f"USD/PYG: {data['rates']['PYG']}")

# Estimacion de costos
params = {
    "product_value": 5000,
    "weight_kg": 200,
    "volume_cbm": 2,
    "shipping_method": "sea"
}
response = requests.get(f"{base_url}/estimate", params=params)
estimate = response.json()["estimate"]
print(f"Costo total: {estimate['total_landed_cost_pyg']:,} PYG")

cURL

# Tipos de cambio
curl -s https://velocity.com.py/api/rates | python3 -m json.tool

# Estimacion de costos
curl -s "https://velocity.com.py/api/estimate?\
product_value=5000&\
weight_kg=200&\
volume_cbm=2&\
shipping_method=sea" | python3 -m json.tool

# Aranceles
curl -s https://velocity.com.py/api/aranceles | python3 -m json.tool

Limites de uso

100

Requests / minuto

No requerida

API Key para /rates

Fair Use

Politica de uso

El endpoint /api/rates no requiere autenticacion. Para uso comercial de alto volumen, contactanos en contacto@velocity.com.py. Nos reservamos el derecho de limitar el acceso en caso de uso abusivo.