{"openapi":"3.1.0","info":{"title":"Address Intelligence API","version":"0.4.0","description":"Address labels across 52 networks with source-specific coverage. Detailed on-chain collection: TRON only. Full AML risk is not assessed."},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"paths":{"/v1/check":{"post":{"summary":"Проверить адрес в выбранной сети","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","maxLength":256},"network":{"type":"string","enum":["auto","ethereum","bsc","polygon","arbitrum","optimism","base","avalanche","ethereum-classic","fantom","gnosis","celo","core","cronos","hyperliquid","kcc","klaytn","linea","metis","sonic","worldchain","zksync","flare","hyperevm","hypercore","robinhood","tron","bitcoin","bitcoin-cash","bitcoin-gold","bitcoin-sv","litecoin","dogecoin","dash","verge","zcash","solana","xrp","ton","aptos","sui","starknet","algorand","cardano","cosmos","kava","eos","monero","multiversx","near","polkadot","tezos","zilliqa"],"description":"Omit/auto for detection; ambiguous formats require explicit network. Network aliases from /v1/networks are also accepted."},"details":{"type":"boolean","default":false,"description":"TRON only; returns 422 for other networks."}}}}}},"responses":{"200":{"description":"Результат проверки. Возможны дополнительные поля источников.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckResult"}}}},"202":{"description":"Результат проверки. Возможны дополнительные поля источников.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckResult"}}}},"400":{"description":"Ошибка","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Ошибка","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"409":{"description":"network_required; choose a network from networks candidates. No daily quota spent."},"422":{"description":"details_not_supported; details are available only on TRON."},"429":{"description":"Ошибка","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/v1/usage":{"get":{"summary":"Текущая пользовательская квота","responses":{"200":{"description":"Использование","content":{"application/json":{"schema":{"type":"object","properties":{"used":{"type":"integer"},"daily_quota":{"type":"integer"},"rate_limit":{"type":"integer"}}}}}},"401":{"description":"Ошибка","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Ошибка","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/v1/health":{"get":{"summary":"Состояние","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"ok"},"version":{"type":"string"}}}}}}}}},"/v1/address/{network}/{address}":{"get":{"summary":"Прочитать известный адрес без сбора","parameters":[{"name":"network","in":"path","required":true,"schema":{"type":"string","enum":["ethereum","bsc","polygon","arbitrum","optimism","base","avalanche","ethereum-classic","fantom","gnosis","celo","core","cronos","hyperliquid","kcc","klaytn","linea","metis","sonic","worldchain","zksync","flare","hyperevm","hypercore","robinhood","tron","bitcoin","bitcoin-cash","bitcoin-gold","bitcoin-sv","litecoin","dogecoin","dash","verge","zcash","solana","xrp","ton","aptos","sui","starknet","algorand","cardano","cosmos","kava","eos","monero","multiversx","near","polkadot","tezos","zilliqa"]}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Результат проверки. Возможны дополнительные поля источников.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckResult"}}}},"401":{"description":"Ошибка","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Ошибка","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Ошибка","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/v1/networks":{"get":{"security":[],"summary":"Сети, псевдонимы, покрытие и ограничения","responses":{"200":{"description":"networks array with dataset, chainlabel, arkham, details, validation and notes."}}}},"/v1/detect":{"post":{"summary":"Определить кандидаты сети без расхода суточной квоты","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","maxLength":256}}}}}},"responses":{"200":{"description":"networks[], valid, requires_selection. Does not assert account existence."},"400":{"description":"invalid_address"},"401":{"description":"unauthorized"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"},"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"CheckResult":{"type":"object","required":["address","network","status","labels","primary_label","risk"],"properties":{"address":{"type":"string"},"network":{"type":"string","enum":["ethereum","bsc","polygon","arbitrum","optimism","base","avalanche","ethereum-classic","fantom","gnosis","celo","core","cronos","hyperliquid","kcc","klaytn","linea","metis","sonic","worldchain","zksync","flare","hyperevm","hypercore","robinhood","tron","bitcoin","bitcoin-cash","bitcoin-gold","bitcoin-sv","litecoin","dogecoin","dash","verge","zcash","solana","xrp","ton","aptos","sui","starknet","algorand","cardano","cosmos","kava","eos","monero","multiversx","near","polkadot","tezos","zilliqa"]},"status":{"enum":["partial","pending","complete","failed"]},"label_status":{"enum":["found","not_found","unknown"]},"primary_label":{"type":["object","null"],"additionalProperties":true},"labels":{"type":"array","items":{"type":"object","additionalProperties":true}},"risk":{"type":"object","properties":{"score":{"type":["integer","null"]},"level":{"type":"string"}}},"sources":{"type":"object","additionalProperties":true},"pipeline":{"type":"array","items":{"type":"object"}}}}}}}