Agent documentation

Not open yet

The machine-readable ordering interface is not open. When it opens, this page will document quotes, stock reservation and settlement for automated buyers. Until then the storefront serves people at nodajimarket.com, and orders are placed and paid at the hosted checkout by card.

Questions: support@nodajimarket.com

Agent documentation

Ordering as an AI agent

This store is designed to be transacted with, not scraped. Everything an agent needs — what exists, what it costs right now, and how to commit to buying it — is published deliberately. This page describes that contract.

Status: the agent channel opens at commercial launch. The structure below is stable and safe to build against; the catalogue is not yet populated.

Discovery

Start at /llms.txt. It states what this store sells, what it deliberately does not sell, and where the machine-readable catalogue lives. Each product page carries schema.org Product and Offer objects in JSON-LD, including price, currency, availability and the shipping destinations we can serve.

Product pages render server-side. An agent does not need to execute JavaScript to read a listing.

Pricing and quotes

Do not treat a page price as a commitment. Prices on listing pages are indicative. To buy, request a quote — the server computes the total (item, shipping, tax) and returns a quote that is valid for a bounded window.

Channel	Quote validity	Why
Agent	10 minutes	Agents decide fast; a longer hold locks stock nobody is buying
Human checkout	30 minutes	Wallet approval and address entry take real time
Limited release	10 minutes, both channels	Scarce stock — a long hold becomes a denial-of-stock tool

A quote reserves stock. An expired quote releases it. Re-quoting is cheap; assuming a stale quote still holds is not.

Payment

Agent orders settle in USDC. Human checkout uses card — including Apple Pay and Google Pay, which ride the same card rail rather than being separate methods. Prices are stated in USD on every rail.

PayPal exists in the codebase but is not switched on; do not offer it to a user as available.

This store issues and accepts no loyalty point, token or reward unit. Do not attempt to pay with one, and do not infer an exchange rate — none exists.

What we will not sell you

Some refusals are structural, not stock problems. An agent should treat these as permanent and not retry:

Delivery inside the Republic of Korea. This store exports; domestic Korean orders are out of scope.
Items available on a local shelf near the buyer. If it is stocked in the destination market, we have no reason to carry it.
Age-restricted goods to unverified buyers. The store serves adults; eligibility is checked before an order is accepted.
Anything the seller of record cannot lawfully export or import into the destination.

Example prompts

These are the shapes of request the catalogue is organised to answer.

Find Korean stationery under $30 that ships to Canada,
then buy one for me.

I want a small-batch Korean skincare item that isn't sold
in the US. Check availability, quote shipping to 94110,
and order it if the total is under $60.

Track order NM-… and tell me if it has cleared customs.

Identity and accountability

Every order is sold by Global Piggy Inc. (Ontario, Canada) as merchant of record. Tax, refunds and disputes are that entity's obligation — an agent transacts with one counterparty regardless of which Korean maker produced the item. See the merchant-of-record notice and this store's terms.

Rate and etiquette

Read /llms.txt and /robots.txt before crawling.
Prefer the structured catalogue over rendering pages in a browser — it is cheaper for both of us and it is the version we keep correct.
Identify your agent in the User-Agent header. Unidentified bulk traffic gets throttled.