Kardlane
Operate

Rates

Keep your gift-card prices in line with what your vendors pay: rate checks on your schedule, every live trade, your rules and margins — changes sent to your system.

Kardlane Rates updates the rates on your price list from what your vendors actually pay. It’s included with Trading and off until you turn it on: dashboard → your project → Rates.

Your price list#

The list is your cards, currencies and value tiers, each with your customer rate (physical / e-code) and the margin you keep per unit. Keep it on the Rates page’s Price list tab, or send it from your system with PUT /v1/price-list — if you send it, each send replaces the list (edits made in the dashboard included), so keep it in one place. Rates only ever changes the rates on tiers you’ve listed: it never adds tiers or touches margins.

Where vendor rates come from#

  • Rate checks — Kardlane asks each vendor for its rates and reads the replies. By default the check is one line per tier of your price list for the cards that vendor buys, in the vendor’s own request format (USD 100 APPLE/ITUNES); a long list goes as several messages. Or set your own message per vendor (e.g. /rate for a vendor’s bot). Lines the vendor priced recently, and cards it keeps declining, are left out each time.
  • Live trades — every vendor quote on a trade, and “rate changed, next card 1100” messages, count as fresh rates. When one puts a card’s price off, Kardlane asks your other vendors about that card right away (one line each, at most once per card per cooldown).
  • What vendors post on their own — a vendor bot’s rate sheet, once Kardlane knows its format.

Schedule#

ModeWhat it does
At set timesChecks at the times you list (as many as you like), in your time zone.
Every few hoursEvery N minutes (15 to a day) within your active hours.
As often as rates movePer vendor: Kardlane learns how often that vendor’s rates change and checks at about half that interval, within the bounds you set and your active hours.

Reading replies — mostly without AI#

A reply that echoes our line and adds a number (USD 100 APPLE/ITUNES 1175) is read by code. A vendor’s rate sheet is read by the AI the first time; Kardlane then learns each line’s format (the line with its numbers masked, under its section title) and reads that format by code from then on. Only new or changed lines go to the AI, and once a day each vendor’s reply is read in full to pick up format changes. A rate read by code that jumped more than 25% from that vendor’s last one is confirmed by the AI. The Rates page shows how much was read without AI.

Every rate must be in the vendor’s own words; rates in another currency are converted at the vendor’s own rate (one printed on their sheet, their recent one, or asked for); a rate only for some card numbers (“9 start”) never sets a card’s price; and when a vendor gives two rates for the same thing, the lower counts.

From rates to your prices#

For each tier of your price list (and each form — physical / e-code), Kardlane works out what each vendor pays at every card value in the tier: their newest line for that value, and within one sheet the most specific one (“100/150” over “10-195”, an e-code line over one for either form). At each value it picks the market rate by your rule, and the tier takes the lowest of those, so the price is safe for any card in it. Lines with no value on them (“US = 1138”) count for every value. The rule can be set per card:

  • Vendor order — this vendor’s rate; if it has none, that one’s; then a fallback method.
  • Highest, second highest (the default), lowest, median or average of every vendor (or a chosen few). Vendors you exclude never count.

Your new price = the market rate − your margin for that tier, rounded down to your price’s precision. It’s applied automatically and sent to your system as rates.updated (changed tiers only, with the vendor rates behind each).

Note: Accuracy guards: tiers with no margin are never changed; moves smaller than your minimum are ignored; a move larger than your limit (default 5%) from a single vendor waits until a second vendor agrees or the next check confirms it; a market rate far from your current price is held as a likely misread. Held changes show on the Rates page and alert you.

Applying the changes#

Send your own id for each tier as ref in PUT /v1/price-list and rates.updated names it, so you can update the exact rate record. Apply a change only if your rate is still from — that way a price someone changed by hand since isn’t overwritten. Then send your list again as usual.