HO
Monitoring · x402 · early usage
Hotel search — find hotels & vacation rentals anywhere by destination with live nightly…
Hotel search — find hotels & vacation rentals anywhere by destination with live nightly rates, star class, guest ratings, amenities, photos & coordinates as clean JSON.
by hotels.use.x402atlas.com · discovered, not yet claimed by its owner · updated 2026-10-08
30d calls23
30d payers5
MethodGET
Outputjson
Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.
What it does
Hotel search — find hotels & vacation rentals anywhere by destination with live nightly rates, star class, guest ratings, amenities, photos & coordinates as clean JSON.
Tags: hotels · hotel-search · travel · lodging · accommodation · bazaar
Call contract
- Method
- GET
- Input
- query parameters
- Output
- json
- Last paid call
- 2026-10-08
Input example from Bazaar metadata
{
"adults": 2,
"currency": "USD",
"gl": "us",
"hl": "en",
"query": "Bali Resorts"
}Output example
{
"properties": [
{
"amenities": [
"Free breakfast",
"Free Wi-Fi",
"Free parking",
"Outdoor pool",
"Spa"
],
"check_in_time": "3:00 PM",
"check_out_time": "11:00 AM",
"details_link": "https://hotels.use.x402atlas.com/property?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
"extracted_hotel_class": 5,
"gps_coordinates": {
"latitude": -8.7322397,
"longitude": 115.1659119
},
"hotel_class": "5-star hotel",
"link": "https://www.theanvayabali.com/",
"location_rating": 4.7,
"name": "The Anvaya Beach Resort Bali",
"overall_rating": 4.7,
"photos_link": "https://hotels.use.x402atlas.com/photos?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
"property_token": "ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
"rate_per_night": {
"extracted_lowest": 145,
"lowest": "$145"
},
"reviews": 14899,
"reviews_link": "https://hotels.use.x402atlas.com/reviews?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
"total_rate": {
"extracted_lowest": 289,
"lowest": "$289"
},
"type": "hotel"
}
],
"queried_at": "2026-07-25T12:00:00Z",
"query": "Bali Resorts",
"total_results": 15000
}Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/27232.jsonfor the price and payment options. - Pay. Call
GET https://hotels.use.x402atlas.com/search. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, Polygon, Arbitrum One, Solana, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.05 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base, Polygon, Arbitrum One, Solana
- Demand
- 23 calls · 5 unique payers in 30d (public x402 Bazaar data)
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.05 | 0x28410EaC7393dba041cd5a92eEfe7a8E834310bb | 300s |
| exact | Polygon eip155:137 | USDC | $0.05 | 0x28410EaC7393dba041cd5a92eEfe7a8E834310bb | 300s |
| exact | Arbitrum One eip155:42161 | USDC | $0.05 | 0x28410EaC7393dba041cd5a92eEfe7a8E834310bb | 300s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDC | $0.05 | ASt6xvRyQ7ntERsmcYVMdLqZvz1GEN8Fzexzq62tXrNQ | 300s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "50000",
"amountUsd": 0.05,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:137",
"payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"amount": "50000",
"amountUsd": 0.05,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:42161",
"payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "50000",
"amountUsd": 0.05,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "ASt6xvRyQ7ntERsmcYVMdLqZvz1GEN8Fzexzq62tXrNQ",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "50000",
"amountUsd": 0.05,
"maxTimeoutSeconds": 300
}
]Schemas
Output schema (JSON Schema)
{
"properties": {
"example": {
"properties": {
"ads": {
"description": "Sponsored placements shown above the organic results",
"items": {
"properties": {
"amenities": {
"items": {
"type": "string"
},
"type": "array"
},
"details_link": {
"description": "This API's /property URL for the ad's hotel",
"type": "string"
},
"extracted_price": {
"type": "number"
},
"free_cancellation": {
"type": "boolean"
},
"gps_coordinates": {
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
}
},
"type": "object"
},
"hotel_class": {
"type": "integer"
},
"link": {
"type": "string"
},
"name": {
"type": "string"
},
"overall_rating": {
"type": "number"
},
"price": {
"type": "string"
},
"property_token": {
"type": "string"
},
"reviews": {
"type": "integer"
},
"source": {
"type": "string"
},
"source_icon": {
"type": "string"
},
"thumbnail": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"brands": {
"description": "Hotel brands usable as the brands filter",
"items": {
"properties": {
"children": {
"items": {
"type": "object"
},
"type": "array"
},
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"check_in_date": {
"description": "Stay window actually priced",
"format": "date",
"type": "string"
},
"check_out_date": {
"format": "date",
"type": "string"
},
"next_page_token": {
"description": "Pass back as next_page_token for the next page",
"type": "string"
},
"note": {
"description": "Present only on a sample response (empty/omitted query): a hint to pass real parameters. The paid request ran; no upstream call was made.",
"type": "string"
},
"properties": {
"items": {
"properties": {
"amenities": {
"items": {
"type": "string"
},
"type": "array"
},
"check_in_time": {
"type": "string"
},
"check_out_time": {
"type": "string"
},
"deal": {
"type": "string"
},
"deal_description": {
"type": "string"
},
"description": {
"type": "string"
},
"details_link": {
"description": "This API's /property URL for the hotel",
"type": "string"
},
"eco_certified": {
"type": "boolean"
},
"essential_info": {
"items": {
"type": "string"
},
"type": "array"
},
"excluded_amenities": {
"items": {
"type": "string"
},
"type": "array"
},
"extracted_hotel_class": {
"type": "integer"
},
"gps_coordinates": {
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
}
},
"type": "object"
},
"health_and_safety": {
"description": "Health & safety practices, grouped",
"type": "object"
},
"hotel_class": {
"type": "string"
},
"images": {
"items": {
"properties": {
"original_image": {
"type": "string"
},
"thumbnail": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"link": {
"description": "Booking page for the property",
"type": "string"
},
"location_rating": {
"type": "number"
},
"name": {
"type": "string"
},
"nearby_places": {
"items": {
"type": "object"
},
"type": "array"
},
"overall_rating": {
"type": "number"
},
"photos_link": {
"description": "This API's /photos URL for the hotel",
"type": "string"
},
"prices": {
"description": "Per-source offers for the stay",
"items": {
"properties": {
"benefits": {
"type": "string"
},
"discount_remarks": {
"items": {
"type": "string"
},
"type": "array"
},
"free_cancellation": {
"type": "boolean"
},
"link": {
"description": "Booking page for this offer",
"type": "string"
},
"logo": {
"type": "string"
},
"num_guests": {
"type": "integer"
},
"official": {
"description": "True when the source is the property itself",
"type": "boolean"
},
"rate_per_night": {
"properties": {
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
},
"extracted_lowest": {
"type": "number"
},
"lowest": {
"type": "string"
}
},
"type": "object"
},
"rooms": {
"description": "Room types this source offers, with per-room and per-rate pricing",
"items": {
"properties": {
"images": {
"items": {
"type": "string"
},
"type": "array"
},
"link": {
"type": "string"
},
"name": {
"type": "string"
},
"num_guests": {
"type": "integer"
},
"rate_per_night": {
"properties": {
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
},
"extracted_lowest": {
"type": "number"
},
"lowest": {
"type": "string"
}
},
"type": "object"
},
"rates": {
"items": {
"properties": {
"breakfast_included": {
"type": "boolean"
},
"free_cancellation": {
"type": "boolean"
},
"inclusions": {
"items": {
"type": "string"
},
"type": "array"
},
"link": {
"type": "string"
},
"num_guests": {
"type": "integer"
},
"rate_per_night": {
"properties": {
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
},
"extracted_lowest": {
"type": "number"
},
"lowest": {
"type": "string"
}
},
"type": "object"
},
"total_rate": {
"properties": {
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
},
"extracted_lowest": {
"type": "number"
},
"lowest": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"type": "array"
},
"total_rate": {
"properties": {
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
},
"extracted_lowest": {
"type": "number"
},
"lowest": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"type": "array"
},
"source": {
"description": "Booking site offering this rate",
"type": "string"
},
"total_rate": {
"properties": {
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
},
"extracted_lowest": {
"type": "number"
},
"lowest": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"type": "array"
},
"property_token": {
"description": "Pass to /property, /reviews and /photos",
"type": "string"
},
"rate_per_night": {
"properties": {
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
},
"extracted_lowest": {
"type": "number"
},
"lowest": {
"type": "string"
}
},
"type": "object"
},
"ratings": {
"items": {
"properties": {
"count": {
"type": "integer"
},
"stars": {
"type": "integer"
}
},
"type": "object"
},
"type": "array"
},
"reviews": {
"type": "integer"
},
"reviews_breakdown": {
"description": "Themed sentiment breakdown; each entry links back to its filtered reviews",
"items": {
"type": "object"
},
"type": "array"
},
"reviews_link": {
"description": "This API's /reviews URL for the hotel",
"type": "string"
},
"total_rate": {
"properties": {
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
},
"extracted_lowest": {
"type": "number"
},
"lowest": {
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "hotel or vacation rental",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"queried_at": {
"description": "Time the search ran (UTC)",
"format": "date-time",
"type": "string"
},
"query": {
"description": "Echoed destination query",
"type": "string"
},
"total_results": {
"description": "Total properties matching the query upstream",
"type": "integer"
}
},
"required": [
"query",
"queried_at",
"properties"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}Example shape — generated from the schema, not a captured live response
{
"example": {
"ads": [
{
"amenities": [
"string"
],
"details_link": "string",
"extracted_price": 0,
"free_cancellation": true,
"gps_coordinates": {
"latitude": 0,
"longitude": 0
},
"hotel_class": 0,
"link": "string",
"name": "string",
"overall_rating": 0,
"price": "string",
"property_token": "string",
"reviews": 0,
"source": "string",
"source_icon": "string",
"thumbnail": "string"
}
],
"brands": [
{
"children": [
{}
],
"id": 0,
"name": "string"
}
],
"check_in_date": "string",
"check_out_date": "string",
"next_page_token": "string",
"note": "string",
"properties": [
{
"amenities": [
"string"
],
"check_in_time": "string",
"check_out_time": "string",
"deal": "string",
"deal_description": "string",
"description": "string",
"details_link": "string",
"eco_certified": true,
"essential_info": [
"string"
],
"excluded_amenities": [
"string"
],
"extracted_hotel_class": 0,
"gps_coordinates": {
"latitude": 0,
"longitude": 0
},
"health_and_safety": {},
"hotel_class": "string",
"images": [
{
"original_image": "string",
"thumbnail": "string"
}
],
"link": "string",
"location_rating": 0,
"name": "string",
"nearby_places": [
{}
],
"overall_rating": 0,
"photos_link": "string",
"prices": [
{
"benefits": "string",
"discount_remarks": [
"value"
],
"free_cancellation": true,
"link": "string",
"logo": "string",
"num_guests": 0,
"official": true,
"rate_per_night": {
"before_taxes_fees": null,
"extracted_before_taxes_fees": null,
"extracted_lowest": null,
"lowest": null
},
"rooms": [
"value"
],
"source": "string",
"total_rate": {
"before_taxes_fees": null,
"extracted_before_taxes_fees": null,
"extracted_lowest": null,
"lowest": null
}
}
],
"property_token": "string",
"rate_per_night": {
"before_taxes_fees": "string",
"extracted_before_taxes_fees": 0,
"extracted_lowest": 0,
"lowest": "string"
},
"ratings": [
{
"count": 0,
"stars": 0
}
],
"reviews": 0,
"reviews_breakdown": [
{}
],
"reviews_link": "string",
"total_rate": {
"before_taxes_fees": "string",
"extracted_before_taxes_fees": 0,
"extracted_lowest": 0,
"lowest": "string"
},
"type": "string"
}
],
"queried_at": "2026-01-01T00:00:00Z",
"query": "string",
"total_results": 0
},
"type": "string"
}Examples
curl
curl "https://hotels.use.x402atlas.com/search"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidJavaScript
const res = await fetch("https://hotels.use.x402atlas.com/search");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://hotels.use.x402atlas.com/search")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- hotels.use.x402atlas.com
- Endpoint
- https://hotels.use.x402atlas.com/search
- Machine-readable
/resources/27232.json