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
| Parameter | Type | In | Required | Description |
|---|---|---|---|---|
cards | string | Query (GET) | Yes | Comma-separated query string of 1 to 5 card slugs or search terms (e.g. amex-gold or amex-gold,chase-sapphire-preferred). |
cards | array | Body (POST) | Yes | JSON array of 1 to 5 card slugs or search terms (e.g. ["amex-gold", "chase-sapphire-preferred"]). |
Request Headers
| Header | Value | Description |
|---|---|---|
Accept | application/json | Expected response content type. |
Content-Type | application/json | Required for POST requests. |
Operational Modes
The endpoint automatically determines its operational mode based on the input:
- 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. - 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. - Variant Matching: Ambiguous queries (e.g.
"amex blue") match multiple products and return all matches in thecardsarray with disambiguation notes inambiguity_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
| Field | Type | Description |
|---|---|---|
status | string | Status of the request ("success" or "error"). |
mode | string | Operational mode: "lookup" or "comparison". |
cards_count | integer | Number of cards matched and returned. |
benchmark | object | Current Federal Reserve Prime rate benchmark data. |
benchmark.prime_rate | InterestRate | Current Prime rate as an integer basis points object. |
benchmark.as_of | string | Date of the latest Federal Reserve H.15 release (YYYY-MM-DD). |
verdict | string | Automated summary or side-by-side comparison verdict. |
cards | array | Array of card data objects. |
cards[].id | string | Canonical card identifier (slug). |
cards[].name | string | Official product name. |
cards[].issuer | string | Issuing financial institution. |
cards[].network | string | Payment network (Visa, Mastercard, American Express, Discover). |
cards[].annual_fee | MoneyAmount | Annual fee in integer cents and formatted text. |
cards[].calculated.effective_purchase_apr | object | Purchase 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 Code | Description |
|---|---|
200 OK | Request succeeded. Cards and benchmark calculations returned. |
400 Bad Request | Missing or invalid cards parameter. |
404 Not Found | No matching card products found for query. |
429 Too Many Requests | Rate limit exceeded (60 requests/minute). |