{"openapi":"3.1.0","info":{"title":"cryptocard.guide public data API","version":"1.0.0","description":"Reviewed crypto card facts, explainable recommendations and current user offers. Product fit is evaluated before any promotion is attached."},"servers":[{"url":"https://cryptocard.guide"}],"externalDocs":{"description":"Agent and API guide","url":"https://cryptocard.guide/for-agents"},"paths":{"/api/v1/cards":{"get":{"operationId":"listCards","summary":"List published card profiles","responses":{"200":{"description":"Published card index","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/cards/{slug}":{"get":{"operationId":"getCard","summary":"Get one published card profile","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published card profile","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Card not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/recommendations":{"get":{"operationId":"recommendCards","summary":"Rank cards for a structured user need","description":"Hard funding and asset requirements are applied before deterministic ranking. Active user offers are joined only after the ranked result is complete.","parameters":[{"name":"country","in":"query","required":false,"description":"A country code from the site selector, such as US, CA, GB or DE. EU, EEA and ALL are also accepted.","schema":{"type":"string","example":"US"}},{"name":"funding","in":"query","required":false,"description":"Required funding method. Crypto includes reviewed on-chain funding from an external wallet.","schema":{"type":"string","enum":["any","crypto","bank","card","internal"],"default":"any"}},{"name":"asset","in":"query","required":false,"description":"One code or a comma-separated list. Every requested asset is required.","schema":{"type":"string","example":"USDC,USDT"}},{"name":"scenario","in":"query","required":false,"description":"Ranking lens. stablecoin_spend is an additional API scenario beyond the main catalogue controls.","schema":{"type":"string","enum":["overall","cashback","travel","funds_control","low_fees","stablecoin_spend","transfers"],"default":"overall"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Ranked card recommendations with separate fit and commercial layers","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/offers":{"get":{"operationId":"listOffers","summary":"List reviewed user-facing card offers","parameters":[{"name":"country","in":"query","required":false,"description":"A country code from the site selector, such as US, CA, GB or DE. EU, EEA and ALL are also accepted.","schema":{"type":"string","example":"US"}},{"name":"audience","in":"query","required":false,"schema":{"type":"string","enum":["all","new_user","existing_cardholder","referrer","all_eligible_users"],"default":"all"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["all","active","upcoming","ended"],"default":"active"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["ending_soon","recently_added","provider","value_at_requirement"],"default":"ending_soon"}},{"name":"benefit","in":"query","required":false,"schema":{"type":"string","enum":["all","cashback_boost","sign_up_bonus","spend_bonus","plan_discount","merchant_perk","fee_discount","other"],"default":"all"}},{"name":"duration","in":"query","required":false,"schema":{"type":"string","enum":["all","time_limited","ongoing"],"default":"all"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":100}}],"responses":{"200":{"description":"Reviewed offer register","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}