Skip to main content

MarketEdge View UI

The Entrupy Android SDK provides displayMarketEdgeView(entrupyId, configuration) to present the SDK's built-in MarketEdge screen for an authentication result. The screen shows MarketGrade, MarketValue, MarketMatch, disclaimer, and optional region selection. The SDK owns the screen and its lifecycle; your app provides the Entrupy ID and visibility configuration.

Overview​

  • Presents a full-screen MarketEdge experience (MarketGrade, MarketValue, MarketMatch, region) hosted by the SDK.
  • You control which sections are visible via MarketEdgeViewConfiguration.
  • The SDK manages the screen presentation and dismissal.

Before presenting the MarketEdge view:

  • Initialize the SDK and ensure isAuthorizationValid() returns true.
  • Have the target authentication's Entrupy ID available.

1. Presenting the MarketEdge View​

import com.entrupy.sdk.app.EntrupyApp
import com.entrupy.sdk.features.marketedge.model.MarketEdgeViewConfiguration

fun showMarketEdge(entrupyId: String) {
    val entrupyApp = EntrupyApp.sharedInstance()

    if (!entrupyApp.isAuthorizationValid()) {
        Log.e("MarketEdge", "User not authorized. Cannot display MarketEdge view.")
        return
    }

    val configuration = MarketEdgeViewConfiguration(
        displayMarketGrade = true,
        displayMarketValue = true,
        displayMarketMatch = true,
        displayRegionSelection = true
    )

    entrupyApp.displayMarketEdgeView(
        entrupyId = entrupyId,
        configuration = configuration
    )
}

The SDK presents and dismisses the view; your app does not push or pop activities for this screen.

2. Default Configuration​

Calling displayMarketEdgeView with the default MarketEdgeViewConfiguration() shows all sections:

import com.entrupy.sdk.app.EntrupyApp
import com.entrupy.sdk.features.marketedge.model.MarketEdgeViewConfiguration

EntrupyApp.sharedInstance().displayMarketEdgeView(
    entrupyId = "your-entrupy-id",
    configuration = MarketEdgeViewConfiguration()
)

3. MarketEdgeViewConfiguration​

PropertyTypeDefaultDescription
displayMarketGradeBooleantrueShow the MarketGrade section — condition rating, item report, and condition details.
displayMarketValueBooleantrueShow the MarketValue section — estimated value based on recent market data.
displayMarketMatchBooleantrueShow the MarketMatch section — recent marketplace listings similar to the submitted item.
displayRegionSelectionBooleantrueShow region selection for market data.

3.1 Selective Display​

Show only specific sections by setting others to false:

import com.entrupy.sdk.features.marketedge.model.MarketEdgeViewConfiguration

val gradeOnly = MarketEdgeViewConfiguration(
    displayMarketGrade = true,
    displayMarketValue = false,
    displayMarketMatch = false,
    displayRegionSelection = false
)

EntrupyApp.sharedInstance().displayMarketEdgeView(
    entrupyId = "your-entrupy-id",
    configuration = gradeOnly
)

4. Region Preferences​

The SDK also provides a RegionPreferencesScreen composable that allows users to set their preferred region for MarketEdge data:

import com.entrupy.sdk.app.EntrupyApp
import androidx.compose.runtime.Composable

@Composable
fun RegionSettings(onBack: () -> Unit) {
    EntrupyApp.sharedInstance().RegionPreferencesScreen(
        onBack = onBack
    )
}
MarketEdge Data Access

On Android, MarketEdge data is accessed exclusively through the built-in UI via displayMarketEdgeView(). There is no programmatic data-fetching method in this SDK version. If you need MarketEdge data on your backend, use the Entrupy API.

Next Steps​