The /api/cards endpoint returns statutory pricing baselines, verified CFPB credit card agreement filings (TILA § 122(d)), fee schedules, statement credit offsets, reward category multipliers, and effective purchase APRs dynamically calculated against the latest Federal Reserve H.15 Prime rate.

To test this endpoint interactively, use the API Explorer.


Request

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

Parameters

ParameterTypeInRequiredDescription
cardsstringQuery (GET)YesComma-separated query string of 1 to 5 card slugs or search terms (e.g. amex-gold or amex-gold,chase-sapphire-preferred).
cardsarrayBody (POST)YesJSON array of 1 to 5 card slugs or search terms (e.g. ["amex-gold", "chase-sapphire-preferred"]).

Request Headers

HeaderValueDescription
Acceptapplication/jsonExpected response content type.
Content-Typeapplication/jsonRequired for POST requests.

Operational Modes

The endpoint automatically determines its operational mode based on the input:

  1. Single Card (mode: "lookup"): Passing 1 card identifier returns the full statutory terms, bank margins, grace periods, CDN image URLs, live Fed Prime APR calculations, and a concise summary verdict.
  2. Comparison (mode: "comparison"): Passing 2 to 5 cards returns full schemas side-by-side with a deterministic comparison verdict evaluating annual fees, top category yields, and grace periods.
  3. Variant Matching: Ambiguous queries (e.g. "amex blue") match multiple products and return all matches in the cards array with disambiguation notes in ambiguity_notes.

Effective APR Calculation

Credit card agreements index variable purchase APRs to the Wall Street Journal / Federal Reserve Prime Rate:

$$\text{Effective APR} = \text{Federal Reserve Prime Rate} + \text{Bank Margin}$$

For example, with the Federal Reserve Prime rate at 7.00% (700 bps) and the American Express® Gold Card bank margin schedule at 12.74% – 21.74% (1,274 – 2,174 bps):

$$\text{Effective Purchase APR} = 7.00% + [12.74%, 21.74%] = 19.74% - 28.74%$$


Response Schema

FieldTypeDescription
statusstringStatus of the request ("success" or "error").
modestringOperational mode: "lookup" or "comparison".
cards_countintegerNumber of cards matched and returned.
benchmarkobjectCurrent Federal Reserve Prime rate benchmark data.
benchmark.prime_rateInterestRateCurrent Prime rate as an integer basis points object.
benchmark.as_ofstringDate of the latest Federal Reserve H.15 release (YYYY-MM-DD).
verdictstringAutomated summary or side-by-side comparison verdict.
cardsarrayArray of card data objects.
cards[].idstringCanonical card identifier (slug).
cards[].namestringOfficial product name.
cards[].issuerstringIssuing financial institution.
cards[].networkstringPayment network (Visa, Mastercard, American Express, Discover).
cards[].annual_feeMoneyAmountAnnual fee in integer cents and formatted text.
cards[].calculated.effective_purchase_aprobjectPurchase APR ranges calculated against live Fed Prime.

Example Responses

1. Single Card Lookup (GET /api/cards?cards=amex-gold)

{
  "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"
        }
      }
    }
  ]
}

2. Card Comparison (POST /api/cards)

POST https://www.axetip.com/api/cards
Content-Type: application/json

{
  "cards": ["amex-gold", "chase-sapphire-preferred"]
}

Code Samples

cURL

curl -s "https://www.axetip.com/api/cards?cards=amex-gold,chase-sapphire-preferred"

TypeScript / Node.js

interface MoneyAmount {
  value: number;
  cents: number;
  formatted: string;
  currency: string;
}

interface InterestRate {
  value: number;
  bps: number;
  formatted: string;
}

interface CardResponse {
  status: "success" | "error";
  mode: "lookup" | "comparison";
  verdict: string;
  benchmark: { prime_rate: InterestRate; as_of: string };
  cards: Array<{
    id: string;
    name: string;
    annual_fee: MoneyAmount;
    calculated: {
      effective_purchase_apr: {
        effective_min: InterestRate;
        effective_max: InterestRate;
      };
    };
  }>;
}

const res = await fetch("https://www.axetip.com/api/cards?cards=amex-gold,chase-sapphire-preferred");
const data: CardResponse = await res.json();
console.log(`Fed Prime: ${data.benchmark.prime_rate.formatted}`);
for (const card of data.cards) {
  const apr = card.calculated.effective_purchase_apr;
  console.log(`- ${card.name}: ${card.annual_fee.formatted} (APR ${apr.effective_min.formatted} - ${apr.effective_max.formatted})`);
}

Python

import httpx

url = "https://www.axetip.com/api/cards"
params = {"cards": "amex-gold,chase-sapphire-preferred"}
response = httpx.get(url, params=params, timeout=10.0)
data = response.json()

print(f"Fed Prime: {data['benchmark']['prime_rate']['formatted']}")
for card in data["cards"]:
    apr = card["calculated"]["effective_purchase_apr"]
    print(f"- {card['name']}: {card['annual_fee']['formatted']} (APR {apr['effective_min']['formatted']} - {apr['effective_max']['formatted']})")

Go

package main

import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

type CardResponse struct {
	Verdict   string `json:"verdict"`
	Benchmark struct {
		PrimeRate struct {
			Formatted string `json:"formatted"`
			Bps       int    `json:"bps"`
		} `json:"prime_rate"`
	} `json:"benchmark"`
	Cards []struct {
		Name      string `json:"name"`
		AnnualFee struct {
			Formatted string `json:"formatted"`
			Cents     int64  `json:"cents"`
		} `json:"annual_fee"`
	} `json:"cards"`
}

func main() {
	resp, _ := http.Get("https://www.axetip.com/api/cards?cards=amex-gold,chase-sapphire-preferred")
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)

	var data CardResponse
	json.Unmarshal(body, &data)
	fmt.Printf("Fed Prime: %s (%d bps)\n", data.Benchmark.PrimeRate.Formatted, data.Benchmark.PrimeRate.Bps)
	for _, c := range data.Cards {
		fmt.Printf("- %s: %s [%d cents]\n", c.Name, c.AnnualFee.Formatted, c.AnnualFee.Cents)
	}
}

Status Codes

Status CodeDescription
200 OKRequest succeeded. Cards and benchmark calculations returned.
400 Bad RequestMissing or invalid cards parameter.
404 Not FoundNo matching card products found for query.
429 Too Many RequestsRate limit exceeded (60 requests/minute).