Cred Protocol

Get Credit Score

Get the Cred Protocol credit score (300-1000) for an Ethereum address or ENS name. Score ranges: - 920-1000: Excellent - 840-919: Very Good - 750-839: Good - 640-749: Fair - 300-639: Low Use this to assess wallet creditworthiness for lending, DeFi participation, or trust evaluation.

Get Credit Scores Batch

Get individual credit scores for multiple Ethereum addresses at once. More efficient than calling get_credit_score multiple times. Returns individual scores for each address without aggregation. Use this for multi-sig wallets, portfolio analysis, or batch credit assessments.

Get Aggregate Score

Get a single aggregated credit score across multiple Ethereum addresses. Computes one combined score representing the overall creditworthiness of a group of addresses (e.g., a multi-sig wallet's signers).

Get Financial Summary

Get a comprehensive financial summary for an Ethereum address. Includes: - Asset values (total assets, collateral, debt, stablecoins) - Activity metrics (transactions, transfers, NFTs) - DeFi positions (loans, collateral deposits) - Credit events (liquidations, defaults, repayments) - Identity attestations Use this for detailed financial health assessment and due diligence.

Get Comprehensive Report

Get a comprehensive multi-chain credit report for an Ethereum address. This is the most detailed report, including per-chain breakdowns with balances, transactions, NFTs, DeFi positions, and credit events across all supported chains.

Get Summary Report

Get a summary credit report aggregated across all chains. Lighter than the comprehensive report — returns aggregated metrics without per-chain breakdowns. Includes net worth, transaction counts, DeFi positions, and identity attestations.

Get Chain Report

Get a detailed credit report for a single blockchain. Returns balances, transactions, NFTs, DeFi positions, and credit events for the specified chain only. Supported chains: 1 (Ethereum), 10 (Optimism), 56 (BSC), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 42220 (Celo), 43114 (Avalanche), 534352 (Scroll), 59144 (Linea). **Requires:** CRED_API_KEY environment variable.

Get Chain Summary

Get a summary report for a single blockchain. Lighter than the full chain report — returns aggregated metrics for the specified chain without detailed balance/transaction lists. Supported chains: 1 (Ethereum), 10 (Optimism), 56 (BSC), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 42220 (Celo), 43114 (Avalanche), 534352 (Scroll), 59144 (Linea). **Requires:** CRED_API_KEY environment variable.

Get Portfolio Value

Get the total USD value of all assets for an Ethereum address. Aggregates value across all supported blockchains: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Celo, Avalanche, Scroll, Linea. Use this for quick net worth calculations or portfolio assessments.

Get Chain Portfolio Value

Get the USD value of assets on a specific blockchain. Supported chains: - 1: Ethereum - 10: Optimism - 56: Binance Smart Chain - 137: Polygon - 8453: Base - 42161: Arbitrum - 42220: Celo - 43114: Avalanche - 534352: Scroll - 59144: Linea Use this for chain-specific portfolio analysis.

Get Portfolio Composition

Get portfolio composition broken down by asset type across all chains. Returns value breakdown showing how assets are distributed across token types, DeFi positions, stablecoins, collateral, and debt. **Requires:** CRED_API_KEY environment variable.

Get Identity Attestations

Get verified identity attestations for an Ethereum address. Attestations include: - ENS Name: Ethereum Name Service domain ownership - Basename: Base network name service - Gitcoin Passport: Humanity verification - POAPs: Proof of Attendance tokens - Worldcoin, BrightID, and other identity credentials Use this to verify wallet identity and reputation.

Get Sybil Score

Get a sybil detection score for an Ethereum address. Evaluates whether the address is likely a unique human or a sybil (duplicate/bot) account based on on-chain behavior patterns, identity attestations, and transaction graph analysis. **Requires:** CRED_API_KEY environment variable.

Screen Sanctions

Screen a crypto address against the OFAC sanctions lists. Checks the OFAC SDN and Consolidated (non-SDN) lists. Returns whether the address is sanctioned and, for each match, the sanctioned party's name, type, sanctions programs, and a deep link to the OFAC entry. Accepts any digital-currency address published by OFAC (Ethereum/EVM, Bitcoin, Monero, Tron, ...) or an ENS name. **Requires:** CRED_API_KEY environment variable.

Get Transaction Graph

Get a transaction graph for an Ethereum address showing token transfer relationships. Returns a tripartite graph structure (wallet → token → wallet) built from historical ERC-20 token transfers. Useful for visualizing transaction flow, identifying counterparties, and analyzing wallet activity patterns. Supported chains: 1 (Ethereum), 10 (Optimism), 56 (BSC), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 43114 (Avalanche), 534352 (Scroll), 59144 (Linea). **Requires:** CRED_API_KEY environment

Get Agent Count

Get the total number of AI agents registered in the ERC-8004 Identity Registry on Base. **Requires:** CRED_API_KEY environment variable.

List Agents

Get a paginated list of AI agents from the ERC-8004 Identity Registry on Base. Returns agent IDs, owner addresses, and metadata (name, description, image). **Requires:** CRED_API_KEY environment variable.

Get Agent

Get info for a specific AI agent by its ERC-8004 ID. Returns the agent's owner address and metadata (name, description, image) from the Identity Registry on Base. **Requires:** CRED_API_KEY environment variable.

Search Agents

Search for AI agents registered in the ERC-8004 Identity Registry on Base. Searches across all registered agents by name or description. Returns agent IDs, owner addresses, and metadata (name, description, image). **Requires:** CRED_API_KEY environment variable to be set. Use this to discover AI agents, find agents by capability, or look up specific agent registrations.

Submit Agent Reputation

Submit ERC-8004 reputation feedback for an AI agent. Computes Cred Protocol credit score, sybil risk, and identity attestations for the given address, then submits results as on-chain feedback to the ERC-8004 Reputation Registry on Base. The submission is asynchronous. Use get_reputation_status to poll for completion after submitting. Feedback tags (default: all three): - creditScore: Andromeda 1.0 credit score (300-1000) - sybilRisk: Sybil detection risk score (0=human, 100=bot) - identityCo

Get Agent Reputation

Read the on-chain reputation summary for an AI agent. Returns aggregated feedback counts and averages from the ERC-8004 Reputation Registry on Base for each tag (creditScore, sybilRisk, identityCount). **Requires:** CRED_API_KEY environment variable. Costs 1 Cred Unit.

Get Reputation Status

Check the status of an on-chain reputation submission. After submitting reputation feedback with submit_agent_reputation, use this to track whether the on-chain transaction has been confirmed. Status values: pending, computing, submitting, confirmed, failed. **Requires:** CRED_API_KEY environment variable.