{"uid":"cap_ksV9HYmh0ZI0ItZtwpzIv","slug":"hostdefi-token-risk-history-652fdf32","name":"HostDeFi Token Risk History","description":"HostDeFi is a non-custodial Solana DEX. Best-route swaps through Jupiter, EVM trading across 7 chains, native bridging, and live token risk grades. No KYC, no accounts, no custody.","url":"https://hostdefi.com/api/v1/x402/token-risk/history/%7Bchain%7D/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["chain","address"],"properties":{"chain":{"type":"string","description":"Chain id: solana, ethereum, bsc, base, arbitrum, optimism, polygon, avalanche"},"address":{"type":"string","description":"Token contract address (base58 mint on Solana, 0x… on EVM)"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","maximum":365,"minimum":1,"description":"Daily rows returned: the most recent N days, oldest first (default 90)"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"rows":[{"ts":"2026-08-16T00:00:00.000Z","grade":"B","score":78,"priceUsd":0.00001,"volume24h":5000,"liquidityUsd":100000}],"chain":"solana","count":1,"address":"…"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nueb-hY5fSk8QPYBLfiEw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily historical risk grades, scores, price, volume, and liquidity for a token on Solana or EVM chains over up to 365 days","exampleAgentPrompt":"Pull the last 30 days of daily risk grade history for the Solana token at mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — I want to see how the score, price, and liquidity have trended.","exampleUseCases":[{"title":"Token safety due diligence before swap","prompt":"Before I swap into this Base chain token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, pull me the last 60 days of daily risk grades and scores so I can see if it's been consistently safe."},{"title":"Monitor meme coin risk over time","prompt":"Can you get me 90 days of historical risk data for this Solana meme coin at mint So11111111111111111111111111111111111111112 — I want to see the grade, volume, and liquidity for each day."},{"title":"Research token liquidity trend on Arbitrum","prompt":"Fetch the last 30 days of risk grade history for the Arbitrum token at 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8 — I'm trying to see if liquidity has been growing or shrinking."}],"resultDescription":"A JSON array of daily rows ordered oldest-first, each containing a timestamp, letter risk grade (e.g. A–F), numeric risk score (0–100), price in USD, 24-hour volume, and liquidity in USD. Also returns the chain identifier, token address, and row count.","failureModes":["Invalid or unsupported chain ID returns an error","Malformed token address (wrong format for the chain) returns an error","Token not found or untracked returns empty rows array","limit parameter out of range (< 1 or > 365) returns a validation error","Payment of 0.02 USDC not provided results in 402 response","Network or upstream data unavailability causes 5xx error"],"whenToPreferThis":"Use this endpoint when you need time-series risk intelligence for a specific token — such as trend analysis, due diligence before a swap, or monitoring a token's safety grade over days or weeks. It covers both Solana and 7 EVM chains in one API, making it preferable to chain-specific analytics tools. Choose this over a current-snapshot endpoint when historical trend matters, not just the latest grade.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T12:38:25.102Z","isFirstParty":false}