Agent skill

Awardwallet

by borski in borski/travel-hacking-toolkit

Query AwardWallet for loyalty program balances, elite status, and transaction history.

MITAuto-check: notesMarketing & SEO

Install Awardwallet

skills CLI
$ npx skills add borski/travel-hacking-toolkit --skill awardwallet -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borski/travel-hacking-toolkit awardwallet --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borski/travel-hacking-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/travel-hacking-toolkit/skills/awardwallet .claude/skills/awardwallet && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
awardwallet
GitHub stars
688
Token cost
~1.7k tokens
SKILL.md length
521 words
Files
1
Skills in repo
46
Repo updated
First seen
Licence
MIT

At a glance

Query AwardWallet for loyalty program balances, elite status, and transaction history.

  • Works in 5 steps: Pull all accounts → Filter to Airlines and Credit Cards… → Show a clean summary: program name,… → …
  • Checking points inventory
  • SKILL.md covers Authentication, API Base, Quick Start: Get All Balances and Deep Dive: Full Account History, plus 6 more sections
  • Calls jq and curl; reaches business.awardwallet.com; needs AWARDWALLET_API_KEY

What it does

Awardwallet is an agent skill from borski/travel-hacking-toolkit. Query AwardWallet for loyalty program balances, elite status, and transaction history. Use when checking points inventory, airline status, or planning trips on points.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Referral and retention marketing. The repository describes itself as: AI-powered travel hacking and search with cash, points, miles, and award flights. Drop-in skills and MCP servers for Claude, Codex, and OpenCode. The licence is MIT.

When your agent uses it

  • Checking points inventory
  • Planning trips on points

Example prompts

  • “/awardwallet”

Requirements

  • A credential in AWARDWALLET_API_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Pull all accounts
  2. Filter to Airlines and Credit Cards (transferable points)
  3. Show a clean summary: program name, balance, elite status
  4. Note any accounts with errors that might need updating
  5. Cross reference with transfer partners for the destination

What it can do on your machine

Read from SKILL.md and the folder at commit db82131. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • business.awardwallet.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AWARDWALLET_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Awardwallet loads about 1.7k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 521 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:18
    Set these in your `.env` file:

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from borski/travel-hacking-toolkit at commit db82131, republished under its MIT licence (© borski). 521 words, ~1,684 tokens.

Download SKILL.mdSave it as .claude/skills/awardwallet/SKILL.md (or your agent's skills folder).
name
awardwallet
description
Query AwardWallet for loyalty program balances, elite status, and transaction history. Use when checking points inventory, airline status, or planning trips on points.
category
loyalty
summary
All loyalty balances, elite status, history.
api_key
AwardWallet Business
license
MIT

AwardWallet Skill

Query loyalty program balances, elite status, and transaction history via the AwardWallet Business Account Access API.

Source: business.awardwallet.com — Requires a Business account.

Authentication

Set these in your .env file:

All requests use the X-Authentication header.

First-time setup gotcha: AwardWallet enforces an IP allowlist on Business API keys. Without your IP whitelisted, every call returns {"error": "access_denied", "code": "IP_DENIED"}. Whitelist before troubleshooting.

  • Where to whitelist: https://business.awardwallet.com/profile/api
  • How to find your IP: curl ifconfig.me
  • Multi-IP: home, office, hotspot, VPN exit nodes, and any travel locations each need their own entry. Easiest is to whitelist a /24 if you're on a stable residential ISP.
Error signatures
ResponseMeaningFix
{"error": "access_denied", "code": "IP_DENIED"}IP not on allowlistWhitelist current IP at the developer portal
Unauthorized / 401Bad keyRegenerate key
Empty accounts arrayUser ID wrong or no connectionsVerify AWARDWALLET_USER_ID

API Base

https://business.awardwallet.com/api/export/v1

Quick Start: Get All Balances

bash
curl -s -H "X-Authentication: $AWARDWALLET_API_KEY" \
  "https://business.awardwallet.com/api/export/v1/connectedUser/$AWARDWALLET_USER_ID" | jq '.accounts'
Response Fields

Each account object contains:

FieldDescription
accountIdUnique ID for deep dive
codeProvider code (e.g., "united", "chase", "amex")
displayNameHuman name (e.g., "United Airlines (MileagePlus)")
kindCategory: Airlines, Hotels, Credit Cards, etc.
balanceFormatted balance string
balanceRawNumeric balance
propertiesArray with status, account number, expiration, etc.
historyLast 10 transactions (call /account/{id} for full history)
errorCode1 = successfully updated, 2 = invalid creds, etc.
Useful jq Filters

All filters below assume the curl output is piped in. Replace ... with the full curl command above.

bash
# Just airline balances with status
... | jq '[.accounts[] | select(.kind == "Airlines") | {name: .displayName, balance: .balanceRaw, status: ((.properties // [])[] | select(.kind == 3) | .value) // "none"}]'

# Just hotel balances with status
... | jq '[.accounts[] | select(.kind == "Hotels") | {name: .displayName, balance: .balanceRaw, status: ((.properties // [])[] | select(.kind == 3) | .value) // "none"}]'

# Just credit card / transferable points
... | jq '[.accounts[] | select(.kind == "Credit Cards") | {name: .displayName, balance: .balanceRaw}]'

# All balances sorted by amount (descending), non-zero only
... | jq '[.accounts[] | {name: .displayName, kind: .kind, balance: .balanceRaw} | select(.balance > 0)] | sort_by(-.balance)'

# Elite status across all programs
... | jq '[.accounts[] | {name: .displayName, status: ((.properties // [])[] | select(.kind == 3) | .value) // null} | select(.status != null)]'

# Accounts with errors (need password update, etc.)
... | jq '[.accounts[] | select(.errorCode != 1) | {name: .displayName, error: .errorCode}]'

# Combined summary for trip planning (airlines + transferable points, non-zero, sorted)
... | jq '[.accounts[] | select((.kind == "Airlines" or .kind == "Credit Cards") and .balanceRaw > 0) | {name: .displayName, kind: .kind, balance: .balanceRaw, status: ((.properties // [])[] | select(.kind == 3) | .value) // null}] | sort_by(-.balance)'

Deep Dive: Full Account History

For full transaction history (beyond last 10):

bash
curl -s -H "X-Authentication: $AWARDWALLET_API_KEY" \
  "https://business.awardwallet.com/api/export/v1/account/{accountId}" | jq '.account[0].history'

Travel Timeline

Get saved itineraries for a connected user:

bash
curl -s -H "X-Authentication: $AWARDWALLET_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"start": "2026-01-01", "end": "2027-01-01"}' \
  "https://business.awardwallet.com/api/export/v1/travel-timeline/$AWARDWALLET_USER_ID" | jq '.itineraries'

List All Supported Providers

bash
curl -s -H "X-Authentication: $AWARDWALLET_API_KEY" \
  "https://business.awardwallet.com/api/export/v1/providers/list" | jq '.'
Show full SKILL.md (244 more words)Show less

Account Property Kinds

When parsing properties arrays, these kind values are standardized:

KindMeaning
1Account number
2Expiration
3Elite status
4Lifetime points
5Member since
6Expiring balance
7YTD Miles/Points
8YTD Segments
9Next elite level
10Points needed to next level
11Segments needed to next level
12Name
13Last activity
14Points needed for next reward
15Status expiration
16Points to retain status
17Segments to retain status
18Alliance elite level
19Status miles/points

Error Codes

CodeMeaning
0Never updated
1Success
2Invalid credentials
3Locked out
4Provider error or user action needed
5Provider disabled by AwardWallet
6Parse failure
7Password missing
8Disabled to prevent lockouts
9Success with warning
10Security question needed
11Timed out

Workflow: Trip Planning Summary

When planning a trip, run this workflow:

  1. Pull all accounts
  2. Filter to Airlines and Credit Cards (transferable points)
  3. Show a clean summary: program name, balance, elite status
  4. Note any accounts with errors that might need updating
  5. Cross reference with transfer partners for the destination

Notes

  • History in user/member detail responses is capped at 10 records. Use /account/{id} for full history.
  • balanceRaw is the numeric value. balance is formatted with commas.
  • Connected users control their own access level. If data seems limited, they may have restricted sharing.
  • SubAccounts exist for programs like Capital One where one login has multiple cards. Check subAccounts array.

© borski, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/travel-hacking-toolkit/skills/awardwallet of borski/travel-hacking-toolkit.

Open the folder on GitHubat commit db82131

Compare with similar skills

Awardwallet next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Awardwallet compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Awardwallet this skillborski/travel-hacking-toolkit688—~1.7kAutomated safety check: NotesMIT
Referralscoreyhaines31/marketingskills54k2 repos~2.6kAutomated safety check: PassMIT
Referral Programfreekmurze/dotfiles1k17 repos~1.8kAutomated safety check: PassNone
Churn Preventionrongxinzy/RongxinAI1543 repos~2.6kAutomated safety check: PassMIT
100m Leadsgetagentseal/founder-playbook729—~2.3kAutomated safety check: PassMIT
Churn Preventionfreekmurze/dotfiles1k13 repos~4.4kAutomated safety check: PassNone

Similar skills

  • Referrals

    coreyhaines31/marketingskills

    When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.

    54k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • Referral Program

    freekmurze/dotfiles

    When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.

    1k GitHub starsUsed in 17 repos~1.8k tokens
    Marketing & SEOAuto-check passed
  • Churn Prevention

    rongxinzy/RongxinAI

    Reduce voluntary and involuntary churn through cancel flow design, save offers, exit surveys, and dunning sequences.

    154 GitHub starsUsed in 3 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • 100m Leads

    getagentseal/founder-playbook

    Builds lead generation systems using Alex Hormozi's Core Four framework (warm outreach, content, cold outreach, paid ads), lead magnets, and Rule of 100.

    729 GitHub stars~2.3k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • Churn Prevention

    freekmurze/dotfiles

    When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies.

    1k GitHub starsUsed in 13 repos~4.4k tokens
    Marketing & SEOAuto-check passed
  • Sms

    coreyhaines31/marketingskills

    When the user wants to plan, build, or optimize SMS, MMS, or WhatsApp marketing — including welcome flows, abandoned cart texts, post-purchase, win-back, promotional sends, or transactional/auth SMS.

    54k GitHub starsUsed in 1 repo~4.6k tokens
    Marketing & SEOAuto-check passed

More from borski/travel-hacking-toolkit

All 46 skills in this repo
  • Amex Travel

    borski/travel-hacking-toolkit

    Search Amex travel portal for cash prices, MR points pricing, IAP discounts, and FHR/THC hotel benefits via Patchright.

    688 GitHub stars~3.1k tokensUpdated 4 days ago
    Auto-check passed
  • Chase Travel

    borski/travel-hacking-toolkit

    Search Chase UR travel portal via Patchright for cash prices, points pricing, Points Boost offers, and Chase Edit hotel benefits.

    688 GitHub stars~2.8k tokensUpdated 4 days ago
    Auto-check passed
  • Deutsche Bahn

    borski/travel-hacking-toolkit

    Deutsche Bahn train schedules, journey planning, and departures across Germany and into neighboring countries (Austria, Switzerland, Netherlands, France, Belgium).

    688 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Sutochno

    borski/travel-hacking-toolkit

    Search Sutochno.ru (СУТОЧНО.РУ), a Russian short-term apartment-rental platform where you book directly from owners and pay in rubles (Mir card / bank transfer).

    688 GitHub stars~2.1k tokensUpdated 4 days ago
    Auto-check passed
  • Ticketsatwork

    borski/travel-hacking-toolkit

    Search TicketsAtWork (EBG corporate perks) for hotels, theme park tickets, attractions, and rental cars via Patchright.

    688 GitHub stars~4.2k tokensUpdated 4 days ago
    Auto-check passed
  • Vrbo

    borski/travel-hacking-toolkit

    Search VRBO (Vrbo / Expedia Group) vacation rentals including entire homes, condos, and cabins via Patchright browser automation.

    688 GitHub stars~1.7k tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about Awardwallet

What does Awardwallet do?

Query AwardWallet for loyalty program balances, elite status, and transaction history. Awardwallet is an agent skill from borski/travel-hacking-toolkit. Query AwardWallet for loyalty program balances, elite status, and transaction history.

When should I use Awardwallet?

Awardwallet fits situations like: checking points inventory; planning trips on points.

How do I install Awardwallet in Claude Code?

Run `npx skills add borski/travel-hacking-toolkit --skill awardwallet -a claude-code`. Or copy the skill folder (plugins/travel-hacking-toolkit/skills/awardwallet in borski/travel-hacking-toolkit) into .claude/skills/awardwallet in your project. Claude Code loads it when a task matches its description.

How do I install Awardwallet in Codex?

Run `npx skills add borski/travel-hacking-toolkit --skill awardwallet -a codex`. Or copy the skill folder (plugins/travel-hacking-toolkit/skills/awardwallet in borski/travel-hacking-toolkit) into .agents/skills/awardwallet in your project. Codex loads it when a task matches its description.

Can I use Awardwallet in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borski/travel-hacking-toolkit --skill awardwallet -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/awardwallet, .gemini/skills/awardwallet, .github/skills/awardwallet and .opencode/skills/awardwallet in your project.

What does Awardwallet need to run?

Going by SKILL.md and its folder, Awardwallet needs the command-line tools its instructions call (jq and curl) and credentials named AWARDWALLET_API_KEY. Our summary lists: A credential in AWARDWALLET_API_KEY.

Does Awardwallet access the network?

SKILL.md names 1 domain. In commands or code: business.awardwallet.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Awardwallet safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Awardwallet use?

Awardwallet is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Awardwallet use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Awardwallet?

Skills that share tags, products or a category with Awardwallet: Referrals (coreyhaines31/marketingskills, 54k stars), Referral Program (freekmurze/dotfiles, 1k stars), Churn Prevention (rongxinzy/RongxinAI, 154 stars) and 100m Leads (getagentseal/founder-playbook, 729 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Awardwallet?

borski (a GitHub user) maintains it in borski/travel-hacking-toolkit, which has 688 GitHub stars. The repository holds 46 skills in this directory. The repository was last updated on October 5, 2026.

Source: borski/travel-hacking-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.