AT AppointmentTrader
로그인
현재 온라인  

/v1/marketdata/

Contains all market data related functions to allow sellers to pick up on trends throughout the year
GET

/v1/marketdata/get_city_hot_list

#
Returns the most-traded venues in a given city, with rank-change deltas. Powers the per-city Hot List page at /market-data/.

매개변수

이름유형필수기본값설명
citySlug string 예 — CloseByCitySlug (e.g. los-angeles, new-york).
pageSize int 아니요 20 Venues per page (1-50).
pageNumber int 아니요 0 Zero-based page number.
categorySlug string 아니요 "" Optional category filter.
dateRange string 아니요 "90d" Activity window.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_city_hot_list' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'citySlug={{citySlug}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'pageNumber={{pageNumber}}' \
  --data-urlencode 'categorySlug={{categorySlug}}' \
  --data-urlencode 'dateRange={{dateRange}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_city_hot_list_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.categorySlugstring 예
$.oneOf[0].allOf[1].Payload.resolvedCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.seoCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.categoryTitlePluralstring 예
$.oneOf[0].allOf[1].Payload.canonicalURL 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[1] = false 예
$.oneOf[0].allOf[1].Payload.category 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].slugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].seoSlugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].titlePluralstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].jsonLDTypestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cityobject 예
$.oneOf[0].allOf[1].Payload.city.cityNamestring 예
$.oneOf[0].allOf[1].Payload.city.citySlugstring 예
$.oneOf[0].allOf[1].Payload.city.countryCodestring 예
$.oneOf[0].allOf[1].Payload.city.isoRegionstring 예
$.oneOf[0].allOf[1].Payload.city.imageURL512string 예
$.oneOf[0].allOf[1].Payload.city.canonicalURL 예
$.oneOf[0].allOf[1].Payload.city.canonicalURL.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.city.canonicalURL.anyOf[1] = false 예
$.oneOf[0].allOf[1].Payload.city.isRestrictedMarketboolean 예
$.oneOf[0].allOf[1].Payload.city.showRevenueMetricsboolean 예
$.oneOf[0].allOf[1].Payload.city.recentActivityobject 예
$.oneOf[0].allOf[1].Payload.city.recentActivity.windowHoursinteger 예
$.oneOf[0].allOf[1].Payload.city.recentActivity.peopleCountinteger 예
$.oneOf[0].allOf[1].Payload.venuesarray 예
$.oneOf[0].allOf[1].Payload.venues[]object 아니요
$.oneOf[0].allOf[1].Payload.venues[].rankinteger 예
$.oneOf[0].allOf[1].Payload.venues[].locationIDinteger 예
$.oneOf[0].allOf[1].Payload.venues[].ratingCountinteger 예
$.oneOf[0].allOf[1].Payload.venues[].externalRatingCountinteger 예
$.oneOf[0].allOf[1].Payload.venues[].locationAliasstring 예
$.oneOf[0].allOf[1].Payload.venues[].tickerCodestring 예
$.oneOf[0].allOf[1].Payload.venues[].namestring 예
$.oneOf[0].allOf[1].Payload.venues[].cityNamestring 예
$.oneOf[0].allOf[1].Payload.venues[].stateShortstring 예
$.oneOf[0].allOf[1].Payload.venues[].countryShortstring 예
$.oneOf[0].allOf[1].Payload.venues[].addressStringstring 예
$.oneOf[0].allOf[1].Payload.venues[].categorySlugstring 예
$.oneOf[0].allOf[1].Payload.venues[].categoryDescriptorstring 예
$.oneOf[0].allOf[1].Payload.venues[].categoryIconstring 예
$.oneOf[0].allOf[1].Payload.venues[].categoryJsonLDTypestring 예
$.oneOf[0].allOf[1].Payload.venues[].imageURL256string 예
$.oneOf[0].allOf[1].Payload.venues[].imageURL512string 예
$.oneOf[0].allOf[1].Payload.venues[].imageColorstring 예
$.oneOf[0].allOf[1].Payload.venues[].communitySnippetstring 예
$.oneOf[0].allOf[1].Payload.venues[].communitySnippetURLstring 예
$.oneOf[0].allOf[1].Payload.venues[].profileURLstring 예
$.oneOf[0].allOf[1].Payload.venues[].coordinates 예
$.oneOf[0].allOf[1].Payload.venues[].coordinates.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.venues[].coordinates.anyOf[0].latitudenumber 예
$.oneOf[0].allOf[1].Payload.venues[].coordinates.anyOf[0].longitudenumber 예
$.oneOf[0].allOf[1].Payload.venues[].coordinates.anyOf[1]array 예
$.oneOf[0].allOf[1].Payload.venues[].rating 예
$.oneOf[0].allOf[1].Payload.venues[].rating.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.venues[].rating.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].externalRating 예
$.oneOf[0].allOf[1].Payload.venues[].externalRating.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.venues[].externalRating.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].priceLevel 예
$.oneOf[0].allOf[1].Payload.venues[].priceLevel.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].priceLevel.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].rating 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].rating.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].rating.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].ratingCountinteger 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].postCountinteger 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].latestPostTextstring 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].latestPostURLstring 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].reviewBoardNamestring 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].reviewBoardURLstring 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].latestPostTitlestring 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].latestPostAuthorAliasstring 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].latestPostCreatedDatestring 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].latestBoardNamestring 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].latestBoardURLstring 예
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].minimumRatingCountinteger 아니요
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[0].hasPublicRatingboolean 아니요
$.oneOf[0].allOf[1].Payload.venues[].communityContext.anyOf[1]array 예
$.oneOf[0].allOf[1].Payload.venues[].showRevenueMetricsboolean 예
$.oneOf[0].allOf[1].Payload.venues[].isRestrictedByRegulationboolean 예
$.oneOf[0].allOf[1].Payload.venues[].userTrades 예
$.oneOf[0].allOf[1].Payload.venues[].userTrades.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].userTrades.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].bidsLast30Day 예
$.oneOf[0].allOf[1].Payload.venues[].bidsLast30Day.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].bidsLast30Day.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].avgPrice 예
$.oneOf[0].allOf[1].Payload.venues[].avgPrice.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].avgPrice.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].visualInitialstring 예
$.oneOf[0].allOf[1].Payload.venues[].visualPrimaryColorstring 예
$.oneOf[0].allOf[1].Payload.venues[].visualSecondaryColorstring 예
$.oneOf[0].allOf[1].Payload.venues[].visualTextColorstring 예
$.oneOf[0].allOf[1].Payload.venues[].ugcImageURL256string 예
$.oneOf[0].allOf[1].Payload.venues[].ugcImageURL512string 예
$.oneOf[0].allOf[1].Payload.venues[].visualImageURL256string 예
$.oneOf[0].allOf[1].Payload.venues[].visualImageURL512string 예
$.oneOf[0].allOf[1].Payload.venues[].visualDisplayImageURL256string 예
$.oneOf[0].allOf[1].Payload.venues[].visualDisplayImageURL512string 예
$.oneOf[0].allOf[1].Payload.venues[].visualImageIsUGCboolean 예
$.oneOf[0].allOf[1].Payload.venues[].visualDisplayImageSourcestring ["fallback","ugc","generated"] 예
$.oneOf[0].allOf[1].Payload.venues[].streetNumberstring 예
$.oneOf[0].allOf[1].Payload.venues[].streetstring 예
$.oneOf[0].allOf[1].Payload.venues[].zipstring 예
$.oneOf[0].allOf[1].Payload.venues[].ratingSourcestring 예
$.oneOf[0].allOf[1].Payload.venues[].addedByUserAliasstring 예
$.oneOf[0].allOf[1].Payload.venues[].addedYearMonthstring 예
$.oneOf[0].allOf[1].Payload.venues[].mentionURLstring 예
$.oneOf[0].allOf[1].Payload.venues[].localRankinteger 예
$.oneOf[0].allOf[1].Payload.venues[].rankDelta30Day 예
$.oneOf[0].allOf[1].Payload.venues[].rankDelta30Day.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].rankDelta30Day.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].priorRank 예
$.oneOf[0].allOf[1].Payload.venues[].priorRank.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].priorRank.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeDataobject 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.1d 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.1d.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.1d.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.7d 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.7d.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.7d.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.30d 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.30d.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.30d.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.3mo 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.3mo.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.3mo.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.12mo 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.12mo.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.venues[].rankChangeData.12mo.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.venues[].recentViewsinteger 예
$.oneOf[0].allOf[1].Payload.pageSizeinteger 예
$.oneOf[0].allOf[1].Payload.pageNumberinteger 예
$.oneOf[0].allOf[1].Payload.dateRangestring ["7d","30d","90d","180d","365d"] 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_city_hot_list",
    "RequestUserAlias": "example-user",
    "Payload": {
        "categorySlug": "synthetic-example",
        "resolvedCategorySlug": "synthetic-example",
        "seoCategorySlug": "synthetic-example",
        "categoryTitlePlural": "synthetic-example",
        "canonicalURL": "synthetic-example",
        "category": {
            "id": 0,
            "slug": "synthetic-example",
            "seoSlug": "synthetic-example",
            "name": "synthetic-example",
            "titlePlural": "synthetic-example",
            "jsonLDType": "synthetic-example"
        },
        "city": {
            "cityName": "synthetic-example",
            "citySlug": "synthetic-example",
            "countryCode": "synthetic-example",
            "isoRegion": "synthetic-example",
            "imageURL512": "synthetic-example",
            "canonicalURL": "synthetic-example",
            "isRestrictedMarket": false,
            "showRevenueMetrics": false,
            "recentActivity": {
                "windowHours": 0,
                "peopleCount": 0
            }
        },
        "venues": [],
        "pageSize": 0,
        "pageNumber": 0,
        "dateRange": "7d"
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_continent_country_top

#
Returns the top cities of an editorial continent, grouped by country. Editorial continents are: NA (North America incl. Canada/Mexico), EU (Europe), AS (Asia, excluding Middle East), MEA (Middle East & Africa), SA (South America), OC (Oceania).

매개변수

이름유형필수기본값설명
continent string 예 — Editorial continent code: NA, EU, AS, MEA, SA, OC.
pageSize int 아니요 100 Number of cities (1-100).
categorySlug string 아니요 "" Optional category filter.
dateRange string 아니요 "90d" Activity window.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_continent_country_top' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'continent={{continent}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'categorySlug={{categorySlug}}' \
  --data-urlencode 'dateRange={{dateRange}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_continent_country_top_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.categorySlugstring 예
$.oneOf[0].allOf[1].Payload.resolvedCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.seoCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.categoryTitlePluralstring 예
$.oneOf[0].allOf[1].Payload.canonicalURL 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[1] = false 예
$.oneOf[0].allOf[1].Payload.category 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].slugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].seoSlugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].titlePluralstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].jsonLDTypestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.continentstring ["NA","EU","AS","MEA","SA","OC"] 예
$.oneOf[0].allOf[1].Payload.countriesarray 예
$.oneOf[0].allOf[1].Payload.countries[]object 아니요
$.oneOf[0].allOf[1].Payload.countries[].countryCodestring 예
$.oneOf[0].allOf[1].Payload.countries[].countryNamestring 예
$.oneOf[0].allOf[1].Payload.countries[].citiesarray 예
$.oneOf[0].allOf[1].Payload.countries[].cities[]object 아니요
$.oneOf[0].allOf[1].Payload.countries[].cities[].citySlugstring 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].cityNamestring 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].stateShortstring 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].isoRegionstring 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].countryCodestring 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].countryNamestring 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].continentShortstring 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].imageURL256string 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].imageURL512string 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].detailURLstring 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].tradingActivity30Dayinteger 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].numberTransactionsinteger 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].venueCountinteger 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].rankinteger 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].isHotboolean 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].avgTradingPrice 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].avgTradingPrice.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].avgTradingPrice.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].coordinatesobject 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].coordinates.latitude 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].coordinates.latitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].coordinates.latitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].coordinates.longitude 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].coordinates.longitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].coordinates.longitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.countries[].cities[].distanceMetersnumber 아니요
$.oneOf[0].allOf[1].Payload.countries[].cities[].distanceMilesnumber 아니요
$.oneOf[0].allOf[1].Payload.totalCitiesinteger 예
$.oneOf[0].allOf[1].Payload.dateRangestring ["7d","30d","90d","180d","365d"] 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_continent_country_top",
    "RequestUserAlias": "example-user",
    "Payload": {
        "categorySlug": "synthetic-example",
        "resolvedCategorySlug": "synthetic-example",
        "seoCategorySlug": "synthetic-example",
        "categoryTitlePlural": "synthetic-example",
        "canonicalURL": "synthetic-example",
        "category": {
            "id": 0,
            "slug": "synthetic-example",
            "seoSlug": "synthetic-example",
            "name": "synthetic-example",
            "titlePlural": "synthetic-example",
            "jsonLDType": "synthetic-example"
        },
        "continent": "NA",
        "countries": [],
        "totalCities": 0,
        "dateRange": "7d"
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_highest_converting_locations

#
Returns the best converting venues, indicating the most demand for listings

매개변수

이름유형필수기본값설명
pageSize int 아니요 25 Defines how many results will be return per request
pageNumber int 아니요 0 Defines which page should be returned
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_highest_converting_locations' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'pageNumber={{pageNumber}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_highest_converting_locations_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.ATResponseObjectType = "NestedKeyValueList" 예
$.oneOf[0].allOf[1].Payload.ResponseBodyobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.Namestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformationarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[]object 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].locationAliasstring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayViewToTransactionConversionBasisPoints 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayViewToTransactionConversionBasisPoints.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayViewToTransactionConversionBasisPoints.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayViewToTransactionConversionBasisPoints.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayViewToTransactionConversionBasisPoints.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberTransactions 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberTransactions.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberTransactions.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberTransactions.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberTransactions.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldList[]string 아니요
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_highest_converting_locations",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ATResponseObjectType": "NestedKeyValueList",
        "ResponseBody": {
            "Name": "synthetic-example",
            "MetaInformation": [],
            "KeyValueList": [],
            "KeyValueFieldList": []
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_map_points

#
Returns signed-in Market Data map points for overview and city Hot List map panels.

매개변수

이름유형필수기본값설명
scope string 아니요 "overview" overview or city.
citySlug string 아니요 "" CloseByCitySlug when scope=city.
west float 아니요 -180 Viewport west longitude.
south float 아니요 -85 Viewport south latitude.
east float 아니요 180 Viewport east longitude.
north float 아니요 85 Viewport north latitude.
zoom int 아니요 2 Current map zoom. Below 6 returns city points; 6 and above returns location points.
pageSize int 아니요 200 Number of points to return (1-300).
categorySlug string 아니요 "" Optional category filter.
dateRange string 아니요 "90d" Activity window: 7d, 30d, 90d, 180d, 365d.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_map_points' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'scope={{scope}}' \
  --data-urlencode 'citySlug={{citySlug}}' \
  --data-urlencode 'west={{west}}' \
  --data-urlencode 'south={{south}}' \
  --data-urlencode 'east={{east}}' \
  --data-urlencode 'north={{north}}' \
  --data-urlencode 'zoom={{zoom}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'categorySlug={{categorySlug}}' \
  --data-urlencode 'dateRange={{dateRange}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_map_points_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.categorySlugstring 예
$.oneOf[0].allOf[1].Payload.resolvedCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.seoCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.categoryTitlePluralstring 예
$.oneOf[0].allOf[1].Payload.canonicalURL 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[1] = false 예
$.oneOf[0].allOf[1].Payload.category 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].slugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].seoSlugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].titlePluralstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].jsonLDTypestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.modestring ["cities","locations"] 예
$.oneOf[0].allOf[1].Payload.scopestring ["overview","city"] 예
$.oneOf[0].allOf[1].Payload.citySlugstring 예
$.oneOf[0].allOf[1].Payload.citiesarray 예
$.oneOf[0].allOf[1].Payload.cities[]object 아니요
$.oneOf[0].allOf[1].Payload.cities[].citySlugstring 예
$.oneOf[0].allOf[1].Payload.cities[].cityNamestring 예
$.oneOf[0].allOf[1].Payload.cities[].stateShortstring 예
$.oneOf[0].allOf[1].Payload.cities[].isoRegionstring 예
$.oneOf[0].allOf[1].Payload.cities[].countryCodestring 예
$.oneOf[0].allOf[1].Payload.cities[].countryNamestring 예
$.oneOf[0].allOf[1].Payload.cities[].continentShortstring 예
$.oneOf[0].allOf[1].Payload.cities[].imageURL256string 예
$.oneOf[0].allOf[1].Payload.cities[].imageURL512string 예
$.oneOf[0].allOf[1].Payload.cities[].detailURLstring 예
$.oneOf[0].allOf[1].Payload.cities[].tradingActivity30Dayinteger 예
$.oneOf[0].allOf[1].Payload.cities[].numberTransactionsinteger 예
$.oneOf[0].allOf[1].Payload.cities[].venueCountinteger 예
$.oneOf[0].allOf[1].Payload.cities[].rankinteger 예
$.oneOf[0].allOf[1].Payload.cities[].avgTradingPrice 예
$.oneOf[0].allOf[1].Payload.cities[].avgTradingPrice.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.cities[].avgTradingPrice.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cities[].coordinatesobject 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.latitude 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.latitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.latitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.longitude 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.longitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.longitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cities[].distanceMetersnumber 아니요
$.oneOf[0].allOf[1].Payload.cities[].distanceMilesnumber 아니요
$.oneOf[0].allOf[1].Payload.cities[].regionLabelstring 예
$.oneOf[0].allOf[1].Payload.locationsarray 예
$.oneOf[0].allOf[1].Payload.locations[]object 아니요
$.oneOf[0].allOf[1].Payload.locations[].rankinteger 예
$.oneOf[0].allOf[1].Payload.locations[].locationIDinteger 예
$.oneOf[0].allOf[1].Payload.locations[].ratingCountinteger 예
$.oneOf[0].allOf[1].Payload.locations[].externalRatingCountinteger 예
$.oneOf[0].allOf[1].Payload.locations[].locationAliasstring 예
$.oneOf[0].allOf[1].Payload.locations[].tickerCodestring 예
$.oneOf[0].allOf[1].Payload.locations[].namestring 예
$.oneOf[0].allOf[1].Payload.locations[].cityNamestring 예
$.oneOf[0].allOf[1].Payload.locations[].stateShortstring 예
$.oneOf[0].allOf[1].Payload.locations[].countryShortstring 예
$.oneOf[0].allOf[1].Payload.locations[].closeByCitySlugstring 예
$.oneOf[0].allOf[1].Payload.locations[].addressStringstring 예
$.oneOf[0].allOf[1].Payload.locations[].categorySlugstring 예
$.oneOf[0].allOf[1].Payload.locations[].categoryDescriptorstring 예
$.oneOf[0].allOf[1].Payload.locations[].categoryIconstring 예
$.oneOf[0].allOf[1].Payload.locations[].categoryJsonLDTypestring 예
$.oneOf[0].allOf[1].Payload.locations[].imageURL256string 예
$.oneOf[0].allOf[1].Payload.locations[].imageURL512string 예
$.oneOf[0].allOf[1].Payload.locations[].imageColorstring 예
$.oneOf[0].allOf[1].Payload.locations[].communitySnippetstring 예
$.oneOf[0].allOf[1].Payload.locations[].communitySnippetURLstring 예
$.oneOf[0].allOf[1].Payload.locations[].profileURLstring 예
$.oneOf[0].allOf[1].Payload.locations[].cityDetailURLstring 예
$.oneOf[0].allOf[1].Payload.locations[].coordinatesobject 예
$.oneOf[0].allOf[1].Payload.locations[].coordinates.latitudenumber 예
$.oneOf[0].allOf[1].Payload.locations[].coordinates.longitudenumber 예
$.oneOf[0].allOf[1].Payload.locations[].rating 예
$.oneOf[0].allOf[1].Payload.locations[].rating.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.locations[].rating.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.locations[].externalRating 예
$.oneOf[0].allOf[1].Payload.locations[].externalRating.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.locations[].externalRating.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.locations[].priceLevel 예
$.oneOf[0].allOf[1].Payload.locations[].priceLevel.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.locations[].priceLevel.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.locations[].communityContextobject 예
$.oneOf[0].allOf[1].Payload.locations[].communityContext.rating 예
$.oneOf[0].allOf[1].Payload.locations[].communityContext.rating.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.locations[].communityContext.rating.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.locations[].communityContext.ratingCountinteger 예
$.oneOf[0].allOf[1].Payload.locations[].communityContext.postCountinteger 예
$.oneOf[0].allOf[1].Payload.locations[].communityContext.latestPostTextstring 예
$.oneOf[0].allOf[1].Payload.locations[].communityContext.latestPostURLstring 예
$.oneOf[0].allOf[1].Payload.locations[].communityContext.reviewBoardNamestring 예
$.oneOf[0].allOf[1].Payload.locations[].communityContext.reviewBoardURLstring 예
$.oneOf[0].allOf[1].Payload.locations[].showRevenueMetricsboolean 예
$.oneOf[0].allOf[1].Payload.locations[].isRestrictedByRegulationboolean 예
$.oneOf[0].allOf[1].Payload.locations[].userTrades 예
$.oneOf[0].allOf[1].Payload.locations[].userTrades.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.locations[].userTrades.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.locations[].bidsLast30Day 예
$.oneOf[0].allOf[1].Payload.locations[].bidsLast30Day.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.locations[].bidsLast30Day.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.locations[].avgPrice 예
$.oneOf[0].allOf[1].Payload.locations[].avgPrice.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.locations[].avgPrice.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.locations[].visualInitialstring 예
$.oneOf[0].allOf[1].Payload.locations[].visualPrimaryColorstring 예
$.oneOf[0].allOf[1].Payload.locations[].visualSecondaryColorstring 예
$.oneOf[0].allOf[1].Payload.locations[].visualTextColorstring 예
$.oneOf[0].allOf[1].Payload.locations[].ugcImageURL256string 예
$.oneOf[0].allOf[1].Payload.locations[].ugcImageURL512string 예
$.oneOf[0].allOf[1].Payload.locations[].visualImageURL256string 예
$.oneOf[0].allOf[1].Payload.locations[].visualImageURL512string 예
$.oneOf[0].allOf[1].Payload.locations[].visualDisplayImageURL256string 예
$.oneOf[0].allOf[1].Payload.locations[].visualDisplayImageURL512string 예
$.oneOf[0].allOf[1].Payload.locations[].visualImageIsUGCboolean 예
$.oneOf[0].allOf[1].Payload.locations[].visualDisplayImageSourcestring ["fallback","ugc","generated"] 예
$.oneOf[0].allOf[1].Payload.viewportobject 예
$.oneOf[0].allOf[1].Payload.viewport.westnumber 예
$.oneOf[0].allOf[1].Payload.viewport.southnumber 예
$.oneOf[0].allOf[1].Payload.viewport.eastnumber 예
$.oneOf[0].allOf[1].Payload.viewport.northnumber 예
$.oneOf[0].allOf[1].Payload.viewport.zoomnumber 예
$.oneOf[0].allOf[1].Payload.totalResultsinteger 예
$.oneOf[0].allOf[1].Payload.dateRangestring ["7d","30d","90d","180d","365d"] 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_map_points",
    "RequestUserAlias": "example-user",
    "Payload": {
        "categorySlug": "synthetic-example",
        "resolvedCategorySlug": "synthetic-example",
        "seoCategorySlug": "synthetic-example",
        "categoryTitlePlural": "synthetic-example",
        "canonicalURL": "synthetic-example",
        "category": {
            "id": 0,
            "slug": "synthetic-example",
            "seoSlug": "synthetic-example",
            "name": "synthetic-example",
            "titlePlural": "synthetic-example",
            "jsonLDType": "synthetic-example"
        },
        "mode": "cities",
        "scope": "overview",
        "citySlug": "synthetic-example",
        "cities": [],
        "locations": [],
        "viewport": {
            "west": 0,
            "south": 0,
            "east": 0,
            "north": 0,
            "zoom": 0
        },
        "totalResults": 0,
        "dateRange": "7d"
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_most_bids_least_asks

#
Returns locations with the highest bids vs listing ratio

매개변수

이름유형필수기본값설명
pageSize int 아니요 25 Defines how many results will be return per request
pageNumber int 아니요 0 Defines which page should be returned
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_most_bids_least_asks' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'pageNumber={{pageNumber}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_most_bids_least_asks_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.ATResponseObjectType = "NestedKeyValueList" 예
$.oneOf[0].allOf[1].Payload.ResponseBodyobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.Namestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformationarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[]object 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].locationAliasstring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldList[]string 아니요
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_most_bids_least_asks",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ATResponseObjectType": "NestedKeyValueList",
        "ResponseBody": {
            "Name": "synthetic-example",
            "MetaInformation": [],
            "KeyValueList": [],
            "KeyValueFieldList": []
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_most_underserved_locations

#
Returns locations with the most bids and the least number of listings in the past 30 days

매개변수

이름유형필수기본값설명
pageSize int 아니요 25 Defines how many results will be return per request
pageNumber int 아니요 0 Defines which page should be returned
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_most_underserved_locations' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'pageNumber={{pageNumber}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_most_underserved_locations_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.ATResponseObjectType = "NestedKeyValueList" 예
$.oneOf[0].allOf[1].Payload.ResponseBodyobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.Namestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformationarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[]object 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].locationAliasstring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30dayNumberBids.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings = 0 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldList[]string 아니요
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_most_underserved_locations",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ATResponseObjectType": "NestedKeyValueList",
        "ResponseBody": {
            "Name": "synthetic-example",
            "MetaInformation": [],
            "KeyValueList": [],
            "KeyValueFieldList": []
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_most_viewed_locations_with_least_listings

#
Returns the most viewed locations with the least amount of listings

매개변수

이름유형필수기본값설명
pageSize int 아니요 25 Defines how many results will be return per request
pageNumber int 아니요 0 Defines which page should be returned
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_most_viewed_locations_with_least_listings' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'pageNumber={{pageNumber}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_most_viewed_locations_with_least_listings_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.ATResponseObjectType = "NestedKeyValueList" 예
$.oneOf[0].allOf[1].Payload.ResponseBodyobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.Namestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformationarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[]object 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].locationAliasstring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberListings.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldList[]string 아니요
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_most_viewed_locations_with_least_listings",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ATResponseObjectType": "NestedKeyValueList",
        "ResponseBody": {
            "Name": "synthetic-example",
            "MetaInformation": [],
            "KeyValueList": [],
            "KeyValueFieldList": []
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_recently_viewed

#
Returns signed-in caller-scoped recently viewed listings, marketplace locations, cities, communities, profiles, plus viewer-owned My Bookings and active request tiles when available. Public-by-design: anonymous callers do not read session/IP recently viewed history and receive the trending fallback instead. Signed-in callers receive only their own user-scoped history, caller-owned plan and pending-request summaries, and profile views recorded for that caller. It exposes no private history, plans, or requests for other users.

매개변수

이름유형필수기본값설명
pageSize int 아니요 12 Number of recently viewed items to return (1-20).
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_recently_viewed' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'pageSize={{pageSize}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_recently_viewed_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.itemsarray 예
$.oneOf[0].allOf[1].Payload.items[] 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[0]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].idstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].subtitlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].typeLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].iconTextstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].url 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].url.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].url.anyOf[1] = false 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].lastViewIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].type = "city" 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].cityobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.citySlugstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.cityNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.stateShortstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.isoRegionstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.countryCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.countryNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.continentShortstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.detailURLstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.tradingActivity30Dayinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.numberTransactionsinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.venueCountinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.avgTradingPrice 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.avgTradingPrice.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.avgTradingPrice.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.coordinatesobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.coordinates.latitude 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.coordinates.latitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.coordinates.latitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.coordinates.longitude 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.coordinates.longitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.coordinates.longitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.distanceMetersnumber 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].city.distanceMilesnumber 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[0].isFallback = true 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[1]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].idstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].subtitlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].typeLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].iconTextstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].urlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].lastViewIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualInitialstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualPrimaryColorstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualSecondaryColorstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualTextColorstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].ugcImageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].ugcImageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualImageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualImageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualDisplayImageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualDisplayImageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualImageIsUGCboolean 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].visualDisplayImageSourcestring ["fallback","ugc","generated"] 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].type = "location" 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].tickerCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].locationobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.locationIDDatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.locationID.oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.locationID.oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.namestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.aliasstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.ticker 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.ticker.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.ticker.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.cityNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.stateShortstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.countryCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.citySlug 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.citySlug.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.citySlug.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.imageBasePath 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.imageBasePath.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.imageBasePath.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.lastViewIDDatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.lastViewID.oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.lastViewID.oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].location.lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[1].isRestrictedByRegulationboolean 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].idstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].subtitlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].typeLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].iconTextstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].urlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].lastViewIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualInitialstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualPrimaryColorstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualSecondaryColorstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualTextColorstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].ugcImageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].ugcImageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualImageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualImageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualDisplayImageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualDisplayImageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualImageIsUGCboolean 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].visualDisplayImageSourcestring ["fallback","ugc","generated"] 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].type = "listing" 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].discussionPostIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].discussionPostUrlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].discussionCommentCountinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].tickerCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listingobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.appointmentIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.locationIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.discussionPostIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.listingUUIDstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.locationNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.locationAliasstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.locationTickerstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.inventoryTypeNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.datestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.dateLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.timestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.cityNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.citySlugstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].listing.discussionPostUrlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[2].isRestrictedByRegulationboolean 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].idstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].subtitlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].typeLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].iconTextstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].urlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].lastViewIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].type = "board" 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].pillsarray 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].pills[]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].pills[].labelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].boardobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.boardIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.namestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.boardTypestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.urlAliasstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.urlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.cityNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.citySlugstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.stateShortstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.countryCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.imageRolestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.isRestrictedinteger [0,1] 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.viewerCanReadinteger [0,1] 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.viewerCanWriteinteger [0,1] 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.imageFrame 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.imageFrame.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.imageFrame.anyOf[0].positionXPercentnumber 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.imageFrame.anyOf[0].positionYPercentnumber 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.imageFrame.anyOf[0].zoomPercentnumber 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.imageFrame.anyOf[1]array 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].board.lastViewIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].isRestrictedboolean 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].viewerCanReadboolean 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[3].viewerCanWriteboolean 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].idstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].subtitlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].typeLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].iconTextstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].urlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].lastViewIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].type = "profile" 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profileobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.userIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.aliasstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.avatarEmojistring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileURLstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].mediaTypestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].widthinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].heightinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].isImageboolean 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].frameobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].frame.positionXPercentnumber 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].frame.positionYPercentnumber 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].frame.zoomPercentnumber 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[0].backgroundUrlstring 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[4].profile.profileImage.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].idstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].subtitlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].typeLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].iconTextstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].urlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].lastViewIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].type = "plans" 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plansobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.appointmentIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.locationIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.locationNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.datestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.cityCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.upcomingCitiesarray 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.upcomingCities[]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.upcomingCities[].labelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.upcomingCities[].countinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.upcomingCities[].cityLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.upcomingCities[].cityCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].plans.upcomingCities[].cityNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].pillsarray 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].pills[]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].pills[].labelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].pills[].countinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].pills[].cityLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].pills[].cityCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[5].pills[].cityNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].idstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].subtitlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].typeLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].iconTextstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].urlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].lastViewIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].type = "requests" 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].requestsobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].requests.countinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].requests.primaryBidIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].requests.primaryPostIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].requests.locationIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].requests.locationNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].requests.dateLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].requests.cityLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].pillsarray 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].pills[]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].pills[].labelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].pills[].countinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[6].pills[].cityLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].idstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].subtitlestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].typeLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].imageURL256string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].imageURL512string 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].iconTextstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].lastViewedAtstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].urlstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].lastViewIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].type = "plans_requests" 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plansobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.appointmentIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.locationIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.locationNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.datestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.cityCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.upcomingCitiesarray 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.upcomingCities[]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.upcomingCities[].labelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.upcomingCities[].countinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.upcomingCities[].cityLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.upcomingCities[].cityCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].plans.upcomingCities[].cityNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].requestsobject 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].requests.countinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].requests.primaryBidIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].requests.primaryPostIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].requests.locationIDinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].requests.locationNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].requests.dateLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].requests.cityLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pillsarray 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[] 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[0]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[0].labelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[0].countinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[0].cityLabelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[0].cityCodestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[0].cityNamestring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[1]object 아니요
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[1].labelstring 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[1].countinteger 예
$.oneOf[0].allOf[1].Payload.items[].oneOf[7].pills[].anyOf[1].cityLabelstring 예
$.oneOf[0].allOf[1].Payload.totalResultsinteger 예
$.oneOf[0].allOf[1].Payload.sourcestring ["history","trending_nearby","trending_world","empty"] 예
$.oneOf[0].allOf[1].Payload.closestCityobject 예
$.oneOf[0].allOf[1].Payload.closestCity.namestring 예
$.oneOf[0].allOf[1].Payload.closestCity.slugstring 예
$.oneOf[0].allOf[1].Payload.closestCity.countryCodestring 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_recently_viewed",
    "RequestUserAlias": "example-user",
    "Payload": {
        "items": [],
        "totalResults": 0,
        "source": "history",
        "closestCity": {
            "name": "synthetic-example",
            "slug": "synthetic-example",
            "countryCode": "synthetic-example"
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_required_inventory_forecast

#
Returns inventory that may have high chance of selling based on historical data

매개변수

이름유형필수기본값설명
locationAlias string 예 — Slug found after the slash when opening a location in the portal
dateRangeStart string 예 — oldest date of metrics to be reported Date format: YYYY-MM-DD
dateRangeEnd string 예 — latest date of metrics to be reported Date format: YYYY-MM-DD
additionalLocationAliasSourceList string 아니요 "" Comma separated List of other locations that should be used as a data source for the forecast, related locations can be found at /v1/location/get_related_location_list
maximumPrice int 아니요 0 Items to exclude based on price
desiredProfitBasisPoints int 아니요 10000 defines how much profit should be made per line item
pageSize int 아니요 1500 Defines how many results will be return per request
pageNumber int 아니요 0 Defines which page should be returned
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_required_inventory_forecast' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'locationAlias={{locationAlias}}' \
  --data-urlencode 'dateRangeStart={{dateRangeStart}}' \
  --data-urlencode 'dateRangeEnd={{dateRangeEnd}}' \
  --data-urlencode 'additionalLocationAliasSourceList={{additionalLocationAliasSourceList}}' \
  --data-urlencode 'maximumPrice={{maximumPrice}}' \
  --data-urlencode 'desiredProfitBasisPoints={{desiredProfitBasisPoints}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'pageNumber={{pageNumber}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_required_inventory_forecast_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.ATResponseObjectType = "NestedKeyValueList" 예
$.oneOf[0].allOf[1].Payload.ResponseBodyobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.Namestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformationobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation.yearOverYearAverageMarketPriceChangenumber 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation.totalNumberSuggestedTransactions = 0 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation.totalNumberSuggestedBids = 0 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation.totalNumberSuggestedListingPurchases = 0 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation.totalSuggestedDollarVolume = 0 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*object 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*object 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*object 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*object 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.numberHistoricalTransactionsinteger 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.currentNumberBidsinteger 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.currentHighBidinteger 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.currentLowBidinteger 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.currentBidVolumeinteger 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.currentNumberListingsinteger 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.currentListingHighPriceinteger 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.currentListingLowPriceinteger 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.currentListingAveragePriceinteger 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.averagePricenumber 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.minimumPricenumber 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.maximumPricenumber 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.totalDemandnumber 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].CreatedDatestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].LastUpdateDatestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].Namestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].Descriptionstring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].URLstring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].Icon 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].Icon.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].Icon.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].event-locationAlias 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].event-locationAlias.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].event-locationAlias.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].EffectRadiusInMeters 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].EffectRadiusInMeters.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].EffectRadiusInMeters.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].EffectRadiusInMeters.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].EffectRadiusInMeters.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].ThisPeriodTimeFrameobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].ThisPeriodTimeFrame.StartTime 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].ThisPeriodTimeFrame.StartTime.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].ThisPeriodTimeFrame.StartTime.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].ThisPeriodTimeFrame.EndTime 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].ThisPeriodTimeFrame.EndTime.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].ThisPeriodTimeFrame.EndTime.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].LastPeriodTimeFrameobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].LastPeriodTimeFrame.StartTimestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[0].LastPeriodTimeFrame.EndTimestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.specialEventInformation.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.sourceDataLocationAliasListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.sourceDataLocationAliasList[]string 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.lastYearsCorrespondingDayListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[0].*.*.*.*.lastYearsCorrespondingDayList[]string 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList.anyOf[1]array 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldListarray 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_required_inventory_forecast",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ATResponseObjectType": "NestedKeyValueList",
        "ResponseBody": {
            "Name": "synthetic-example",
            "MetaInformation": {
                "yearOverYearAverageMarketPriceChange": 0,
                "totalNumberSuggestedTransactions": 0,
                "totalNumberSuggestedBids": 0,
                "totalNumberSuggestedListingPurchases": 0,
                "totalSuggestedDollarVolume": 0
            },
            "KeyValueList": [],
            "KeyValueFieldList": []
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_toplist

#
Returns locations with the most bids and the least number of listings in the past 30 days

매개변수

이름유형필수기본값설명
cityCode string 아니요 "" The code of the City that is being queried If left empty worldwide results are being returned Exemplary Value: NYC
categorySlug string 아니요 "" The slug of the location category that is being requested. If left empty all categories are being returned. Exemplary Value: restaurants
pageSize int 아니요 25 Defines how many results will be return per request
pageNumber int 아니요 0 Defines which page should be returned
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_toplist' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'cityCode={{cityCode}}' \
  --data-urlencode 'categorySlug={{categorySlug}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'pageNumber={{pageNumber}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_toplist_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.ATResponseObjectType = "NestedKeyValueList" 예
$.oneOf[0].allOf[1].Payload.ResponseBodyobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.Namestring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformationobject 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation.TotalNumberLocationsDatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation.TotalNumberLocations.oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation.TotalNumberLocations.oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[]object 아니요
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].locationAliasstring 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberBids 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberBids.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberBids.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberBids.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayNumberBids.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].30DayATPageViews.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].GlobalATRank 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].GlobalATRank.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].GlobalATRank.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].GlobalATRank.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].GlobalATRank.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].LocalATRank 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].LocalATRank.anyOf[0]DatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].LocalATRank.anyOf[0].oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].LocalATRank.anyOf[0].oneOf[1]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].LocalATRank.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].GlobalATRankChangeData 예Pipe-separated changes for 1 day, 7 days, 30 days, 3 months and 12 months; empty segments mean unavailable.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].GlobalATRankChangeData.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].GlobalATRankChangeData.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].LocalATRankChangeData 예Pipe-separated changes for 1 day, 7 days, 30 days, 3 months and 12 months; empty segments mean unavailable.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].LocalATRankChangeData.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].LocalATRankChangeData.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldListarray 예
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldList[]string 아니요
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_toplist",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ATResponseObjectType": "NestedKeyValueList",
        "ResponseBody": {
            "Name": "synthetic-example",
            "MetaInformation": {
                "TotalNumberLocations": 0
            },
            "KeyValueList": [],
            "KeyValueFieldList": []
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_trending_near

#
Returns the cities trending closest to a given lat/long. Resolves the closest city via ATAirport proximity, then returns cities within that city's continent ordered by distance, using activity as the tie-breaker. Used by the Market Data page's "Trending near you" row.

매개변수

이름유형필수기본값설명
lat float 예 — Latitude in decimal degrees.
long float 예 — Longitude in decimal degrees.
pageSize int 아니요 4 Number of cities to return (1-20).
categorySlug string 아니요 "" Optional category filter.
dateRange string 아니요 "90d" Activity window.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_trending_near' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'lat={{lat}}' \
  --data-urlencode 'long={{long}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'categorySlug={{categorySlug}}' \
  --data-urlencode 'dateRange={{dateRange}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_trending_near_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.categorySlugstring 예
$.oneOf[0].allOf[1].Payload.resolvedCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.seoCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.categoryTitlePluralstring 예
$.oneOf[0].allOf[1].Payload.canonicalURL 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[1] = false 예
$.oneOf[0].allOf[1].Payload.category 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].slugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].seoSlugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].titlePluralstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].jsonLDTypestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.citiesarray 예
$.oneOf[0].allOf[1].Payload.cities[]object 아니요
$.oneOf[0].allOf[1].Payload.cities[].citySlugstring 예
$.oneOf[0].allOf[1].Payload.cities[].cityNamestring 예
$.oneOf[0].allOf[1].Payload.cities[].stateShortstring 예
$.oneOf[0].allOf[1].Payload.cities[].isoRegionstring 예
$.oneOf[0].allOf[1].Payload.cities[].countryCodestring 예
$.oneOf[0].allOf[1].Payload.cities[].countryNamestring 예
$.oneOf[0].allOf[1].Payload.cities[].continentShortstring 예
$.oneOf[0].allOf[1].Payload.cities[].imageURL256string 예
$.oneOf[0].allOf[1].Payload.cities[].imageURL512string 예
$.oneOf[0].allOf[1].Payload.cities[].detailURLstring 예
$.oneOf[0].allOf[1].Payload.cities[].tradingActivity30Dayinteger 예
$.oneOf[0].allOf[1].Payload.cities[].numberTransactionsinteger 예
$.oneOf[0].allOf[1].Payload.cities[].venueCountinteger 예
$.oneOf[0].allOf[1].Payload.cities[].rankinteger 예
$.oneOf[0].allOf[1].Payload.cities[].isHotboolean 예
$.oneOf[0].allOf[1].Payload.cities[].avgTradingPrice 예
$.oneOf[0].allOf[1].Payload.cities[].avgTradingPrice.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.cities[].avgTradingPrice.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cities[].coordinatesobject 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.latitude 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.latitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.latitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.longitude 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.longitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.longitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cities[].distanceMetersnumber 아니요
$.oneOf[0].allOf[1].Payload.cities[].distanceMilesnumber 아니요
$.oneOf[0].allOf[1].Payload.closestCityobject 예
$.oneOf[0].allOf[1].Payload.closestCity.namestring 예
$.oneOf[0].allOf[1].Payload.closestCity.slugstring 예
$.oneOf[0].allOf[1].Payload.closestCity.countryCodestring 예
$.oneOf[0].allOf[1].Payload.dateRangestring ["7d","30d","90d","180d","365d"] 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_trending_near",
    "RequestUserAlias": "example-user",
    "Payload": {
        "categorySlug": "synthetic-example",
        "resolvedCategorySlug": "synthetic-example",
        "seoCategorySlug": "synthetic-example",
        "categoryTitlePlural": "synthetic-example",
        "canonicalURL": "synthetic-example",
        "category": {
            "id": 0,
            "slug": "synthetic-example",
            "seoSlug": "synthetic-example",
            "name": "synthetic-example",
            "titlePlural": "synthetic-example",
            "jsonLDType": "synthetic-example"
        },
        "cities": [],
        "closestCity": {
            "name": "synthetic-example",
            "slug": "synthetic-example",
            "countryCode": "synthetic-example"
        },
        "dateRange": "7d"
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_wall_of_fame

#
Returns all public Wall of Fame leaderboards for the requested scope and timeframe. Public-by-design: Wall of Fame cards expose public user aliases, avatars, selected public profile/banner images, profile links, ranks, transaction counts, and rounded amount labels only. Raw transaction and bonus amounts stay internal to the cached ranking helper.

매개변수

이름유형필수기본값설명
scopeType string 아니요 "global" global, continent, or city.
scopeValue string 아니요 "" Continent code (NA, EU, AS, MEA, SA, OC) or airport-backed city slug when scopeType=city.
timeframe string 아니요 "today" today, yesterday, month, ytd, year, or alltime.
year int 아니요 0 Calendar year used when timeframe=year.
pageSize int 아니요 10 Entries per board (1-25).
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_wall_of_fame' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'scopeType={{scopeType}}' \
  --data-urlencode 'scopeValue={{scopeValue}}' \
  --data-urlencode 'timeframe={{timeframe}}' \
  --data-urlencode 'year={{year}}' \
  --data-urlencode 'pageSize={{pageSize}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_wall_of_fame_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.scopeobject 예
$.oneOf[0].allOf[1].Payload.scope.scopeTypestring ["global","continent","city"] 예
$.oneOf[0].allOf[1].Payload.scope.scopeValuestring 예
$.oneOf[0].allOf[1].Payload.scope.displayNamestring 예
$.oneOf[0].allOf[1].Payload.scope.labelKeystring 아니요
$.oneOf[0].allOf[1].Payload.scope.citySlugstring 아니요
$.oneOf[0].allOf[1].Payload.scope.countryCodestring 아니요
$.oneOf[0].allOf[1].Payload.scope.isoRegionstring 아니요
$.oneOf[0].allOf[1].Payload.timeframeobject 예
$.oneOf[0].allOf[1].Payload.timeframe.timeframestring ["today","yesterday","month","ytd","year","alltime"] 예
$.oneOf[0].allOf[1].Payload.timeframe.yearinteger 예
$.oneOf[0].allOf[1].Payload.timeframe.startDatestring 예
$.oneOf[0].allOf[1].Payload.timeframe.endDatestring 예
$.oneOf[0].allOf[1].Payload.timeframe.labelKeystring 예
$.oneOf[0].allOf[1].Payload.listsarray 예
$.oneOf[0].allOf[1].Payload.lists[]object 아니요
$.oneOf[0].allOf[1].Payload.lists[].listKeystring ["highest_transaction","most_volume_purchased","most_volume_sold","largest_concierge_bonus","most_generous_users"] 예
$.oneOf[0].allOf[1].Payload.lists[].labelKeystring 예
$.oneOf[0].allOf[1].Payload.lists[].labelstring 예
$.oneOf[0].allOf[1].Payload.lists[].descriptionKeystring 예
$.oneOf[0].allOf[1].Payload.lists[].descriptionstring 예
$.oneOf[0].allOf[1].Payload.lists[].countLabelKeystring 예
$.oneOf[0].allOf[1].Payload.lists[].countLabelstring 예
$.oneOf[0].allOf[1].Payload.lists[].rolestring ["buyer","seller"] 예
$.oneOf[0].allOf[1].Payload.lists[].metricstring ["single_transaction","total_volume","single_bonus","total_bonus"] 예
$.oneOf[0].allOf[1].Payload.pageSizeinteger 예
$.oneOf[0].allOf[1].Payload.boardsarray 예
$.oneOf[0].allOf[1].Payload.boards[]object 아니요
$.oneOf[0].allOf[1].Payload.boards[].listKeystring ["highest_transaction","most_volume_purchased","most_volume_sold","largest_concierge_bonus","most_generous_users"] 예
$.oneOf[0].allOf[1].Payload.boards[].labelKeystring 예
$.oneOf[0].allOf[1].Payload.boards[].labelstring 예
$.oneOf[0].allOf[1].Payload.boards[].descriptionKeystring 예
$.oneOf[0].allOf[1].Payload.boards[].descriptionstring 예
$.oneOf[0].allOf[1].Payload.boards[].countLabelKeystring 예
$.oneOf[0].allOf[1].Payload.boards[].countLabelstring 예
$.oneOf[0].allOf[1].Payload.boards[].rolestring ["buyer","seller"] 예
$.oneOf[0].allOf[1].Payload.boards[].metricstring ["single_transaction","total_volume","single_bonus","total_bonus"] 예
$.oneOf[0].allOf[1].Payload.boards[].entriesarray 예
$.oneOf[0].allOf[1].Payload.boards[].entries[]object 아니요
$.oneOf[0].allOf[1].Payload.boards[].entries[].rankinteger 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].userIDinteger 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].transactionCountinteger 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].aliasstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].avatarURLstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].avatarEmojistring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImageURLstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImageURLstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileURLstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].transactionCountLabelstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].amountLabelstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].mediaTypestring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].widthinteger 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].heightinteger 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].titlestring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].isImageboolean 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].frameobject 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].frame.positionXPercentnumber 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].frame.positionYPercentnumber 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].frame.zoomPercentnumber 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[0].backgroundUrlstring 아니요
$.oneOf[0].allOf[1].Payload.boards[].entries[].profileImage.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].mediaTypestring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].widthinteger 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].heightinteger 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].titlestring 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].isImageboolean 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].frameobject 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].frame.positionXPercentnumber 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].frame.positionYPercentnumber 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].frame.zoomPercentnumber 예
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[0].backgroundUrlstring 아니요
$.oneOf[0].allOf[1].Payload.boards[].entries[].bannerImage.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_wall_of_fame",
    "RequestUserAlias": "example-user",
    "Payload": {
        "scope": {
            "scopeType": "global",
            "scopeValue": "synthetic-example",
            "displayName": "synthetic-example"
        },
        "timeframe": {
            "timeframe": "today",
            "year": 0,
            "startDate": "synthetic-example",
            "endDate": "synthetic-example",
            "labelKey": "synthetic-example"
        },
        "lists": [],
        "pageSize": 0,
        "boards": []
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_wall_of_fame_list

#
Returns one public Wall of Fame leaderboard. Public-by-design: the response intentionally excludes exact raw cents and only emits rounded public amount labels plus public user identity fields and selected public profile/banner images.

매개변수

이름유형필수기본값설명
listKey string 아니요 "highest_transaction" highest_transaction, most_volume_purchased, most_volume_sold, largest_concierge_bonus, or most_generous_users.
scopeType string 아니요 "global" global, continent, or city.
scopeValue string 아니요 "" Continent code or airport-backed city slug.
timeframe string 아니요 "today" today, yesterday, month, ytd, year, or alltime.
year int 아니요 0 Calendar year used when timeframe=year.
pageSize int 아니요 10 Entries per board (1-25).
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_wall_of_fame_list' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listKey={{listKey}}' \
  --data-urlencode 'scopeType={{scopeType}}' \
  --data-urlencode 'scopeValue={{scopeValue}}' \
  --data-urlencode 'timeframe={{timeframe}}' \
  --data-urlencode 'year={{year}}' \
  --data-urlencode 'pageSize={{pageSize}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_wall_of_fame_list_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.scopeobject 예
$.oneOf[0].allOf[1].Payload.scope.scopeTypestring ["global","continent","city"] 예
$.oneOf[0].allOf[1].Payload.scope.scopeValuestring 예
$.oneOf[0].allOf[1].Payload.scope.displayNamestring 예
$.oneOf[0].allOf[1].Payload.scope.labelKeystring 아니요
$.oneOf[0].allOf[1].Payload.scope.citySlugstring 아니요
$.oneOf[0].allOf[1].Payload.scope.countryCodestring 아니요
$.oneOf[0].allOf[1].Payload.scope.isoRegionstring 아니요
$.oneOf[0].allOf[1].Payload.timeframeobject 예
$.oneOf[0].allOf[1].Payload.timeframe.timeframestring ["today","yesterday","month","ytd","year","alltime"] 예
$.oneOf[0].allOf[1].Payload.timeframe.yearinteger 예
$.oneOf[0].allOf[1].Payload.timeframe.startDatestring 예
$.oneOf[0].allOf[1].Payload.timeframe.endDatestring 예
$.oneOf[0].allOf[1].Payload.timeframe.labelKeystring 예
$.oneOf[0].allOf[1].Payload.listsarray 예
$.oneOf[0].allOf[1].Payload.lists[]object 아니요
$.oneOf[0].allOf[1].Payload.lists[].listKeystring ["highest_transaction","most_volume_purchased","most_volume_sold","largest_concierge_bonus","most_generous_users"] 예
$.oneOf[0].allOf[1].Payload.lists[].labelKeystring 예
$.oneOf[0].allOf[1].Payload.lists[].labelstring 예
$.oneOf[0].allOf[1].Payload.lists[].descriptionKeystring 예
$.oneOf[0].allOf[1].Payload.lists[].descriptionstring 예
$.oneOf[0].allOf[1].Payload.lists[].countLabelKeystring 예
$.oneOf[0].allOf[1].Payload.lists[].countLabelstring 예
$.oneOf[0].allOf[1].Payload.lists[].rolestring ["buyer","seller"] 예
$.oneOf[0].allOf[1].Payload.lists[].metricstring ["single_transaction","total_volume","single_bonus","total_bonus"] 예
$.oneOf[0].allOf[1].Payload.pageSizeinteger 예
$.oneOf[0].allOf[1].Payload.boardobject 예
$.oneOf[0].allOf[1].Payload.board.listKeystring ["highest_transaction","most_volume_purchased","most_volume_sold","largest_concierge_bonus","most_generous_users"] 예
$.oneOf[0].allOf[1].Payload.board.labelKeystring 예
$.oneOf[0].allOf[1].Payload.board.labelstring 예
$.oneOf[0].allOf[1].Payload.board.descriptionKeystring 예
$.oneOf[0].allOf[1].Payload.board.descriptionstring 예
$.oneOf[0].allOf[1].Payload.board.countLabelKeystring 예
$.oneOf[0].allOf[1].Payload.board.countLabelstring 예
$.oneOf[0].allOf[1].Payload.board.rolestring ["buyer","seller"] 예
$.oneOf[0].allOf[1].Payload.board.metricstring ["single_transaction","total_volume","single_bonus","total_bonus"] 예
$.oneOf[0].allOf[1].Payload.board.entriesarray 예
$.oneOf[0].allOf[1].Payload.board.entries[]object 아니요
$.oneOf[0].allOf[1].Payload.board.entries[].rankinteger 예
$.oneOf[0].allOf[1].Payload.board.entries[].userIDinteger 예
$.oneOf[0].allOf[1].Payload.board.entries[].transactionCountinteger 예
$.oneOf[0].allOf[1].Payload.board.entries[].aliasstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].avatarURLstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].avatarEmojistring 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImageURLstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImageURLstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileURLstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].transactionCountLabelstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].amountLabelstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].mediaTypestring 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].widthinteger 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].heightinteger 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].titlestring 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].isImageboolean 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].frameobject 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].frame.positionXPercentnumber 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].frame.positionYPercentnumber 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].frame.zoomPercentnumber 예
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[0].backgroundUrlstring 아니요
$.oneOf[0].allOf[1].Payload.board.entries[].profileImage.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].mediaTypestring 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].widthinteger 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].heightinteger 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].titlestring 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].isImageboolean 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].frameobject 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].frame.positionXPercentnumber 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].frame.positionYPercentnumber 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].frame.zoomPercentnumber 예
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[0].backgroundUrlstring 아니요
$.oneOf[0].allOf[1].Payload.board.entries[].bannerImage.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.entriesarray 예
$.oneOf[0].allOf[1].Payload.entries[]object 아니요
$.oneOf[0].allOf[1].Payload.entries[].rankinteger 예
$.oneOf[0].allOf[1].Payload.entries[].userIDinteger 예
$.oneOf[0].allOf[1].Payload.entries[].transactionCountinteger 예
$.oneOf[0].allOf[1].Payload.entries[].aliasstring 예
$.oneOf[0].allOf[1].Payload.entries[].avatarURLstring 예
$.oneOf[0].allOf[1].Payload.entries[].avatarEmojistring 예
$.oneOf[0].allOf[1].Payload.entries[].profileImageURLstring 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImageURLstring 예
$.oneOf[0].allOf[1].Payload.entries[].profileURLstring 예
$.oneOf[0].allOf[1].Payload.entries[].transactionCountLabelstring 예
$.oneOf[0].allOf[1].Payload.entries[].amountLabelstring 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].mediaTypestring 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].widthinteger 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].heightinteger 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].titlestring 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].isImageboolean 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].frameobject 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].frame.positionXPercentnumber 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].frame.positionYPercentnumber 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].frame.zoomPercentnumber 예
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[0].backgroundUrlstring 아니요
$.oneOf[0].allOf[1].Payload.entries[].profileImage.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].mediaTypestring 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].widthinteger 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].heightinteger 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].titlestring 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].isImageboolean 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].frameobject 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].frame.positionXPercentnumber 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].frame.positionYPercentnumber 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].frame.zoomPercentnumber 예
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[0].backgroundUrlstring 아니요
$.oneOf[0].allOf[1].Payload.entries[].bannerImage.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_wall_of_fame_list",
    "RequestUserAlias": "example-user",
    "Payload": {
        "scope": {
            "scopeType": "global",
            "scopeValue": "synthetic-example",
            "displayName": "synthetic-example"
        },
        "timeframe": {
            "timeframe": "today",
            "year": 0,
            "startDate": "synthetic-example",
            "endDate": "synthetic-example",
            "labelKey": "synthetic-example"
        },
        "lists": [],
        "pageSize": 0,
        "board": {
            "listKey": "highest_transaction",
            "labelKey": "synthetic-example",
            "label": "synthetic-example",
            "descriptionKey": "synthetic-example",
            "description": "synthetic-example",
            "countLabelKey": "synthetic-example",
            "countLabel": "synthetic-example",
            "role": "buyer",
            "metric": "single_transaction",
            "entries": []
        },
        "entries": []
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/marketdata/get_world_top

#
Returns the top cities worldwide ordered by recent trading activity. Used by the Market Data overview page's "World's Top N" header section.

매개변수

이름유형필수기본값설명
pageSize int 아니요 20 Number of cities to return (1-100).
categorySlug string 아니요 "" Optional category filter (restaurants, events, concerts, hotels, dmv, mentoring, shopping, golf, rv, marinas, cruises, houseparties, dj, concierges, general). Empty = all categories.
dateRange string 아니요 "90d" Activity window: 7d, 30d, 90d, 180d, 365d.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/marketdata/get_world_top' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'categorySlug={{categorySlug}}' \
  --data-urlencode 'dateRange={{dateRange}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$marketdata_get_world_top_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.categorySlugstring 예
$.oneOf[0].allOf[1].Payload.resolvedCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.seoCategorySlugstring 예
$.oneOf[0].allOf[1].Payload.categoryTitlePluralstring 예
$.oneOf[0].allOf[1].Payload.canonicalURL 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.canonicalURL.anyOf[1] = false 예
$.oneOf[0].allOf[1].Payload.category 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].id.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].slugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].seoSlugstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].titlePluralstring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[0].jsonLDTypestring 예
$.oneOf[0].allOf[1].Payload.category.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.citiesarray 예
$.oneOf[0].allOf[1].Payload.cities[]object 아니요
$.oneOf[0].allOf[1].Payload.cities[].citySlugstring 예
$.oneOf[0].allOf[1].Payload.cities[].cityNamestring 예
$.oneOf[0].allOf[1].Payload.cities[].stateShortstring 예
$.oneOf[0].allOf[1].Payload.cities[].isoRegionstring 예
$.oneOf[0].allOf[1].Payload.cities[].countryCodestring 예
$.oneOf[0].allOf[1].Payload.cities[].countryNamestring 예
$.oneOf[0].allOf[1].Payload.cities[].continentShortstring 예
$.oneOf[0].allOf[1].Payload.cities[].imageURL256string 예
$.oneOf[0].allOf[1].Payload.cities[].imageURL512string 예
$.oneOf[0].allOf[1].Payload.cities[].detailURLstring 예
$.oneOf[0].allOf[1].Payload.cities[].tradingActivity30Dayinteger 예
$.oneOf[0].allOf[1].Payload.cities[].numberTransactionsinteger 예
$.oneOf[0].allOf[1].Payload.cities[].venueCountinteger 예
$.oneOf[0].allOf[1].Payload.cities[].rankinteger 예
$.oneOf[0].allOf[1].Payload.cities[].isHotboolean 예
$.oneOf[0].allOf[1].Payload.cities[].avgTradingPrice 예
$.oneOf[0].allOf[1].Payload.cities[].avgTradingPrice.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.cities[].avgTradingPrice.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cities[].coordinatesobject 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.latitude 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.latitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.latitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.longitude 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.longitude.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.cities[].coordinates.longitude.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.cities[].distanceMetersnumber 아니요
$.oneOf[0].allOf[1].Payload.cities[].distanceMilesnumber 아니요
$.oneOf[0].allOf[1].Payload.totalResultsinteger 예
$.oneOf[0].allOf[1].Payload.dateRangestring ["7d","30d","90d","180d","365d"] 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/marketdata/get_world_top",
    "RequestUserAlias": "example-user",
    "Payload": {
        "categorySlug": "synthetic-example",
        "resolvedCategorySlug": "synthetic-example",
        "seoCategorySlug": "synthetic-example",
        "categoryTitlePlural": "synthetic-example",
        "canonicalURL": "synthetic-example",
        "category": {
            "id": 0,
            "slug": "synthetic-example",
            "seoSlug": "synthetic-example",
            "name": "synthetic-example",
            "titlePlural": "synthetic-example",
            "jsonLDType": "synthetic-example"
        },
        "cities": [],
        "totalResults": 0,
        "dateRange": "7d"
    }
}
기계가 읽을 수 있는 엔드포인트 문서