Help center
›
Tarifas de Mercado
market-rates

Consulta tarifas de mercado con la API

Qué devuelve la API de Tarifas de Mercado, cómo obtener una clave y qué saber sobre lotes, caché y datos de prueba antes de construir.

Broker
Updated
September 23, 2026

La API de Tarifas de Mercado lleva el mismo rango Bajo, Medio y Alto que ves en la plataforma a tu propio TMS, herramienta de precios o pantalla de cotización. Envías una ruta y recibes una serie semanal de tarifas, una entrada por semana con su propia etiqueta de confianza. Cada entrada se construye con las 12 semanas de ofertas hasta esa semana, y la más reciente es la que muestra la plataforma. La referencia completa está en docs.cargado.com.

Paso 1: Obtén una clave

Las claves las crea el equipo de Cargado. Escribe a success@cargado.com, di cómo se llama la integración y pide el permiso de tarifas de mercado. En Obtén una clave de API para tu integración explicamos cómo funcionan las claves y cómo protegerlas. Envía la clave en el encabezado api-key en cada solicitud a https://api.cargado.com.

Paso 2: Envía una consulta

Llama a POST /rates/history con una lista requests de 1 a 16 rutas. Cada ruta necesita:

  • Paradas: una recolección al inicio y una entrega al final. Cada lugar puede ser una ciudad estructurada, un código postal, una dirección o una dirección en texto libre.
  • Remolque: exactamente un tipo de remolque.
  • Cruce (opcional, solo en rutas de México): agrega una parada de cruce fronterizo, o déjala fuera y Cargado usa su cruce recomendado y te dice cuál fue.
  • Millas de la ruta (opcional): tu propia distancia, si quieres que sustituya la de Cargado.

Agrega currency (USD, MXN o CAD) a la solicitud. Por defecto es USD.

Paso 3: Lee los resultados

Los resultados llegan en el mismo orden que tus solicitudes. Cada uno tiene éxito o falla por su cuenta, marcado como DATA o ERROR, así que una ruta con error no afecta el resto del lote. Un resultado DATA incluye:

  • La ruta consultada: el origen y el destino (y si alguno de los dos es un mercado extendido), la categoría de remolque y el cruce.
  • suggestedRates, allInRates y perMileRates: una entrada por semana, de la más antigua a la más reciente. Cada una trae p25, p50 y p75 en centavos de dólar o de peso, más el margen de error y la confianza. Por ejemplo, 330000 es $3,300.
  • latestSuggestedRate: la cifra que la plataforma muestra como Bajo, Medio y Alto.
  • Las millas de la ruta, con y sin el movimiento vacío hasta los centros de los mercados.

Las semanas sin datos suficientes no se incluyen. Si una ruta no tiene ninguna, recibes un resultado ERROR con el código RATE_HISTORY_NOT_FOUND.

Paso 4: Prueba antes de salir a producción

Pide al equipo de Cargado acceso al sandbox en https://api.sandbox.cargado.com. El sandbox devuelve tarifas simuladas, así que úsalo para probar tu integración, nunca para cotizar.

Caché y uso

Cada llamada a POST /rates/history se registra como una consulta y cuenta para el mismo límite mensual que las consultas en la plataforma y en Excel. Si envías exactamente la misma solicitud otra vez en la misma semana, Cargado devuelve el resultado anterior en lugar de crear una consulta nueva. También puedes recuperar una consulta guardada por su id con GET /rates/history/{id}. Consulta Límites del plan y qué significan los correos de aviso de uso.

Importante: si docs.cargado.com y este artículo no coinciden, sigue este artículo: una solicitud admite hasta 16 rutas y las tarifas semanales llegan de la más antigua a la más reciente.

Still stuck?

Email us and a person on our team will answer. Send the posting link or a screenshot if you have one.

carriers@cargado.comfor carrierssuccess@cargado.comfor brokers and shippers

Related articles

Empieza en nueve minutos
El ciclo completo para una cuenta nueva: configúrala, consulta la tarifa, publica y atiende las ofertas.
getting-started
Instala y usa el complemento de Excel
Cómo lo implementa tu administrador de Microsoft 365, cómo inicias sesión con tu cuenta de Cargado y todas las funciones que te da.
market-rates
Tu primera semana: cinco cosas que nos dicen las empresas de logística
Cinco cosas que nos dicen las empresas de logística en su primera llamada después de firmar, y lo que en realidad es cierto.
getting-started
Parte 1 · Configura tu cuenta
Las personas correctas ya invitadas, los embarques repartidos como trabaja tu equipo y tu propia revisión de transportistas al mando.
getting-started
Parte 2 · Primero, la tarifa
Una tarifa de la ruta antes de cotizarla: en la plataforma, en Excel para una RFP completa o por la API.
getting-started
Parte 3 · Publica bien
Una publicación en la que los transportistas sí ofertan, y los tres hábitos que vale la pena formar desde el primer día.
getting-started
Parte 4 · Atiende tus ofertas
Cada oferta contestada, un transportista contratado y los embarques saliendo directo desde tu TMS.
getting-started
Autenticación de dos factores: cómo activarla y qué hacer si no puedes entrar
Conecta una app de autenticación, un mensaje de texto o una llave de acceso, y el único paso que te devuelve el acceso si pierdes tu dispositivo.
account-access
Cancela, pausa o cierra tu cuenta
No hay un botón para cancelar por tu cuenta. A quién escribirle y qué esperar.
account-and-billing
“Ya existe un usuario con este correo” al invitar a alguien
Qué significa ese error, los dos casos que lo causan y cómo lograr que tu compañero entre.
account-access
Tus números DOT, MC, RFC, NSC, CVOR y NIR
Qué número de registro te pide Cargado según tu país, y qué significa cada mensaje de error.
getting-started
Por qué no puedes ofertar en una publicación
Qué te impide ofertar, qué no, y qué significa en realidad el mensaje general que ves en pantalla.
the-marketplace
Después del match: cómo contactar al transportista o a la empresa de logística
Qué te da el mensaje de match, dónde está el chat y cómo se intercambian los datos de contacto.
the-marketplace
Encuentra tu factura y cambia a dónde se envía
Dónde están las facturas, quién de tu equipo puede verlas y cómo reciben su pago los transportistas.
account-and-billing
Límites del plan y qué significan los correos de aviso de uso
Qué cuenta para tu plan, qué pasa cuando llegas al límite y quién puede ampliarlo.
account-and-billing
Bloquea a un transportista para que no vea tus embarques
La lista «No usar»: en una publicación lo haces tú; para toda la empresa lo hacemos nosotros.
the-marketplace
Cambia tu idioma y lee el chat en el tuyo
Dónde está la configuración de idioma, qué idiomas manejamos y cómo funciona la traducción del chat.
language-support
¿La tarifa de mercado incluye el combustible?
Sí. Las cifras Bajo, Medio y Alto incluyen el combustible, en la plataforma, en Excel y con la API.
market-rates
Obtén una clave de API para tu integración
Cómo obtener una clave de API si no usas McLeod, Tai o Turvo, y qué significan los permisos.
integrations
Cómo te pagan después de ganar un embarque
Cargado no paga el embarque. Qué pasa entre el match y tu factura, y a quién preguntarle sobre el pago.
account-and-billing
Cómo se aprueba a un transportista
Qué pide la solicitud en Estados Unidos, México y Canadá, y los pasos que siguen después de tu invitación.
getting-started
Publica un viaje redondo o un embarque con varias paradas
Dos opciones del formulario de publicación que ya usas: la casilla Viaje redondo, y recolecciones y entregas adicionales.
the-marketplace
Publica embarques LTL o parciales
No hay un modo LTL aparte. Publícalo como parcial y dale al transportista el tamaño, para que sepa si le cabe.
the-marketplace
Cambia el nombre de un espacio de trabajo, o hazlo privado
Dónde está la configuración de los espacios de trabajo, quién puede cambiarla y qué hace exactamente la opción de privado.
account-and-billing
Filtra los embarques que ves: hazmat, remolque, cruce y más
Todos los filtros de la búsqueda de embarques, incluido cómo ocultar los embarques con hazmat, sobrepeso o sobredimensionados.
the-marketplace
App de escritorio, app móvil o navegador
Son el mismo Cargado. Dónde descargar las apps, y la única diferencia real: las notificaciones.
getting-started
Restablece tu contraseña
El link para restablecerla está en la página para iniciar sesión, y qué revisar cuando el correo no llega.
account-access
Comparte el link de una publicación específica
Las publicaciones no muestran al transportista un número de embarque. Comparte el link de la publicación.
the-marketplace
Persona física y persona moral: cuando tienes dos perfiles
Por qué un cambio de tipo de contribuyente implica un perfil de transportista nuevo, y cómo dar de baja el anterior.
getting-started
¿Por qué mi publicación no recibe ofertas?
Qué revisa Cargado antes de avisarles a los transportistas de tu publicación, y los cambios que hacen que vuelvan las ofertas.
the-marketplace
¿Por qué mi publicación dice Responder?
Responder significa que la oferta de un transportista espera tu respuesta. Búscala en Ofertas pendientes, únete al chat y acepta, contraoferta o rechaza.
the-marketplace
Cómo leer una tarifa de mercado
Qué significan Bajo, Medio, Alto y Confianza en una tarifa de mercado de Cargado, más la gráfica de 12 semanas, los mercados extendidos y la moneda.
market-rates
Consulta una tarifa de mercado en la plataforma
Consulta la tarifa de una ruta en la pestaña Tarifas: remolque, origen, destino, cruce y moneda, y luego lee, comparte o publica desde el resultado.
market-rates
¿Qué hace una integración con tu TMS?
Una integración con tu TMS sincroniza tus embarques en Cargado, los publica según tus reglas y regresa a tu TMS las ofertas y reservas de los transportistas.
integrations
¿Por qué no hay tarifa de mercado para mi ruta?
Qué significa cada mensaje de sin tarifa, en la plataforma, Excel y la API, y qué hacer después, incluido publicar la ruta como potencial.
market-rates
Cómo valida Cargado a los transportistas
Cargado revisa la autoridad y los identificadores de cada transportista antes de que oferte; tu propio proceso de alta decide a quién despachas.
the-marketplace
Administra tu equipo: invitaciones, roles y acceso
Invita a tus compañeros, elige su rol, cambia a un administrador y desactiva accesos desde Organización > Miembros.
account-and-billing
Cotiza un archivo de RFP en Excel
Cotiza un RFP completo con el complemento de Excel: mapea los términos de tu archivo, apunta un renglón al RFP y cópialo hacia abajo a cada ruta.
market-rates
¿Cómo cubro embarques hacia y desde México?
Cargado tiene su propia red de transportistas mexicanos verificados, así que no necesitas un proceso de alta en México para llegar a ellos.
the-marketplace
Consulta tarifas de mercado con la API
Qué devuelve la API de Tarifas de Mercado, cómo obtener una clave y qué saber sobre lotes, caché y datos de prueba antes de construir.
market-rates
¿Cómo controlo mis notificaciones de Cargado?
Activa o desactiva los avisos de ofertas, chat y publicaciones, y elige correo, WhatsApp o push para tu propia cuenta.
account-and-billing
Descarga la exportación semanal de tarifas de mercado
Con un plan Enterprise personalizado, descarga por la API un CSV semanal con las tarifas de mercado de todas las rutas que Cargado calcula.
market-rates
¿Qué cruce fronterizo pongo en una publicación?
El campo de cruce solo aparece en embarques transfronterizos, es obligatorio y decide a qué transportistas llega tu publicación.
the-marketplace
Tarifas de Mercado para transportistas
Con Tarifas de Mercado activadas, un transportista consulta tarifas de rutas transfronterizas en la pestaña Tarifas. En beta y sin costo mientras dure.
market-rates
Publica plataforma, sobredimensionado, Power Only y otros movimientos especiales
Plataforma, RGN, sobredimensionado y Power Only se publican directo. El transbordo lleva dos publicaciones, el arrastre aún no tiene y la pipa no se admite.
the-marketplace
¿Cómo configuro el perfil de mi empresa para que el tablero de embarques me muestre lo que sí me sirve?
Llena Operaciones y Áreas de Servicio después de tu aprobación. Con eso decidimos qué publicaciones ves en tu tablero de embarques y de cuáles te avisamos.
getting-started
¿Cómo agrego a personas de mi empresa?
Invita a tus compañeros por correo desde Miembros, elige su rol y agrégalos a un chat. No tiene costo y no hay límite de personas.
getting-started
¿Cómo leo el tablero de embarques?
Qué te muestra el tablero de embarques, qué quiere decir cada parte de un renglón y en qué se distinguen un embarque, una ruta y una publicación potencial.
the-marketplace
¿Qué me dice una publicación antes de ofertar?
Cómo leer una publicación de arriba abajo: el resumen, las paradas y el cruce, el equipo, los detalles del embarque, los requisitos y la empresa.
the-marketplace
¿Cómo oferto en un embarque o en una ruta?
Abre una publicación del tablero de embarques. Si tiene tarifa preaprobada, resérvala; si no, captura tu tarifa y envía tu oferta.
the-marketplace
¿Cómo respondo a una contraoferta o veo por qué rechazaron mi oferta?
Entra a Ofertas, abre la oferta que dice Contraoferta y acéptala, contraoferta o recházala. Si dice Rechazada, puedes ofertar de nuevo.
the-marketplace
¿Cómo funciona el chat con una empresa de logística?
Empieza un chat desde cualquier publicación, antes o después de ofertar. El teléfono y el correo se desbloquean cuando se acepta una tarifa.
the-marketplace
Ya hice match. ¿Qué sigue?
Con tu tarifa aceptada, te das de alta con la empresa de logística si hace falta y te manda la carta de instrucciones. Revisa Mis embarques y Mis rutas.
the-marketplace
¿Cómo recibo alertas de las rutas que me interesan?
Busca una ruta en el tablero de embarques, guárdala con un nombre y elige alertas por correo, WhatsApp o push para embarques spot y rutas nuevas.
the-marketplace
¿Cómo publico un camión vacío?
Da clic en Publicar en Camiones publicados, indica dónde está el camión, su remolque y qué día queda libre, y ve los embarques que le encajan.
the-marketplace
Llena una publicación, sección por sección
Qué pide cada sección del formulario para publicar, qué ve el transportista y qué campos cambian según la ruta.
the-marketplace
¿Quién hace el cruce fronterizo: transfer preestablecido o el transportista?
Elige que el transportista haga el cruce si lo cruza quien contratas, y transfer preestablecido si el cruce ya lo tiene alguien más.
the-marketplace
Publica una ruta que ya cubres sin que tu transportista actual la vea
Agrega a tu transportista actual en Titulares al publicar una ruta. No la ve ni puede ofertar, y tú conoces el mercado sin que se entere.
the-marketplace
¿Qué pasa cuando pongo una tarifa objetivo? Respuestas instantáneas
Pon la oferta más alta que aceptas y la plataforma les contesta a los transportistas en segundos. Ellos ven una tarifa de Reservar ahora más baja.
the-marketplace
¿Quiénes son mis transportistas sugeridos y cómo uso la pestaña Cobertura?
La pestaña Cobertura muestra los transportistas que Cargado te sugiere para tu publicación, por qué encajan y todas sus ofertas y chats en una lista.
the-marketplace
Escríbele a un transportista antes de que oferte
Abre cualquier transportista sugerido en la pestaña Cobertura y mándale un mensaje. El chat empieza cuando lo mandas y el transportista ve tu publicación.
the-marketplace
¿Qué escribo en el mensaje personalizado?
Tu mensaje personalizado va en el correo y en el aviso de WhatsApp de la publicación. Pon lo importante en los primeros 100 caracteres.
the-marketplace
Encuentra, filtra y vuelve a publicar tus embarques en la pestaña Embarques
La pestaña Embarques guarda todo lo que publica tu empresa. Elige una vista, filtra por persona o por ID, y vuelve a publicar o duplica.
the-marketplace
¿Cuánto tiempo sigue activa mi publicación y por qué se desactivó?
Un embarque se baja cuando pasa su cita, una ruta después de su fecha de fin. En rutas y potenciales, la fecha límite de ofertas puede bajarla antes.
the-marketplace
Publica embarques nacionales dentro de México
Puedes publicar embarques que solo se mueven dentro de México. Elige una unidad como el Torton o la 3.5 y, si quieres, pon la tarifa en pesos.
the-marketplace
¿Qué muestra la pestaña Analíticos y cómo ve un gerente a todo su equipo?
Analíticos muestra las publicaciones, ofertas y uso de Tarifas de Mercado de toda tu empresa. Todos en tu cuenta ven lo mismo.
the-marketplace