{"openapi":"3.1.0","info":{"title":"Bolsa Mexicana de Valores (BMV) API","version":"1.0.0","description":"Live Mexican equity data from the Bolsa Mexicana de Valores (BMV): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in Mexican peso MXN), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the S&P/BMV index family (IPC plus LargeCap, MidCap and SmallCap). Foreign depositary receipts are filtered out so you get only genuine Mexican companies such as Grupo Mexico, America Movil, Walmex, FEMSA and Banorte. Mexican share classes carry a slash suffix (e.g. GMEXICO/B, AMX/B).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/mexico-stock-api","description":"oanor gateway"}],"tags":[{"name":"Quotes"},{"name":"Screener"},{"name":"Indices"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/quote":{"get":{"operationId":"get_v1_quote","tags":["Quotes"],"summary":"Live quote for one or more BMV stocks","description":"","parameters":[{"name":"symbols","in":"query","required":true,"description":"Comma-separated BMV tickers (up to 20; share classes use a slash, e.g. GMEXICO/B)","schema":{"type":"string"},"example":"GMEXICO/B,AMX/B,WALMEX"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"market":"BMV","quotes":[{"low":206.42,"high":213.06,"last":209.69,"name":"Grupo Mexico S.A.B. de C.V. Class B","open":206.5,"pe_ttm":15.3796,"sector":"Non-Energy Minerals","symbol":"GMEXICO/B","ticker":"BMV:GMEXICO/B","volume":2926233,"currency":"MXN","change_abs":3.07,"change_pct":1.4858,"market_cap":1632436669006},{"low":23.65,"high":24.49,"last":23.88,"name":"America Movil SAB de CV Class B","open":23.75,"pe_ttm":16.4553,"sector":"Communications","symbol":"AMX/B","ticker":"BMV:AMX/B","volume":60589195,"currency":"MXN","change_abs":0.04,"change_pct":0.1678,"market_cap":1461742508629},{"low":51.71,"high":52.34,"last":52.08,"name":"Wal-Mart de Mexico SAB de CV","open":52,"pe_ttm":17.9667,"sector":"Retail Trade","symbol":"WALMEX","ticker":"BMV:WALMEX","volume":27340371,"currency":"MXN","change_abs":0.27,"change_pct":0.5211,"market_cap":908604495539}]},"meta":{"timestamp":"2026-06-15T11:16:03.060Z","request_id":"287fe339-5332-451b-9b77-3f6dba042066"},"status":"ok","message":"Quote retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/screener":{"get":{"operationId":"get_v1_screener","tags":["Screener"],"summary":"Rank local primary listings","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"Sort field: market_cap, change or volume","schema":{"type":"string"},"example":"market_cap"},{"name":"order","in":"query","required":false,"description":"asc or desc","schema":{"type":"string"},"example":"desc"},{"name":"limit","in":"query","required":false,"description":"Number of results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sort":"market_cap","count":25,"order":"desc","market":"BMV","results":[{"low":206.42,"high":213.06,"last":209.69,"name":"Grupo Mexico S.A.B. de C.V. Class B","open":206.5,"pe_ttm":15.3796,"sector":"Non-Energy Minerals","symbol":"GMEXICO/B","ticker":"BMV:GMEXICO/B","volume":2926233,"currency":"MXN","change_abs":3.07,"change_pct":1.4858,"market_cap":1632436669006},{"low":23.65,"high":24.49,"last":23.88,"name":"America Movil SAB de CV Class B","open":23.75,"pe_ttm":16.4553,"sector":"Communications","symbol":"AMX/B","ticker":"BMV:AMX/B","volume":60589195,"currency":"MXN","change_abs":0.04,"change_pct":0.1678,"market_cap":1461742508629},{"low":51.71,"high":52.34,"last":52.08,"name":"Wal-Mart de Mexico SAB de CV","open":52,"pe_ttm":17.9667,"sector":"Retail Trade","symbol":"WALMEX","ticker":"BMV:WALMEX","volume":27340371,"currency":"MXN","change_abs":0.27,"change_pct":0.5211,"market_cap":908604495539},{"low":182.52,"high":189.24,"last":188.65,"name":"Grupo Financiero Banorte SAB de CV Class O","open":182.99,"pe_ttm":8.8945,"sector":"Finance","symbol":"GFNORTE/O","ticker":"BMV:GFNORTE/O","volume":4748540,"currency":"MXN","change_abs":6.03,"change_pct":3.3019,"market_cap":530701955449},{"low":166.46,"high":166.46,"last":166.46,"name":"Fomento Economico Mexicano SAB de CV Units Cons. Of 5 ShsB","open":166.46,"pe_ttm":20.0219,"sector":"Consumer Non-Durables","symbol":"FEMSA/UB","ticker":"BMV:FEMSA/UB","volume":87,"currency":"MXN","change_abs":0,"change_pct":0,"market_cap":448660788400},{"low":208.35,"high":213.53,"last":209.61,"name":"Arca Continental SAB de CV","open":210.1,"pe_ttm":18.4685,"sector":"Consumer Non-Durables","symbol":"AC","ticker":"BMV:AC","volume":1384091,"currency":"MXN","change_abs":-0.13,"change_pct":-0.062,"market_cap":355958029636},{"low":814.93,"high":847.79,"last":831.05,"name":"Industrias Penoles SAB de CV","open":822,"pe_ttm":9.7425,"sector":"Non-Energy Minerals","symbol":"PE_OLES","ticker":"BMV:PE_OLES","volume":204991,"currency":"MXN","change_abs":23.68,"change_pct":2.933,"market_cap":330322207650},{"low":135.83,"high":139.5,"last":138.5,"name":"Grupo Carso SAB de CV Class A1","open":135.83,"pe_ttm":39.4171,"sector":"Retail Trade","symbol":"GCARSO/A1","ticker":"BMV:GCARSO/A1","volume":230349,"currency":"MXN","change_abs":1.98,"change_pct":1.4503,"market_cap":312587027222},{"low":41.46,"high":42.46,"last":42.33,"name":"Grupo Financiero Inbursa SAB de CV Class O","open":41.85,"pe_ttm":8.4937,"sector":"Finance","symbol":"GFINBUR/O","ticker":"BMV:GFINBUR/O","volume":689326,"currency":"MXN","change_abs":0.66,"change_pct":1.5839,"market_cap":258195111862},{"low":57.54,"high":58.95,"last":58.15,"name":"Grupo Bimbo SAB de CV Class A","open":58.31,"pe_ttm":21.3826,"sector":"Consumer Non-Durables","symbol":"BIMBO/A","ticker":"BMV:BIMBO/A","volume":1243406,"currency":"MXN","change_abs":-0.09,"change_pct":-0.1545,"market_cap":250320878346},{"low":397.53,"high":410.35,"last":408.74,"name":"Grupo Aeroportuario del Pacifico SAB de CV Class B","open":400.03,"pe_ttm":20.6622,"sector":"Transportation","symbol":"GAP/B","ticker":"BMV:GAP/B","volume":1024446,"currency":"MXN","change_abs":11.79,"change_pct":2.9701,"market_cap":206527104002},{"low":488.61,"high":503.48,"last":493.42,"name":"Grupo Aeroportuario del Sureste SAB de CV Class B","open":490,"pe_ttm":15.1258,"sector":"Transportation","symbol":"ASUR/B","ticker":"BMV:ASUR/B","volume":371682,"currency":"MXN","change_abs":3.29,"change_pct":0.6713,"market_cap":148025982947},{"low":103.5,"high":103.5,"last":103.5,"name":"El Puerto de Liverpool SAB de CV","open":103.5,"pe_ttm":8.2894,"sector":"Retail Trade","symbol":"LIVEPOL/1","ticker":"BMV:LIVEPOL/1","volume":10,"currency":"MXN","change_abs":0,"change_pct":0,"market_cap":138336803399},{"low":78.53,"high":80.52,"last":79.98,"name":"Prologis Property Mexico, S.A. de C.V.","open":78.96,"pe_ttm":12.0847,"sector":"Finance","symbol":"FIBRAPL/14","ticker":"BMV:FIBRAPL/14","volume":2920761,"currency":"MXN","change_abs":1.02,"change_pct":1.2918,"market_cap":133422979406},{"low":43,"high":43,"last":43,"name":"Impulsora del Desarrollo y el Empleo en America Latina SAB Class B","open":43,"pe_ttm":15.755,"sector":"Transportation","symbol":"IDEAL/B-1","ticker":"BMV:IDEAL/B-1","volume":6,"currency":"MXN","change_abs":0,"change_pct":0,"market_cap":123238808350},{"low":1243,"high":1280,"last":1243,"name":"Vista Energy SAB de CV Class A","open":1280,"pe_ttm":9.711,"sector":"Energy Minerals","symbol":"VISTA/A","ticker":"BMV:VISTA/A","volume":28,"currency":"MXN","change_abs":-27.1,"change_pct":-2.1337,"market_cap":118328484688},{"low":274.87,"high":282.31,"last":280.05,"name":"Promotora y Operadora de Infraestructura SA","open":275.54,"pe_ttm":6.8924,"sector":"Transportation","symbol":"PINFRA","ticker":"BMV:PINFRA","volume":178997,"currency":"MXN","change_abs":5.88,"change_pct":2.1447,"market_cap":116429704557},{"low":28.7,"high":29.6,"last":29.29,"name":"Fibra Uno Administracion SA de CV Series -11-","open":28.74,"pe_ttm":5.7265,"sector":"Finance","symbol":"FUNO/11","ticker":"BMV:FUNO/11","volume":2923621,"currency":"MXN","change_abs":0.62,"change_pct":2.1625,"market_cap":113062220980},{"low":36.61,"high":37.8,"last":37.49,"name":"Kimberly-Clark de Mexico SAB de CV Class A","open":36.66,"pe_ttm":14.544,"sector":"Consumer Non-Durables","symbol":"KIMBER/A","ticker":"BMV:KIMBER/A","volume":3733275,"currency":"MXN","change_abs":0.96,"change_pct":2.628,"market_cap":111531696380},{"low":292.08,"high":298.32,"last":296.06,"name":"Gruma SAB de CV Class B","open":292.08,"pe_ttm":11.1476,"sector":"Consumer Non-Durables","symbol":"GRUMA/B","ticker":"BMV:GRUMA/B","volume":255962,"currency":"MXN","change_abs":2.56,"change_pct":0.8722,"market_cap":109652625284},{"low":186.07,"high":189.19,"last":187.97,"name":"Coca-Cola Femsa SAB de CV Units Cons of 5 Shs -L- + 3 Shs Series -B-","open":186.07,"pe_ttm":17.1294,"sector":"Consumer Non-Durables","symbol":"KOF/UBL","ticker":"BMV:KOF/UBL","volume":446434,"currency":"MXN","change_abs":2.9,"change_pct":1.567,"market_cap":98723280091},{"low":182,"high":182,"last":182,"name":"Grupo SIMEC SAB de CV Class B","open":182,"pe_ttm":43.29,"sector":"Non-Energy Minerals","symbol":"SIMEC/B","ticker":"BMV:SIMEC/B","volume":1001,"currency":"MXN","change_abs":0,"change_pct":0,"market_cap":90583079590},{"low":15.71,"high":16.18,"last":16.05,"name":"Sigma Foods, S.A.B. de C.V.","open":15.71,"pe_ttm":14.538,"sector":"Consumer Non-Durables","symbol":"SIGMAF/A","ticker":"BMV:SIGMAF/A","volume":8166161,"currency":"MXN","change_abs":0.26,"change_pct":1.6466,"market_cap":89214508528},{"low":89.74,"high":91.88,"last":90.79,"name":"Grupo Comercial Chedraui SAB de CV Class B","open":89.74,"pe_ttm":13.3207,"sector":"Retail Trade","symbol":"CHDRAUI/B","ticker":"BMV:CHDRAUI/B","volume":1818487,"currency":"MXN","change_abs":-0.27,"change_pct":-0.2965,"market_cap":87161509594},{"low":214.47,"high":221,"last":219.24,"name":"Grupo Aeroportuario del Centro Norte SAB de CV Class B","open":214.47,"pe_ttm":16.0039,"sector":"Transportation","symbol":"OMA/B","ticker":"BMV:OMA/B","volume":464328,"currency":"MXN","change_abs":5.83,"change_pct":2.7318,"market_cap":84663790669}]},"meta":{"timestamp":"2026-06-15T11:16:03.259Z","request_id":"5f95ecb2-9a1d-4983-a0da-3ca5801fdb00"},"status":"ok","message":"Screener retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/index":{"get":{"operationId":"get_v1_index","tags":["Indices"],"summary":"S&P/BMV indices (IPC family)","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Optional specific index symbol(s)","schema":{"type":"string"},"example":"ME"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"market":"BMV","indices":[{"low":67045.06,"high":68207.88,"name":"S&P/BMV IPC Index","open":67045.06,"index":"ME","label":"S&P/BMV IPC","value":67954.55,"change_abs":977.5,"change_pct":1.4595}]},"meta":{"timestamp":"2026-06-15T11:16:03.477Z","request_id":"15d7ef62-21f9-4f64-8a8b-86f1225b9baf"},"status":"ok","message":"Index retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Market metadata & endpoint guide","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Mexican share classes use a slash suffix, e.g. GMEXICO/B, AMX/B, FEMSA/UBD.","market":"Bolsa Mexicana de Valores (BMV)","source":"TradingView screener (mexico market), keyless","country":"Mexico","indices":["ME","CP","ICG","CM"],"currency":"MXN","examples":{"index":"/v1/index?symbol=ME","quote":"/v1/quote?symbols=GMEXICO/B,AMX/B,WALMEX","screener":"/v1/screener?sort=change&order=desc&limit=10"},"endpoints":{"/v1/index":"S&P/BMV indices (IPC = ME, LargeCap = CP, MidCap = ICG, SmallCap = CM)","/v1/quote":"live quote for one or more BMV stocks by ticker (symbols=GMEXICO/B,AMX/B,WALMEX)","/v1/screener":"rank local primary listings by market_cap | change | volume (sort, order, limit)"},"cache_ttl_ms":20000},"meta":{"timestamp":"2026-06-15T11:16:03.602Z","request_id":"6aa1b653-4d34-4ef7-8445-05893ecd16d4"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1620,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1440,"monthly_call_quota":49500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4270,"monthly_call_quota":207000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8830,"monthly_call_quota":865000,"rps_limit":48,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/mexico-stock-api"}