Valuations (評価) API

ベース URL

Production

https://valuations-api.dimo.zone/

---

評価検索

TokenIDで車両評価を取得

GET {baseUrl}/v2/vehicles/{tokenId}/valuations

車両の現在の評価を取得します。

パスパラメータ

名前	タイプ	説明
tokenId*	String	車両トークン ID。これは車両 NFT のトークン ID です。

ヘッダー

名前	タイプ	説明
Authorization*	String	ベアラー認証形式の車両 JWT 。

200: Success

{
  valuationSets: [
    {
      vendor: 'drivly',
      updated: '2024-03-17T02:37:50Z',
      mileage: 36000,
      tradeInSource: 'drivly',
      tradeIn: 28824,
      tradeInAverage: 28824,
      retailSource: 'drivly',
      retail: 33097,
      retailAverage: 33097,
      odometerUnit: 'miles',
      odometer: 36000,
      odometerMeasurementType: 'Estimated',
      userDisplayPrice: 30960,
      currency: 'USD'
    }
  ]
}

401: Unauthorized

{
    "code": 401,
    "message": "Invalid JWT."
}

403: Forbidden

{
    "code": 403,
    "message": "user does not have access to this vehicle"
}

評価を取得: データ SDK 関数呼び出し

TypeScript

await dimo.Valuations.getValuations({
    vehicleJwt, 
    tokenId
});

Python

dimo.valuations.get_valuations(vehicle_jwt, token_id)

C#

await dimoClient.ValuationsService.GetValuationsAsync(
    accessToken,
    tokenId
);

---

オファー検索

トークンIDで車両オファーリクエストを送信する

POST {baseUrl}/v2/vehicles/{tokenId}/instant-offer

Carvana、Carmax、Vroomなどのサードパーティサービスにオファーリクエストを送信します。このエンドポイントは、有効期限内の既存のオファー（存在する場合）を更新することに注意してください。

パスパラメータ

名前	タイプ	説明
tokenId*	String	車両トークン ID。これは車両 NFT のトークン ID です。

ヘッダー

名前	タイプ	説明
Authorization*	String	ベアラー認証形式の車両 JWT 。

200: Success

400: Bad Request

No offers found for you vehicle in last request

401: Unauthorized

{
    "code": 401,
    "message": "Invalid JWT."
}

403: Forbidden

{
    "code": 403,
    "message": "user does not have access to this vehicle"
}

オファー検索: データ SDK 関数呼び出し

TypeScript

await dimo.Valuations.getInstantOffers({
    vehicleJwt, 
    tokenId
});

Python

dimo.valuations.offers_lookup(vehicle_jwt, token_id)

C#

await dimoClient.ValuationsService.GetInstantOfferAsync(
    accessToken,
    tokenId
);

ユーザートークンID別に車両オファーを一覧表示する

GET {baseUrl}/v2/vehicles/{tokenId}/offers

特定の車両について、以前に評価 APIで取得した、有効期限内の既存のオファーを一覧表示します。オファーが期限切れの場合、このエンドポイントは結果を返しません。

パスパラメータ

名前	タイプ	説明
tokenId*	String	車両トークン ID。これは車両 NFT のトークン ID です。

ヘッダー

名前	タイプ	説明
Authorization*	String	ベアラー認証形式の車両 JWT 。

200: Success

{
  offerSets: [
    {
      source: 'drivly',
      updated: '2024-02-01T03:11:09Z',
      odometerMeasurementType: 'Estimated',
      offers: [Array]
    }
  ]
}

401: Unauthorized

{
    "code": 401,
    "message": "Invalid JWT."
}

403: Forbidden

{
    "code": 403,
    "message": "user does not have access to this vehicle"
}

車両オファーの一覧表示: データ SDK 関数呼び出し

TypeScript

await dimo.Valuations.getOffers({
    vehicleJwt, 
    tokenId
});

Python

dimo.valuations.list_vehicle_offers(vehicle_jwt, token_id)

C#

await dimoClient.ValuationsService.GetOffersAsync(
    accessToken,
    tokenId
);

エンティティタイプ

評価

特定の車両の価値を決定するためにサードパーティサービスが提供する査定。車両のメーカー、モデル、年式、走行距離計に基づいて算出されます。何らかの理由で車両の走行距離計に基づいて査定額を算出できない場合は、DIMOは年間走行距離12,000マイルを基準とした査定額をデフォルトとします。

オファー

特定の車両に適用されるオファーを決定するためにサードパーティサービスが提供するオファーです。このオファーは、車両のメーカー、モデル、年式、走行距離計に基づいて決定されます。何らかの理由で車両の走行距離計に基づいてオファーを決定できない場合、DIMOは年間走行距離12,000マイル以上のオファーをデフォルトとします。