{"openapi":"3.1.0","info":{"title":"Deepnets API","version":"1.0.0","description":"Solana token intelligence API. Provides safety analysis, holder breakdowns, funding-network graphs, social research, trending tokens, and watchlist data for Solana SPL tokens. Payments via x402 (USDC on Solana).","x-guidance":"All token endpoints accept a Solana mint address (base58 string, typically 32-44 chars). Start with GET /api/token-safety/{mint} to check a token's risk level before deeper analysis. Use GET /api/watchlist to discover interesting tokens. GET /api/token-details/{mint} ($0.15) gives the deepest holder breakdown  - use it when you need network and individual holder data. Use GET /api/wallet-details/{address} and GET /api/network-details/{networkAddress} to investigate wallets and funding networks. Basic reads cost $0.01; holder analysis costs $0.15. All responses are JSON."},"paths":{"/api/token-safety/{mint}":{"get":{"operationId":"getTokenSafety","summary":"Token safety analysis","description":"Returns the most recent safety analysis for a Solana token: overall risk level, wallet-network concentration, bundle detection, mintable/freezable flags, critical risks, and warnings.","tags":["Safety"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"}],"responses":{"200":{"description":"Safety analysis for the token","content":{"application/json":{"schema":{"type":"object","properties":{"mint":{"type":"string","description":"Solana mint address"},"overallSafetyLevel":{"type":"string","enum":["SAFE","OK","RISKY","DANGEROUS"],"description":"Aggregate risk level"},"topNetworkOwnership":{"type":"number","description":"Largest funding-network ownership %"},"topNetworkWalletCount":{"type":"integer","description":"Wallet count in the top network"},"topHolderOwnership":{"type":"number","description":"Largest single holder %"},"topTenOwnership":{"type":"number","description":"Top-10 holders combined %"},"totalHolders":{"type":"integer"},"isMintable":{"type":"boolean"},"isFreezable":{"type":"boolean"},"criticalRisks":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"402":{"description":"Payment Required"},"404":{"description":"No safety analysis available for this token"}}}},"/api/token/{mint}/stats":{"get":{"operationId":"getTokenStats","summary":"Token price and stats","description":"Aggregate stats for a Solana token: price in SOL and USD, market cap, holder count, and last analysis timestamp.","tags":["Token Data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"}],"responses":{"200":{"description":"Token stats","content":{"application/json":{"schema":{"type":"object","properties":{"mint":{"type":"string"},"priceSol":{"type":["number","null"]},"priceUsd":{"type":["number","null"]},"marketCapUsd":{"type":["number","null"]},"totalHolders":{"type":["integer","null"]},"analyzedAt":{"type":["string","null"],"format":"date-time"}}}}}},"402":{"description":"Payment Required"}}}},"/api/token/{mint}/holder-graph":{"get":{"operationId":"getHolderGraph","summary":"Holder funding-source graph","description":"Funding-source graph for a token: nodes are wallets, edges are first-funding relationships, labeled with exchange attributions where known. Useful for visualizing wallet networks.","tags":["Holders"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"},{"name":"limit","in":"query","schema":{"type":"integer"},"description":"Max holders to include","required":false},{"name":"minPercent","in":"query","schema":{"type":"number"},"description":"Minimum ownership % to include","required":false}],"responses":{"200":{"description":"Holder graph with nodes and edges","content":{"application/json":{"schema":{"type":"object","properties":{"mint":{"type":"string"},"nodes":{"type":"array","items":{"type":"object"}},"edges":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment Required"},"404":{"description":"No holder analysis available"}}}},"/api/social_research/{mint}":{"get":{"operationId":"getSocialResearch","summary":"AI social research","description":"AI-generated social research for a token: Twitter/X activity, Telegram presence, website analysis, mentions, sentiment, and entity verification.","tags":["Research"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"}],"responses":{"200":{"description":"Social research report","content":{"application/json":{"schema":{"type":"object","properties":{"mint":{"type":"string"},"summary":{"type":"string","description":"AI-generated summary of social presence"},"twitter":{"type":"object","description":"Twitter/X analysis"},"telegram":{"type":"object","description":"Telegram analysis"},"website":{"type":"object","description":"Website analysis"}}}}}},"402":{"description":"Payment Required"},"404":{"description":"No social research available for this token"}}}},"/api/streamflow-locks/{mint}":{"get":{"operationId":"getStreamflowLocks","summary":"Streamflow vesting locks","description":"Streamflow vesting contracts for a token  - locked supply and unlock schedule.","tags":["Token Data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"}],"responses":{"200":{"description":"Vesting lock data","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/api/tibane-staking/{mint}":{"get":{"operationId":"getTibaneStaking","summary":"Tibane staking stats","description":"Tibane staking stats for a token  - total staked supply and number of stakers.","tags":["Token Data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"}],"responses":{"200":{"description":"Staking data","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/api/flagged-tokens":{"get":{"operationId":"getFlaggedTokens","summary":"Recently flagged tokens","description":"List of recently flagged Solana tokens (DANGEROUS or RISKY safety level) with reasons and risk details.","tags":["Safety"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"maximum":30},"description":"Max tokens to return (default 10, max 30)"}],"responses":{"200":{"description":"Array of flagged tokens","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"mint":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"overallSafetyLevel":{"type":"string","enum":["RISKY","DANGEROUS"]},"criticalRisks":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}}}}}}},"402":{"description":"Payment Required"}}}},"/api/watchlist":{"get":{"operationId":"getWatchlist","summary":"Active watchlist","description":"The active deepnets watchlist  - high-volume Solana tokens that passed the safety screen, with current safety data, price, and market cap.","tags":["Discovery"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"maximum":100},"description":"Max tokens to return (default 10, max 100)"}],"responses":{"200":{"description":"Array of watchlisted tokens","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"mint":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"overallSafetyLevel":{"type":"string"},"marketCapUsd":{"type":"number"},"totalHolders":{"type":"integer"}}}}}}},"402":{"description":"Payment Required"}}}},"/api/token-safety-history/{mint}":{"get":{"operationId":"getTokenSafetyHistory","summary":"Historical safety analyses","description":"Historical safety analyses for a token. Each snapshot records overall risk, warnings, critical risks, and holder metrics at that point in time.","tags":["Safety"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"}],"responses":{"200":{"description":"Array of historical safety snapshots","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"mint":{"type":"string"},"overallSafetyLevel":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"totalHolders":{"type":"integer"},"criticalRisks":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}}}}}}},"402":{"description":"Payment Required"}}}},"/api/token-details/{mint}":{"get":{"operationId":"getTokenDetails","summary":"Full holder breakdown","description":"Full holder breakdown for a token: every detected wallet-funding network with member wallets and ownership %, top individual holders, exchange-funded distribution, rugger tags, and lock/stake flags.","tags":["Holders"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"}],"responses":{"200":{"description":"Detailed holder analysis","content":{"application/json":{"schema":{"type":"object","properties":{"mint":{"type":"string"},"totalHolders":{"type":"integer"},"walletsAnalyzed":{"type":"integer"},"topNetworkOwnership":{"type":"number"},"networkBundles":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Network root funding address"},"name":{"type":"string"},"percentOwnership":{"type":"number"},"riskLevel":{"type":"string"},"accounts":{"type":"array","items":{"type":"object"}}}}},"individualHolders":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"percentage":{"type":"number"},"riskLevel":{"type":"string"}}}}}}}}},"402":{"description":"Payment Required"},"404":{"description":"No holder analysis available"}}}},"/api/token-details/{mint}/{analysis}":{"get":{"operationId":"getTokenDetailsHistorical","summary":"Historical holder snapshot","description":"Historical holder-analysis snapshot for a token at a specific epoch-second timestamp. Same shape as /api/token-details/{mint}.","tags":["Holders"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"},{"name":"analysis","in":"path","required":true,"schema":{"type":"string"},"description":"Epoch-second timestamp of the analysis snapshot"}],"responses":{"200":{"description":"Historical holder analysis snapshot","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"},"404":{"description":"Snapshot not found"}}}},"/api/holder-analysis/{mint}":{"get":{"operationId":"getHolderAnalysis","summary":"Full holder breakdown (alias)","description":"Alias of /api/token-details/{mint}. Full holder breakdown with networks, individual holders, and exchange distribution.","tags":["Holders"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"}],"responses":{"200":{"description":"Detailed holder analysis","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/api/holder-analysis/{mint}/{analysis}":{"get":{"operationId":"getHolderAnalysisHistorical","summary":"Historical holder snapshot (alias)","description":"Alias of /api/token-details/{mint}/{analysis}. Historical holder-analysis snapshot at a specific epoch-second timestamp.","tags":["Holders"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"mint","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana token mint address (base58)"},{"name":"analysis","in":"path","required":true,"schema":{"type":"string"},"description":"Epoch-second timestamp"}],"responses":{"200":{"description":"Historical holder analysis snapshot","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/api/wallet-details/{address}":{"get":{"operationId":"getWalletDetails","summary":"Wallet profile","description":"Wallet profile: funding source, network membership, exchange attribution, tags, and tokens created by this wallet.","tags":["Wallets"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana wallet address (base58)"}],"responses":{"200":{"description":"Wallet details","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"fundingSource":{"type":["string","null"],"description":"Immediate funder address"},"exchange":{"type":["string","null"],"description":"Exchange attribution (e.g. Binance, Coinbase)"},"label":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"network":{"type":["object","null"],"description":"Funding network this wallet belongs to","properties":{"address":{"type":"string"},"name":{"type":["string","null"]},"totalSize":{"type":"integer"}}},"tokensCreatedCount":{"type":"integer"},"directlyFundedCount":{"type":"integer"},"tokensCreated":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment Required"},"404":{"description":"Wallet not found"}}}},"/api/wallet-details/{address}/children":{"get":{"operationId":"getWalletChildren","summary":"Funded wallets","description":"Wallets directly funded by a given address  - one-hop children in the funding tree.","tags":["Wallets"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Solana wallet address (base58)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"Page number"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"maximum":100},"description":"Results per page (max 100)"}],"responses":{"200":{"description":"Paginated list of funded wallets","content":{"application/json":{"schema":{"type":"object","properties":{"wallets":{"type":"array","items":{"type":"object"}},"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"},"totalPages":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/network-details/{networkAddress}":{"get":{"operationId":"getNetworkDetails","summary":"Funding network overview","description":"Funding-network overview: tokens bundled or created by a wallet network, with holder percentages, risk levels, and network wallet count.","tags":["Networks"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"networkAddress","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Root funding address of the wallet network (base58)"},{"name":"tab","in":"query","required":false,"schema":{"type":"string","enum":["bundled","created"],"default":"bundled"},"description":"View bundled or created tokens"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"Page number"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"maximum":100},"description":"Results per page (max 100)"}],"responses":{"200":{"description":"Network details with token list","content":{"application/json":{"schema":{"type":"object","properties":{"networkAddress":{"type":"string"},"networkName":{"type":["string","null"]},"tokens":{"type":"array","items":{"type":"object"}},"totalTokens":{"type":"integer"},"page":{"type":"integer"},"totalPages":{"type":"integer"},"tokensBundledCount":{"type":"integer"},"tokensCreatedCount":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}},"/api/network-details/{networkAddress}/wallets":{"get":{"operationId":"getNetworkWallets","summary":"Network member wallets","description":"All wallets belonging to a funding network (by topFundingSource), with exchange labels, tags, and wallet age.","tags":["Networks"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"networkAddress","in":"path","required":true,"schema":{"type":"string","minLength":32,"maxLength":44},"description":"Root funding address of the wallet network (base58)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"Page number"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"maximum":100},"description":"Results per page (max 100)"}],"responses":{"200":{"description":"Paginated list of network wallets","content":{"application/json":{"schema":{"type":"object","properties":{"wallets":{"type":"array","items":{"type":"object"}},"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"},"totalPages":{"type":"integer"}}}}}},"402":{"description":"Payment Required"}}}}}}