# Waltrack: user guide

How to use Waltrack: add Walmart products, read your watchlist, set price alerts, choose check frequencies, use the Chrome extension, the API and MCP.

Everything you need to follow Walmart prices with Waltrack, from your first product to the API. The same page for people: https://www.waltrack.dev/guide

## Get started

1. Create an account with your email and a password.
2. Confirm your email with the link we send you: it unlocks 1500 free credits every 30 days.
3. The free plan tracks up to 50 products, each checked once a day.

- The link is valid for 24 hours. Resend the email from your watchlist if needed.
- Free credits are granted once per person and device: another account created on the same device doesn't get them again.

## Add a product

Open your watchlist and use the bar at the top. There are three ways to add a product:

1. Paste a link from a walmart.com product page, or its item ID: the number at the end of the link, like 5113183757 in walmart.com/ip/…/5113183757.
2. Or switch to “Search Walmart”, type a few words and click Track on the right result.
3. Or, with the Chrome extension, click Track on any Walmart product page.

- To add many at once, switch to “Import”: paste a list of links or item IDs, or choose a CSV file.
- Waltrack follows walmart.com, Walmart's US store: prices are in US dollars.
- The price is checked right away when you add a product (1 credit).

## Read your watchlist

Each row shows the product, its latest price, the change since you added it and a few badges. Click a row to open the product page.

Above the list, switch between the detailed view and the compact one, which fits more products on screen. The ⋯ menu on each row opens the product on Walmart, checks its price now, pauses or removes it.

Colored badges describe the product and its tracking: green is good news, amber needs a look, red needs you. Outlined badges show your own settings. The filters above the list (“Price drops”, “Out of stock”, “Needs attention”…) gather products by these badges.

### Tracking

- **Checking the price…**: Waltrack is reading the price on Walmart right now. It takes a few seconds.
- **Queued**: Just added: the first check is queued.
- **Confirm your email**: Your email isn't confirmed yet: the free credits, and the checks, start with the link we sent you.
- **Paused**: You paused this product. Nothing is checked or charged until you resume it.
- **Waiting for credits**: Your balance is empty. Checks wait and start again by themselves once credits arrive.
- **Not found on Walmart**: Walmart has no page for this item ID. Nothing was charged.
- **Retrying soon**: Walmart didn't answer at the last check. Nothing was charged; it tries again shortly.

### Walmart offer

- **In stock**: Walmart showed the product with a price at the last check.
- **Out of stock**: Out of stock at the last check. With alerts on, you get an email when it's back.
- **Price drop (−12.5%)**: The price is lower than when you added the product.
- **Price rise (+4%)**: The price is higher than when you added the product.
- **Sold by**: Who sells the product: Walmart or a Marketplace seller (product page only).

### Your settings

- **≤ target price**: Your target price: you get an email as soon as the price reaches it.
- **Target reached**: The current price is at or below your target.
- **Daily**: How often the price is checked. Each check costs 1 credit.

## The product page

1. The chart shows every check over 7 days, 30 days, 3 months or a year. Hover or touch it to read a price and its date. It can start before you added the product, from reads made for other users; a dotted line marks the day you added it.
2. Below, the current, lowest and highest price, and the change since the product was added.
3. “Latest checks” lists each check with its price and seller.
4. “Check now” reads the price immediately (1 credit), at most once every 5 minutes. “Pause” stops the checks without losing the history; “Remove” deletes the product and its history.

## Price alerts

Alerts are sent by email, per product, from the product page:

1. “Email me when the price drops or it's back in stock”: an email at every drop since the previous check, including Rollbacks and clearance, and when an out-of-stock product is available again.
2. Target price: one email when the price goes at or below your amount. You're not emailed again while it stays below; if it goes back up and drops again, you are.

- The first check of a product never sends an alert: it sets the starting point.

## Check frequency and credits

1 credit = 1 price check of one product. Choose how often each product is checked; the faster, the more credits it uses each month:

| Check frequency | From plan | Credits per product per month |
| --- | --- | --- |
| Daily | Free | ≈ 30 |
| Every 12 hours | Starter | ≈ 60 |
| Every 6 hours | Starter | ≈ 120 |
| Every hour | Starter | ≈ 720 |
| Every 30 minutes | Pro | ≈ 1,440 |
| Every 5 minutes | Business | ≈ 8,640 |

- Free accounts are checked daily. Credit packs and the Starter plan unlock checks every 12, 6 or 1 hour; Pro goes down to every 30 minutes, Business to every 5 minutes.
- Frequencies with a lock aren't included in your plan. If you move to a smaller plan, or your plan or pack ends, products checked faster than allowed slow down to the fastest frequency left.
- Without credits, checks pause: nothing is charged and the history stays. They start again by themselves when credits are back.
- A check that fails on Walmart's side is refunded and retried within 30 minutes.

## Chrome extension

1. Install the extension in Chrome (or Edge, Brave, Arc).
2. Click the extension's icon and connect your account: one click on the page that opens.
3. Open any walmart.com product page: a small Waltrack panel shows whether the product is tracked, its price history and a Track button.

- The toolbar icon lists your watchlist with the latest prices.

## API and AI assistants

The same personal key works with the REST API and the MCP server. Add, list and read products and their history from your scripts, or ask Claude, ChatGPT or Cursor about your watchlist.

1. Create a key in “Extension & API” (one per tool, revocable at any time).
2. REST: send it as “Authorization: Bearer <key>” to /api/v1. The full reference is in the API documentation.
3. MCP: use the one-click setups in your account for Claude, ChatGPT, Cursor or any MCP client.

- In the API and MCP, the check frequency is interval_minutes: 1440 for daily, down to 5.

API documentation: https://www.waltrack.dev/docs. Agent guide (MCP tools and flow): https://www.waltrack.dev/agents.md

## Plans and billing

1. Monthly plans refill your credits at each renewal; unused monthly credits don't carry over.
2. Credit packs are one-time purchases, valid 6 months, used once monthly credits run out.
3. Change or cancel your plan from “Credits”. A cancellation takes effect at the end of the period. Invoices are in “Invoices”.

- The “Cancel a subscription” page, linked at the bottom of every page, explains what happens after cancelling. For anything else, see “Help & support”.

## Affiliate program

Recommend Waltrack and earn 30% of what each customer you refer pays, before tax, for 12 months from their first payment: plans and credit packs alike. Joining is free.

1. Open “Affiliate program” at the bottom of any page, then “Become an affiliate”. Log in or create an account first if needed.
2. Read the terms, tick “I accept the program terms” and click “Join the program”.
3. Your dashboard opens with your code and your main link, which opens the home page. Copy it and share it: it works right away.

- Someone who signs up within 60 days of clicking your link becomes your referral for good. If they clicked several affiliates' links, the last click counts.
- Referrals don't have to pay right away: the 12 months start at their first payment, whenever it comes.
- Before you share, read the “Brief” tab: what we sell, who to reach, key messages, what's not allowed, and resources such as our logos.

Program terms: https://www.waltrack.dev/affiliates.md

## Affiliate links

Use a different link for each place you share (a video, a newsletter, a website) to see which one works best. In the “Links” tab, click “New link”:

1. Name: what the link is for, such as “YouTube description”. Only you see it.
2. Link ending (optional): what comes after /r/ in the address, 3 to 32 lowercase letters, numbers and dashes. Leave it empty to make one from the name.
3. Page it opens: the home page, Pricing, the user guide, the affiliate program, or “Another page…” for any page of the site. You can add tracking parameters, like /pricing?utm_source=youtube.
4. Copy the link and share it. Its row shows its clicks, sign-ups, customers and earnings.

- Editing a link changes its name, its ending or the page it opens. Changing the ending breaks nothing: the previous address keeps working and still counts for the same link.
- Archive a link you no longer use: it still opens its page but no longer counts visits. You can restore it at any time; if you reach the limit of active links, archive one first.
- Link endings are unique across all affiliates, previous ones included, and some words, such as our brand names, are reserved. If yours is taken, try another one.

## Missions

“Missions” lists tasks with a fixed reward on top of your commissions, such as writing an article or making a video, each with its brief and deadline.

1. Do the work described in the mission's brief.
2. Click “Submit your work” and paste the link to it, starting with https://, with an optional note.
3. We review it: “Under review”, then “Approved” or “Not approved” with our note. After a refusal, you can submit again.

- An approved mission adds its reward to your earnings as a “Mission reward”, confirmed right away and paid with your next payout.

## Performance and clicks

“Performance” shows what your links brought in over 30 days, 90 days or 12 months: clicks, sign-ups, paying customers, how many clicks became sign-ups and sign-ups became customers, sales generated (before tax) and your commissions. “Active referrals” counts the people who can still earn you commissions.

The chart follows clicks, sign-ups or customers day by day (month by month over 12 months); “Show as a table” lists the same numbers.

“Clicks” lists recent visits through your links: date, link, the visitor's country, the site they came from (“Direct” when there is none) and whether they signed up.

- A visitor who opens the same link several times in a day counts once. Link previews in chats and social networks, bots, and pages that load your link in the background don't count.
- Visitors' IP addresses are never kept, and your referrals' email addresses are masked in your earnings.

## Commissions

Each payment from someone you referred adds a commission under “Earnings”. Its status tells you where it stands:

1. “Pending”: waiting for the refund window. The commission is confirmed 30 days after the payment, unless the customer is refunded.
2. “On hold”: under review. We check some referrals, and payments the customer disputes with their bank, before confirming their commissions.
3. “Confirmed”: earned, and paid with your next payout.
4. “Paid”: sent to you.
5. “Cancelled”: the payment was refunded or lost to a dispute, or the referral broke the program rules.

- A partial refund reduces the commission rather than cancelling it.
- A refund that comes after a commission was paid shows as a negative “Refund adjustment”, taken off your next payout.

## Getting paid

1. Under “Earnings”, in “Payout method”, choose bank transfer, PayPal, Wise or Other, and enter the account, address or instructions we need to pay you.
2. Save. This needs a recent login: if you're asked to, sign out, log back in and save again.
3. At the start of each month, your confirmed commissions are gathered into a payout once they reach $50 or €50 in one currency. Below that, they carry over to the next month.
4. We send the payment and email you. Under “Payouts”, it goes from “To be paid” to “Paid”, with the date and our reference.

- Your payment details are encrypted: only the team that pays you sees them in full, you see their last 4 characters. To change them, enter them again; we email you whenever they change.
- The recent login protects where your money goes: someone using a session you left open can't redirect your earnings.
- You're paid in the currency your customers paid in: euros or US dollars, each with its own payout.

## Affiliate rules

Promote Waltrack honestly, to people who may need it. Not allowed: bidding on Waltrack, Walmart or their misspellings in search ads; using Walmart or Waltrack in ad copy, domain or account names; spam (unsolicited emails, messages or comments); fake or misleading discount codes; referring yourself, creating accounts for other people, or paying people to sign up.

Commissions earned against these rules are cancelled, and the affiliate account can be suspended: its links then no longer count visits, and it earns no commissions. If you think we made a mistake, write to us.

- Sign-ups from your own account, devices or email addresses are self-referrals: they don't count and never earn a commission.
- Some referrals are checked before their commissions are confirmed, for example when an account looks connected to yours or to other accounts. Their commissions show “On hold” in the meantime. A shared family computer or office network can look like this: we then confirm them.
- To prevent self-referrals and duplicate accounts, we compute a fingerprint of your browser when you join, save a payout method or submit a mission, and keep only a coded version.

## Troubleshooting

### My product says “Waiting for credits”.

Your balance is empty. Confirm your email if you haven't, or add credits: the check starts again within a few minutes.

### My product says “Not found on Walmart”.

The page no longer exists on walmart.com, or the item ID has a typo. Check the link on Walmart; nothing was charged.

### The price differs from what I see on Walmart.

Prices can change between two checks, and Walmart may show a different price depending on your ZIP code or store. Use “Check now” for the latest price.

### I don't receive alerts.

Check that alerts are on for the product, look in your spam folder, and note that the first check never alerts. Also check that price alert emails aren't turned off in your profile.

### I can't pick a faster check.

Frequencies with a lock aren't in your plan: daily on the free plan, hourly with a credit pack or Starter, every 30 minutes with Pro, every 5 minutes with Business.

### I didn't receive free credits.

Free credits arrive when you confirm your email, once per person and device. If this device already received them, add credits from “Credits” to start the checks.

## Affiliate program: questions

### Someone signed up through my link but doesn't show up.

A sign-up counts when it happens within 60 days of a click on your link, in the same browser, and no other affiliate's link was clicked in between. Sign-ups from your own account, devices or email addresses never count.

### Why is a commission on hold?

We check some referrals before confirming their commissions, for example when an account looks connected to yours or to other accounts, and payments that a customer disputes with their bank. Nothing is lost while we check: the commission then goes on as usual, or is cancelled if it breaks the program rules.

### When will I be paid?

Each commission is confirmed 30 days after the payment. At the start of each month, confirmed commissions are gathered into a payout once they reach $50 or €50 in one currency; below that, they carry over. Add a payout method under “Earnings” so we can pay you.

### Why do I have to log in again to save my payout method?

Changing where your money goes needs a recent login, so that someone using a session left open on another device can't do it. Sign out, log back in and save right away. We email you whenever your payout method changes.

### Can I change a link's ending?

Yes, your main link included: choose “Edit” in the link's menu and type the new ending. The previous address keeps working and still counts for the same link, so nothing you already shared breaks. A link can take 3 new endings a month, 10 across all your links; going back to one of its previous endings is always possible.
