Vehicle market valuation — 2 operations (getMarketValue v1, getMarketValueV2) returning wholesale, retail and trade-in figures by VIN, with optional state, mileage and condition adjustment on v2.
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/carsxe:carsxe-market-value-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: CarsXE Market Value API
description: CarsXE is a B2B vehicle data API by PiWaves, LLC.
version: 1.0.0
contact:
name: CarsXE
url: https://api.carsxe.com
servers:
- url: https://api.carsxe.com
security:
- ApiKeyQuery: []
tags:
- name: Market Value
description: Vehicle market value by VIN
paths:
/marketvalue:
get:
operationId: getMarketValue
security:
- ApiKeyQuery: []
- X402Payment: []
- {}
tags:
- Market Value
summary: Vehicle Market Value (v1)
description: Get the market value of a vehicle by VIN, including retail, trade-in and auction values.
parameters:
- $ref: '#/components/parameters/vin'
- $ref: '#/components/parameters/format'
responses:
'200':
description: Market value retrieved.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
vin:
type: string
retail:
type: string
description: Retail price of the vehicle.
tradeIn:
type: string
description: The trade in price of the vehicle.
roughTradeIn:
type: string
averageTradeIn:
type: string
loanValue:
type: string
msrp:
type: string
tradeInValues:
type: array
items:
type: object
properties:
date:
type: string
value:
type: string
additionalProperties: true
auctionValues:
type: object
additionalProperties: true
additionalProperties: true
example:
retail: '16075'
tradeIn: '13575'
roughTradeIn: '10250'
averageTradeIn: '12050'
loanValue: '12225'
uid: 1172227
msrp: '52250'
tradeInValues:
- date: '2018-08-01T00:00:00.000Z'
value: '13575'
- date: '2018-07-01T00:00:00.000Z'
value: '13600'
auctionValues:
lowAuctionValue: 9050
averageAuctionValue: 11925
highAuctionValue: 14825
dateRange: 8/6/2018 - 8/12/2018
'400':
description: Missing VIN.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
message: Missing vin (vehicle identification number)
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: No data found for this VIN.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
message: No data found for this VIN
'429':
$ref: '#/components/responses/UsageLimitExceeded'
'500':
$ref: '#/components/responses/InternalServerError'
/v2/marketvalue:
get:
operationId: getMarketValueV2
security:
- ApiKeyQuery: []
- X402Payment: []
- {}
tags:
- Market Value
summary: Vehicle Market Value (v2)
description: Get detailed market values for a VIN, including wholesale, retail and trade-in values across condition tiers, with optional adjustments for US state, mileage and condition.
parameters:
- $ref: '#/components/parameters/vin'
- name: state
in: query
required: false
schema:
type: string
description: The US state of the vehicle to get the market value for.
- name: mileage
in: query
required: false
schema:
type: number
description: The current mileage of the vehicle used to adjust the market value. Must be a valid numeric value.
- name: condition
in: query
required: false
schema:
type: string
enum:
- excellent
- clean
- average
- rough
description: The overall condition of the vehicle.
responses:
'200':
description: Market value retrieved.
content:
application/json:
schema:
type: object
properties:
uid:
type: string
input:
type: object
additionalProperties: true
publish_date:
type: string
state:
type: string
country:
type: string
model_year:
type: string
make:
type: string
model:
type: string
series:
type: string
style:
type: string
class_name:
type: string
whole_xclean:
type: object
additionalProperties: true
whole_clean:
type: object
additionalProperties: true
whole_avg:
type: object
additionalProperties: true
whole_rough:
type: object
additionalProperties: true
retail_xclean:
type: object
additionalProperties: true
retail_clean:
type: object
additionalProperties: true
retail_avg:
type: object
additionalProperties: true
retail_rough:
type: object
additionalProperties: true
additionalProperties: true
example:
uid: FDE60872
input:
vin: WBAFR7C57CC811956
country: US
publish_date: 4/8/2025
state: NT
country: US
model_year: '2012'
make: BMW
model: 5-Series
series: 535i
style: 4D Sedan
class_name: Luxury Car
whole_clean:
base_whole_clean: 5300
mileage_whole_clean: 0
add_deduct_whole_clean: 0
regional_whole_clean: 0
retail_clean:
base_retail_clean: 9325
mileage_retail_clean: 0
add_deduct_retail_clean: 0
regional_retail_clean: 0
'400':
description: Missing/invalid VIN, mileage or condition.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
missingVin:
value:
success: false
message: Missing vin (vehicle identification number)
wrongLength:
value:
success: false
message: Wrong VIN length, must be 17 characters
invalidCondition:
value:
success: false
message: 'Invalid condition. Available conditions: excellent, clean, average, rough'
invalidMileage:
value:
success: false
message: Invalid mileage. Must be a number
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: No data found for this VIN.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
message: No data found for this VIN
'429':
$ref: '#/components/responses/UsageLimitExceeded'
'500':
$ref: '#/components/responses/InternalServerError'
'503':
description: Upstream market value provider is unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
message: Cannot access the internet at this time
components:
responses:
InternalServerError:
description: Internal server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
message: Internal server error
UsageLimitExceeded:
description: API usage limit exceeded for the current billing period.
content:
application/json:
schema:
$ref: '#/components/schemas/UsageLimitError'
example:
success: false
message: API usage limit exceeded
usage:
current: 1000
limit: 1000
remaining: 0
Unauthorized:
description: Missing API key, unknown/disabled API key, or inactive account.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
missingKey:
value:
success: false
message: Missing API key
userNotFound:
value:
success: false
message: User with this API key was not found or the API key is disabled
userNotActive:
value:
success: false
message: User with this API key is not active. To activate update your billing on https://carsxe.com/dashboard/billing
parameters:
format:
name: format
in: query
required: false
schema:
type: string
enum:
- json
- xml
default: json
description: The format of the response. One of `json` or `xml`.
vin:
name: vin
in: query
required: true
schema:
type: string
minLength: 17
maxLength: 17
description: The 17 character long vehicle identification number.
schemas:
Error:
type: object
properties:
success:
type: boolean
const: false
message:
type: string
required:
- success
- message
additionalProperties: true
UsageLimitError:
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
usage:
type: object
properties:
current:
type: number
description: Current usage in the billing period.
limit:
type: number
description: Included quota for the billing period.
remaining:
type: number
description: Remaining included quota.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: key
description: Your CarsXE API key, passed as the `key` query parameter.
X402Payment:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 payment proof for supported operations. Start without a CarsXE key to receive HTTP 402 payment requirements, then retry the identical request with the payment header produced by your x402 client. CarsXE also accepts the legacy X-PAYMENT header.
RecallsBatchToken:
type: apiKey
in: header
name: X-CarsXE-Batch-Token
description: Batch-scoped token returned by an x402 Recalls Batch submission.