AxeTip provides APIs for credit card terms, bank margin schedules, Federal Reserve interest rate benchmarks, ISO 18245 merchant category codes, and merchant transaction routing. All monetary values and interest rates are represented as structured objects with integer minor units (cents) and basis points (bps) to prevent floating-point rounding errors.

OpenAPI specifications:

  • OpenAPI 3.1.1 (default, compatible with most code generators, Postman, and API clients)
  • OpenAPI 3.2.0 (includes hierarchical tags and $self document URIs)
GET /api/cards
Launch Preview: 10,000 req/day Format: JSON (Structured Value Objects)
// Click "Send Request" to fetch live JSON from the edge

Data Formats: Structured Value Objects

To prevent floating-point rounding errors, monetary amounts, interest rates, and reward yields use structured objects instead of raw floats.

1. Currency Amounts (MoneyAmount)

Monetary values include integer minor units (cents) alongside formatted strings:

{
  "value": 325.0,
  "cents": 32500,
  "formatted": "$325.00",
  "currency": "USD"
}

2. Interest Rates (InterestRate)

Interest rates include integer basis points (bps, where $1\text{ bp} = 0.01%$):

{
  "value": 7.0,
  "bps": 700,
  "formatted": "7.00%"
}

3. Reward Yields (RewardYield)

Reward rates include units and basis points:

{
  "value": 4.0,
  "unit": "%",
  "formatted": "4.0%",
  "basis_points": 400
}

Endpoints

Requests can be made via GET (query parameters) or POST (JSON body). For full endpoint schemas, error models, and language examples, see the API Reference.

EndpointsDescriptionQuery / LookupReference
/api/cardsCard terms, CFPB margin schedules, and APRs calculated from live Fed Prime.Card slugs (e.g. amex-gold, chase-sapphire-preferred)Reference →
/api/mccISO 18245 merchant category codes, network citations (Visa, Mastercard, Amex), and top-earning cards.4-digit code (5812) or category (dining)Reference →
/api/merchantMerchant database, alias resolution, primary/secondary MCCs, network rules, and co-brand cards.Merchant name (doordash), slug (costco), or MCCReference →
/api/benchmarkFederal Reserve H.15 rates (Prime, SOFR, EFFR), FOMC meeting calendar, and credit card rate spreads.Series filter (history, fomc, nim) or default overviewReference →
/api/optimizeTransaction routing and spend basket optimization. Checks register acceptance rules (e.g. Costco warehouse Visa-only) and compares card returns.Merchant, amount, held cards, or monthly category spendReference →

Credit Cards (/api/cards)

Returns card pricing, CFPB agreement filing details, rewards matrices, and effective purchase APRs calculated using the current Federal Reserve Prime rate. Detailed documentation: Cards Reference →.

GET https://www.axetip.com/api/cards?cards={query}
POST https://www.axetip.com/api/cards

Query Parameters & Request Body

ParameterTypeRequiredDescription
cardsstring (GET) or array (POST)YesComma-separated query string or JSON array of 1 to 5 card slugs or names (e.g. amex-gold or csp,gold).

Operational Modes

  • Single Card (mode: "lookup"): Passing 1 card returns complete statutory terms, margin schedules, grace periods, CDN media URLs, live Fed Prime APR calculations, and an executive card summary.
  • Side-by-Side (mode: "comparison"): Passing 2 to 5 cards returns full card schemas side-by-side with a deterministic comparison verdict evaluating annual fees, top category yields, and grace periods.
  • Variant Matching: Ambiguous queries (e.g. "amex blue") return all matching variants in the cards array accompanied by disambiguation notes in ambiguity_notes.

Response Example

{
  "source": "AxeTip 2026 Tier 1 Data",
  "status": "success",
  "mode": "lookup",
  "cards_count": 1,
  "benchmark": {
    "prime_rate": {
      "value": 7.0,
      "bps": 700,
      "formatted": "7.00%"
    },
    "as_of": "2026-09-16",
    "next_fomc_meeting": "2026-10-28",
    "source": "Federal Reserve Board of Governors H.15"
  },
  "verdict": "AxeTip Overview: American Express® Gold Card carries a $325.00 annual fee (offset by up to $120.00 in statement credits), leading with 5.0x on Hotels (base: 1.0x points) with purchase APR starting at 19.74%, and a 25-day grace period.",
  "cards": [
    {
      "id": "amex-gold",
      "name": "American Express® Gold Card",
      "issuer": "American Express",
      "network": "American Express",
      "canonical_url": "https://www.axetip.com/card/amex-gold/",
      "annual_fee": {
        "value": 325.0,
        "cents": 32500,
        "formatted": "$325.00",
        "currency": "USD"
      },
      "calculated": {
        "effective_purchase_apr": {
          "margin_min": { "value": 12.74, "bps": 1274, "formatted": "12.74%" },
          "margin_max": { "value": 21.74, "bps": 2174, "formatted": "21.74%" },
          "effective_min": { "value": 19.74, "bps": 1974, "formatted": "19.74%" },
          "effective_max": { "value": 28.74, "bps": 2874, "formatted": "28.74%" },
          "formula": "prime_rate (7.00%) + bank_margin"
        }
      }
    }
  ]
}

Merchant Category Codes (/api/mcc)

Query 1,067 official Merchant Category Codes governed by ISO 18245:2023. Each code includes industry titles, card network citations (Visa, Mastercard, American Express), reward category classifications, and top-earning cards. Detailed documentation: MCC Reference →.

GET https://www.axetip.com/api/mcc?code={code}
GET https://www.axetip.com/api/mcc?category={category}
POST https://www.axetip.com/api/mcc

Query Parameters

ParameterTypeRequiredDescription
codestringNo*Single 4-digit MCC or comma-separated list (e.g. 5812 or 5812,5411).
categorystringNo*Filter by taxonomy category slug (e.g. dining, supermarkets, travel_general, gas_and_ev).

* At least one filter (code or category) is recommended.

Response Example

{
  "status": "success",
  "count": 1,
  "data": {
    "code": "5812",
    "title": "Eating Places And Restaurants",
    "reward_category": "dining",
    "is_cash_advance": false,
    "documentation_url": "https://www.axetip.com/reg/iso/18245/mcc/5812/",
    "optimal_card": {
      "id": "hilton-honors-aspire",
      "name": "Hilton Honors American Express Aspire Card",
      "issuer": "American Express",
      "annual_fee": {
        "value": 550.0,
        "cents": 55000,
        "formatted": "$550.00",
        "currency": "USD"
      },
      "reward_yield": {
        "value": 7.0,
        "unit": "x",
        "formatted": "7.0x",
        "basis_points": 700
      },
      "canonical_url": "https://www.axetip.com/card/hilton-honors-aspire/"
    }
  }
}

Merchants (/api/merchant)

Resolves merchant names, aliases, and corporate entities to MCC classifications, payment network rules, and co-branded reward pairings across 2,417 merchants and 4,939 alias patterns. Detailed documentation: Merchant Reference →.

GET https://www.axetip.com/api/merchant?q={query}
GET https://www.axetip.com/api/merchant?id={id}
POST https://www.axetip.com/api/merchant

Query Parameters

ParameterTypeRequiredDescription
qstringNo*Search term matched against merchant names and inverted alias index (e.g. doordash, starbucks, amazon).
idstringNo*Exact merchant slug (e.g. costco, delta, apple).

Response Example

{
  "status": "success",
  "data": {
    "id": "doordash",
    "name": "DoorDash",
    "ticker": "DASH",
    "exchange": "NASDAQ",
    "industry": "Food Delivery / Logistics",
    "category": "Dining",
    "primary_mcc": "5812",
    "primary_mcc_title": "Eating Places And Restaurants",
    "secondary_mccs": ["5814"],
    "documentation_url": "https://www.axetip.com/merchant/doordash/",
    "optimal_card": {
      "id": "doordash-rewards-mastercard",
      "name": "DoorDash Rewards Mastercard",
      "issuer": "Chase",
      "annual_fee": {
        "value": 0.0,
        "cents": 0,
        "formatted": "$0.00",
        "currency": "USD"
      },
      "reward_yield": {
        "value": 4.0,
        "unit": "%",
        "formatted": "4.0%",
        "basis_points": 400
      },
      "canonical_url": "https://www.axetip.com/card/doordash-rewards-mastercard/",
      "match_reason": "Co-brand partnership match",
      "is_co_brand": true
    }
  }
}

Benchmark Interest Rates (/api/benchmark)

Returns Federal Reserve H.15 money market rates, SOFR benchmarks, FOMC meeting calendars, commercial card rate spreads, and 10-year historical interest rate cycles. Detailed documentation: Benchmark Reference →.

GET https://www.axetip.com/api/benchmark
GET https://www.axetip.com/api/benchmark?series=history&limit=12
GET https://www.axetip.com/api/benchmark?series=fomc

Query Parameters

ParameterTypeRequiredDescription
seriesstringNoTarget data slice: history (10-year rate cycle series), fomc (meeting calendar and policy target), nim (net interest margin spread), or omitted for full overview.
limitintegerNoNumber of chronological periods to return when series=history (default: 12, max: 120).

Response Example (GET /api/benchmark)

{
  "source": "Federal Reserve Board of Governors H.15 & NY Fed",
  "status": "success",
  "as_of": "2026-09-16",
  "benchmarks": {
    "prime_rate": {
      "value": 7.0,
      "bps": 700,
      "formatted": "7.00%"
    },
    "sofr": {
      "value": 4.82,
      "bps": 482,
      "formatted": "4.82%"
    },
    "effective_fed_funds": {
      "value": 4.83,
      "bps": 483,
      "formatted": "4.83%"
    },
    "target_range": {
      "min": { "value": 4.75, "bps": 475, "formatted": "4.75%" },
      "max": { "value": 5.0, "bps": 500, "formatted": "5.00%" },
      "formatted": "4.75% - 5.00%"
    }
  },
  "fomc_calendar": {
    "next_meeting": "2026-10-28",
    "days_until_next": 42,
    "current_cycle_phase": "Rate cutting cycle",
    "upcoming_meetings": [
      { "date": "2026-10-28", "status": "scheduled" },
      { "date": "2026-12-09", "status": "scheduled" }
    ]
  },
  "credit_spread_model": {
    "benchmark_rate": { "value": 7.0, "bps": 700, "formatted": "7.00%" },
    "average_credit_card_apr": { "value": 30.45, "bps": 3045, "formatted": "30.45%" },
    "net_interest_margin_spread": {
      "bps": 2345,
      "percentage": 23.45,
      "formatted": "+2,345 bps (+23.45%)"
    },
    "note": "Statutory APR premium charged by commercial card issuers over Fed Prime benchmark."
  }
}

Card Optimization (/api/optimize)

Evaluates cards for a single transaction or a monthly spending profile. Checks merchant network acceptance rules (such as warehouse clubs that accept only Visa), co-brand cards, and category reward rates to determine the highest-earning card. Detailed documentation: Card Optimization Reference →.

GET https://www.axetip.com/api/optimize?merchant=doordash&amount=45&held_cards=amex-gold,citi-double-cash
POST https://www.axetip.com/api/optimize

Operational Modes

  • Single Transaction (mode: "transaction"): Evaluates held cards for a merchant purchase, checks network acceptance rules (e.g. Costco warehouse accepting Visa only), and shows incremental returns if an unheld card would earn more.
  • Monthly Spend Basket (mode: "basket"): Evaluates spending across dining, grocery, travel, and general purchases. Calculates annual rewards across the wallet and identifies unheld cards that provide the highest net return after annual fees.

Query Parameters & Request Body

ParameterTypeRequiredDescription
modestringNoOptimization mode: transaction (default) or basket.
merchantstringYes (transaction)Merchant name, alias, or slug (e.g. doordash, costco, delta).
amountnumberYes (transaction)Transaction amount in USD (e.g. 45.00 or 250).
held_cardsstring or arrayYesComma-separated query string (GET) or string array (POST) of cards in the user’s wallet.
monthly_spendobject or stringYes (basket)Category spend map (e.g. {"dining": 800, "grocery": 600, "general": 1200}).

Response Example 1: Point-of-Sale Transaction Routing with POS Quirk

{
  "source": "AxeTip Autonomous Routing Engine",
  "status": "success",
  "mode": "transaction",
  "routing_summary": "Recommended swipe for $250.00 at Costco Wholesale: Chase Freedom Unlimited® (1.5% yield). Warning: Costco physical warehouses accept Visa cards only at point of sale.",
  "transaction": {
    "merchant": "Costco Wholesale",
    "amount": { "value": 250.0, "cents": 25000, "formatted": "$250.00", "currency": "USD" },
    "primary_mcc": "5300",
    "primary_mcc_title": "Wholesale Clubs"
  },
  "pos_quirks": [
    {
      "type": "network_acceptance",
      "severity": "warning",
      "accepted_networks": ["Visa"],
      "rejected_networks": ["Mastercard", "American Express", "Discover"],
      "message": "Physical warehouse registers accept Visa credit cards only. Non-Visa cards were filtered from point-of-sale routing."
    }
  ],
  "optimal_held_card": {
    "id": "chase-freedom-unlimited",
    "name": "Chase Freedom Unlimited®",
    "network": "Visa",
    "annual_fee": { "value": 0.0, "cents": 0, "formatted": "$0.00", "currency": "USD" },
    "reward_yield": { "value": 1.5, "unit": "%", "formatted": "1.5%", "basis_points": 150 },
    "expected_return": { "value": 3.75, "cents": 375, "formatted": "$3.75", "currency": "USD" }
  },
  "held_card_ranking": [
    {
      "id": "chase-freedom-unlimited",
      "name": "Chase Freedom Unlimited®",
      "network": "Visa",
      "eligible_for_pos": true,
      "expected_return": { "value": 3.75, "cents": 375, "formatted": "$3.75", "currency": "USD" }
    },
    {
      "id": "citi-double-cash",
      "name": "Citi Double Cash® Card",
      "network": "Mastercard",
      "eligible_for_pos": false,
      "ineligibility_reason": "Mastercard not accepted at physical warehouse registers"
    }
  ],
  "unheld_card_opportunity": {
    "id": "costco-anywhere-visa",
    "name": "Costco Anywhere Visa® Card by Citi",
    "reward_yield": { "value": 2.0, "unit": "%", "formatted": "2.0%", "basis_points": 200 },
    "marginal_alpha_return": { "value": 1.25, "cents": 125, "formatted": "$1.25", "currency": "USD" }
  }
}

Response Example 2: Spend Basket Optimizer (POST /api/optimize)

{
  "status": "success",
  "mode": "basket",
  "summary": "Monthly spend of $3,100.00 across 4 categories generates $1,116.00 in gross annual rewards across current wallet. Acquiring American Express® Gold Card would yield +$284.00 net annual alpha after annual fee.",
  "annual_metrics": {
    "gross_annual_spend": { "value": 37200.0, "cents": 3720000, "formatted": "$37,200.00", "currency": "USD" },
    "gross_annual_return": { "value": 1116.0, "cents": 111600, "formatted": "$1,116.00", "currency": "USD" },
    "blended_effective_yield": { "value": 3.0, "unit": "%", "formatted": "3.00%", "basis_points": 300 }
  },
  "optimal_card_opportunity": {
    "card_id": "amex-gold",
    "card_name": "American Express® Gold Card",
    "annual_fee": { "value": 325.0, "cents": 32500, "formatted": "$325.00", "currency": "USD" },
    "gross_annual_alpha": { "value": 609.0, "cents": 60900, "formatted": "$609.00", "currency": "USD" },
    "net_annual_alpha": { "value": 284.0, "cents": 28400, "formatted": "$284.00", "currency": "USD" }
  }
}

Model Context Protocol (MCP) Setup

The official AxeTip MCP server is published on the npm registry: 👉 npmjs.com/package/@axetip/mcp-server ↗

Run directly without installation via npx:

npx -y @axetip/mcp-server

Or add the server to your MCP configuration (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "axetip": {
      "command": "npx",
      "args": ["-y", "@axetip/mcp-server"]
    }
  }
}

Developer Preview & Pricing

Access is currently available under a developer preview tier:

TierRate LimitsPriceTerms & Usage
Developer Preview10,000 req/day (60 req/min)$0 (Free through Dec 31, 2026)Development, evaluation, personal finance agents. Standard data attribution required.
Developer Pro25,000 req/month$49 / monthCommercial applications, rate limit bypass, uptime SLA.
Fintech / Business250,000 req/month$299 / monthHigh-volume apps, loan brokers, priority edge routing, webhook updates.
Enterprise Data FeedCustom / Bulk$999 / monthRaw quarterly CFPB bulk JSON/Parquet dumps, offline licenses, custom SLA.

Preview Notice: The developer preview tier is free through December 31, 2026. Metered billing and commercial SLAs begin January 1, 2027. Contact: [email protected]


Regulatory Standards & Data Provenance


Operational Guidelines

  • Launch Preview Rate Limit: Unauthenticated requests are permitted up to 60 requests per minute per IP (up to 10,000 requests/day).
  • Edge Caching: GET responses are cached globally at Cloudflare edge PoPs for 7 days (Cache-Control: public, s-maxage=604800, max-age=3600).
  • HTTP Methods: Supported via GET (query string parameters) and POST (JSON body).
  • CORS: Enabled by default (Access-Control-Allow-Origin: *) for browser-based applications and frontend widgets.