{"openapi":"3.0.3","info":{"title":"Alt402","version":"1.0.0","description":"Market intelligence for altcoins, built for AI agents and paid per call on Algorand x402. Market intelligence for information only, not financial advice."},"servers":[{"url":"https://one00xaltcoin.onrender.com"}],"paths":{"/v1/gems":{"get":{"operationId":"gems","summary":"Top 100x altcoin candidates right now: up to 50 small-cap coins (1M-50M USD market cap) ranked by a 0-100 score from turnover, CoinMarketCap rank climb, listing age and sector heat, each with plain-English reasons and risk flags.","description":"Top 100x altcoin candidates right now: up to 50 small-cap coins (1M-50M USD market cap) ranked by a 0-100 score from turnover, CoinMarketCap rank climb, listing age and sector heat, each with plain-English reasons and risk flags. Costs $0.02 in USDC on Algorand per call via x402. Errors are never charged.","x-payment":{"protocol":"x402","x402Version":2,"scheme":"exact","price":"$0.02","network":"algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=","asset":"31566704"},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"parameters":[{"name":"max_market_cap","in":"query","required":false,"description":"Largest market cap in USD still considered early.","schema":{"description":"Largest market cap in USD still considered early.","type":"number","minimum":0,"default":50000000}},{"name":"min_market_cap","in":"query","required":false,"description":"Smallest market cap in USD; filters out dust.","schema":{"description":"Smallest market cap in USD; filters out dust.","type":"number","minimum":0,"default":1000000}},{"name":"min_volume","in":"query","required":false,"description":"Minimum 24h volume in USD.","schema":{"description":"Minimum 24h volume in USD.","type":"number","minimum":0,"default":100000}},{"name":"listed_within_days","in":"query","required":false,"description":"Only assets listed on CMC within this many days; 0 means any age.","schema":{"description":"Only assets listed on CMC within this many days; 0 means any age.","type":"integer","minimum":0,"maximum":365,"default":0}},{"name":"sector","in":"query","required":false,"description":"Only assets carrying this CMC tag, e.g. ai-big-data.","schema":{"description":"Only assets carrying this CMC tag, e.g. ai-big-data.","type":"string","maxLength":60},"example":"ai-big-data"},{"name":"include_pumped","in":"query","required":false,"description":"Keep assets already up more than 100% in 24h or 300% in 7d.","schema":{"description":"Keep assets already up more than 100% in 24h or 300% in 7d.","type":"boolean","default":false}},{"name":"limit","in":"query","required":false,"description":"Maximum number of rows returned.","schema":{"description":"Maximum number of rows returned.","type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Success; the PAYMENT-RESPONSE header carries the settlement receipt.","content":{"application/json":{"example":{"data":[{"symbol":"AGRIPPA","name":"Agrippa","market_cap":3500000,"volume_24h":2000000,"turnover":0.57,"change_24h_pct":-13.8,"score":55,"confidence":"low","why":["Listed 7 days ago","Turnover 0.57 (volume vs market cap)"],"risk_flags":["insufficient_history","micro_cap","new_and_unproven"]}]}}}},"400":{"description":"Invalid or unknown parameter. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The base64 PAYMENT-REQUIRED header lists the USDC amount, asset, network and payTo."},"404":{"description":"Coin or sector not found. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Data not ready, stale, or not enough history for climbers. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/screen":{"get":{"operationId":"screen","summary":"Coin screener over the tracked CoinMarketCap top coins: filter by market cap, 24h volume, turnover, 1h/24h/7d price change, tags and listing age. By default returns the 10 highest-turnover coins under 50M USD market cap.","description":"Coin screener over the tracked CoinMarketCap top coins: filter by market cap, 24h volume, turnover, 1h/24h/7d price change, tags and listing age. By default returns the 10 highest-turnover coins under 50M USD market cap. Costs $0.01 in USDC on Algorand per call via x402. Errors are never charged.","x-payment":{"protocol":"x402","x402Version":2,"scheme":"exact","price":"$0.01","network":"algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=","asset":"31566704"},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"min_market_cap","in":"query","required":false,"description":"Minimum market cap in USD.","schema":{"description":"Minimum market cap in USD.","type":"number"}},{"name":"max_market_cap","in":"query","required":false,"description":"Maximum market cap in USD; 0 means no cap.","schema":{"description":"Maximum market cap in USD; 0 means no cap.","type":"number","minimum":0,"default":50000000}},{"name":"min_volume","in":"query","required":false,"description":"Minimum 24h volume in USD.","schema":{"description":"Minimum 24h volume in USD.","type":"number"}},{"name":"max_volume","in":"query","required":false,"description":"Maximum 24h volume in USD.","schema":{"description":"Maximum 24h volume in USD.","type":"number"}},{"name":"min_turnover","in":"query","required":false,"description":"Minimum turnover (24h volume divided by market cap).","schema":{"description":"Minimum turnover (24h volume divided by market cap).","type":"number"}},{"name":"min_change_1h_pct","in":"query","required":false,"description":"Minimum 1h price change in percent.","schema":{"description":"Minimum 1h price change in percent.","type":"number"}},{"name":"max_change_1h_pct","in":"query","required":false,"description":"Maximum 1h price change in percent.","schema":{"description":"Maximum 1h price change in percent.","type":"number"}},{"name":"min_change_24h_pct","in":"query","required":false,"description":"Minimum 24h price change in percent.","schema":{"description":"Minimum 24h price change in percent.","type":"number"}},{"name":"max_change_24h_pct","in":"query","required":false,"description":"Maximum 24h price change in percent.","schema":{"description":"Maximum 24h price change in percent.","type":"number"}},{"name":"min_change_7d_pct","in":"query","required":false,"description":"Minimum 7d price change in percent.","schema":{"description":"Minimum 7d price change in percent.","type":"number"}},{"name":"max_change_7d_pct","in":"query","required":false,"description":"Maximum 7d price change in percent.","schema":{"description":"Maximum 7d price change in percent.","type":"number"}},{"name":"tag","in":"query","required":false,"description":"Comma list of CMC tags; an asset matches if it carries any of them.","schema":{"description":"Comma list of CMC tags; an asset matches if it carries any of them.","type":"string","maxLength":300},"example":"memes,solana-ecosystem"},{"name":"listed_within_days","in":"query","required":false,"description":"Only assets listed within this many days; 0 means any age.","schema":{"description":"Only assets listed within this many days; 0 means any age.","type":"integer","minimum":0,"maximum":365,"default":0}},{"name":"exclude_stablecoins","in":"query","required":false,"description":"Drop stablecoins and wrapped tokens.","schema":{"description":"Drop stablecoins and wrapped tokens.","type":"boolean","default":true}},{"name":"sort","in":"query","required":false,"description":"Sort key.","schema":{"description":"Sort key.","type":"string","enum":["turnover","change_1h_pct","change_24h_pct","change_7d_pct","volume_24h","market_cap","rank"],"default":"turnover"}},{"name":"order","in":"query","required":false,"description":"Sort order; desc by default, asc for rank.","schema":{"description":"Sort order; desc by default, asc for rank.","type":"string","enum":["asc","desc"]}},{"name":"limit","in":"query","required":false,"description":"Maximum number of rows returned.","schema":{"description":"Maximum number of rows returned.","type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Success; the PAYMENT-RESPONSE header carries the settlement receipt.","content":{"application/json":{"example":{"data":[{"symbol":"QUQ","market_cap":1600000,"volume_24h":119000000,"turnover":73.96,"change_24h_pct":0},{"symbol":"AEON","market_cap":12600000,"volume_24h":441500000,"turnover":35.02,"change_24h_pct":0.7}]}}}},"400":{"description":"Invalid or unknown parameter. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The base64 PAYMENT-REQUIRED header lists the USDC amount, asset, network and payTo."},"404":{"description":"Coin or sector not found. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Data not ready, stale, or not enough history for climbers. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/climbers":{"get":{"operationId":"climbers","summary":"Biggest CoinMarketCap rank climbers of the last 24 hours: each coin's rank now and 24h ago, rank change in places and percent, price change, market cap and volume. direction=down returns the biggest fallers.","description":"Biggest CoinMarketCap rank climbers of the last 24 hours: each coin's rank now and 24h ago, rank change in places and percent, price change, market cap and volume. direction=down returns the biggest fallers. Costs $0.01 in USDC on Algorand per call via x402. Errors are never charged.","x-payment":{"protocol":"x402","x402Version":2,"scheme":"exact","price":"$0.01","network":"algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=","asset":"31566704"},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"direction","in":"query","required":false,"description":"up for climbers, down for fallers.","schema":{"description":"up for climbers, down for fallers.","type":"string","enum":["up","down"],"default":"up"}},{"name":"min_volume","in":"query","required":false,"description":"Minimum 24h volume in USD.","schema":{"description":"Minimum 24h volume in USD.","type":"number","minimum":0,"default":100000}},{"name":"max_market_cap","in":"query","required":false,"description":"Maximum market cap in USD; 0 means no cap.","schema":{"description":"Maximum market cap in USD; 0 means no cap.","type":"number","minimum":0,"default":0}},{"name":"limit","in":"query","required":false,"description":"Maximum number of rows returned.","schema":{"description":"Maximum number of rows returned.","type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Success; the PAYMENT-RESPONSE header carries the settlement receipt.","content":{"application/json":{"example":{"data":[{"symbol":"KSM","name":"Kusama","rank":197,"rank_then":265,"rank_change":68,"rank_change_pct":25.66,"market_cap":98400000,"volume_24h":23200000,"change_24h_pct":11.9}]}}}},"400":{"description":"Invalid or unknown parameter. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The base64 PAYMENT-REQUIRED header lists the USDC amount, asset, network and payTo."},"404":{"description":"Coin or sector not found. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Data not ready, stale, or not enough history for climbers. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/sectors":{"get":{"operationId":"sectors","summary":"Hottest crypto sectors right now: CoinMarketCap tags ranked by heat (median 24h move of their coins), with member count, 7d change, volume, market cap and the top 3 leading coins. sector=<tag> returns that sector's coins.","description":"Hottest crypto sectors right now: CoinMarketCap tags ranked by heat (median 24h move of their coins), with member count, 7d change, volume, market cap and the top 3 leading coins. sector=<tag> returns that sector's coins. Costs $0.01 in USDC on Algorand per call via x402. Errors are never charged.","x-payment":{"protocol":"x402","x402Version":2,"scheme":"exact","price":"$0.01","network":"algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=","asset":"31566704"},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"sort","in":"query","required":false,"description":"Sort key for the sector list.","schema":{"description":"Sort key for the sector list.","type":"string","enum":["heat","change_24h_pct","change_7d_pct","volume_24h","market_cap"],"default":"heat"}},{"name":"min_members","in":"query","required":false,"description":"Smallest sector size listed.","schema":{"description":"Smallest sector size listed.","type":"integer","minimum":2,"maximum":200,"default":5}},{"name":"sector","in":"query","required":false,"description":"Return this sector's members instead of the list; matched loosely (AI Big Data = ai-big-data).","schema":{"description":"Return this sector's members instead of the list; matched loosely (AI Big Data = ai-big-data).","type":"string","maxLength":60},"example":"account-abstraction"},{"name":"limit","in":"query","required":false,"description":"Maximum number of rows returned.","schema":{"description":"Maximum number of rows returned.","type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Success; the PAYMENT-RESPONSE header carries the settlement receipt.","content":{"application/json":{"example":{"data":[{"tag":"account-abstraction","heat":20,"median_change_24h_pct":3,"leaders":[{"symbol":"PHA"},{"symbol":"NEAR"},{"symbol":"ADX"}]}]}}}},"400":{"description":"Invalid or unknown parameter. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The base64 PAYMENT-REQUIRED header lists the USDC amount, asset, network and payTo."},"404":{"description":"Coin or sector not found. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Data not ready, stale, or not enough history for climbers. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/asset":{"get":{"operationId":"asset","summary":"Full 100x scorecard for one coin by symbol, name, slug or CMC id: price, market cap, supply, 0-100 score with signal breakdown, reasons, risk flags and hourly rank history.","description":"Full 100x scorecard for one coin by symbol, name, slug or CMC id: price, market cap, supply, 0-100 score with signal breakdown, reasons, risk flags and hourly rank history. Costs $0.01 in USDC on Algorand per call via x402. Errors are never charged.","x-payment":{"protocol":"x402","x402Version":2,"scheme":"exact","price":"$0.01","network":"algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=","asset":"31566704"},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"asset","in":"query","required":false,"description":"CMC id, symbol, slug or name of a coin in the tracked top N (default ETH, so a bare call still returns a result).","schema":{"description":"CMC id, symbol, slug or name of a coin in the tracked top N (default ETH, so a bare call still returns a result).","type":"string","maxLength":100,"default":"ETH"},"example":"MOVR"}],"responses":{"200":{"description":"Success; the PAYMENT-RESPONSE header carries the settlement receipt.","content":{"application/json":{"example":{"data":{"symbol":"MOVR","name":"Moonriver","rank":663,"market_cap":22400000,"volume_24h":118700000,"turnover":5.29,"change_24h_pct":76.4,"score":52,"confidence":"low","why":["Turnover 5.29 (volume vs market cap)","Climbed 22% in rank over 24h (#846 -> #663)"]}}}}},"400":{"description":"Invalid or unknown parameter. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The base64 PAYMENT-REQUIRED header lists the USDC amount, asset, network and payTo."},"404":{"description":"Coin or sector not found. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Data not ready, stale, or not enough history for climbers. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/digest":{"get":{"operationId":"digest","summary":"Daily altcoin digest in one call: the top 5 100x candidates with scores, the 3 biggest 24h rank climbers and the 3 hottest sectors with their leading coins.","description":"Daily altcoin digest in one call: the top 5 100x candidates with scores, the 3 biggest 24h rank climbers and the 3 hottest sectors with their leading coins. Costs $0.03 in USDC on Algorand per call via x402. Errors are never charged.","x-payment":{"protocol":"x402","x402Version":2,"scheme":"exact","price":"$0.03","network":"algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=","asset":"31566704"},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"parameters":[{"name":"gems","in":"query","required":false,"description":"Number of top gems.","schema":{"description":"Number of top gems.","type":"integer","minimum":1,"maximum":20,"default":5}},{"name":"climbers","in":"query","required":false,"description":"Number of rank climbers (empty until 24h of history exist).","schema":{"description":"Number of rank climbers (empty until 24h of history exist).","type":"integer","minimum":1,"maximum":20,"default":3}},{"name":"sectors","in":"query","required":false,"description":"Number of hot sectors.","schema":{"description":"Number of hot sectors.","type":"integer","minimum":1,"maximum":20,"default":3}}],"responses":{"200":{"description":"Success; the PAYMENT-RESPONSE header carries the settlement receipt.","content":{"application/json":{"example":{"data":{"top_gems":[{"symbol":"PAID","score":67,"market_cap":10500000,"change_24h_pct":-15.4}],"climbers":[{"symbol":"KSM","rank_then":265,"rank":197}],"hot_sectors":[{"tag":"account-abstraction","heat":20}]}}}}},"400":{"description":"Invalid or unknown parameter. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The base64 PAYMENT-REQUIRED header lists the USDC amount, asset, network and payTo."},"404":{"description":"Coin or sector not found. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Data not ready, stale, or not enough history for climbers. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","required":["code","message","next_step"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"next_step":{"type":"string"}}}}}}}}