--- name: api.thetrustlayer.xyz description: api.thetrustlayer.xyz provides on-chain trust and risk scoring for agents, wallets, and owners indexed from ERC-8004 registry data and Trust Layer analytics. It supports lookups across Ethereum and Solana chains, returning trust scores, sybil risk flags, reviewer reputation, and historical score trajectories. All endpoints are single-shot snapshot queries against indexed data, not real-time streaming feeds. host: api.thetrustlayer.xyz --- # api.thetrustlayer.xyz Trust Layer is an on-chain reputation infrastructure host serving agents that need to evaluate counterparties before transacting, delegating, or granting permissions. It covers three subject types — on-chain agents, wallet owners, and reviewers — across Ethereum (ERC-8004) and Solana. Its distinguishing feature is ERC-8004-native indexing, which ties agent trust scores to structured reviewer feedback, ownership registries, and historical score trajectories in one place. ## When to use this host Use api.thetrustlayer.xyz when an agent needs to screen on-chain agents, ERC-8004 owners, or reviewers for trust, sybil risk, or reputation before transacting or delegating. It is the right choice for ERC-8004-native lookups on Ethereum and for Solana wallet risk profiling. Do not use it for: token price or market data (use a DEX or price feed API), general ENS or wallet portfolio lookups (use an ENS resolver or portfolio API), real-time or streaming risk monitoring (all endpoints are single-shot snapshots against indexed data), or bulk/portfolio-wide agent screening in a single call (each endpoint covers one subject at a time). For non-Solana, non-Ethereum chains, this host has no documented coverage and should not be used. ## Capabilities ### On-Chain Agent Trust Scoring Retrieves current trust scores, sybil risk, anomaly flags, confidence levels, and recommended max exposure for individual on-chain agents identified by chain-qualified ID or Ethereum agent ID. - **`lookup-agent-trust-metadata`** — Looks up a chain-qualified agent ID on Trust Layer and returns trust score, sybil risk, anomaly flags, and recommended max exposure, or a structured not-found result if the agent is unindexed. - **`fetch-ethereum-agent-trust-score`** — Returns a trust and risk profile for a specific Ethereum agent, including trust score, confidence level, sybil risk, recommended max exposure, cross-chain linkage, component scores, evidence summary, and signed attestation metadata. - **`fetch-trust-layer-agent-profile`** — Returns verification and reputation metadata for a named Trust Layer agent, including trust score, liveness, economic activity, market interest score, and recent attestations. - **`fetch-gekko-rebalancer-profile`** — Returns trust score, feedback metrics, and metadata for the Gekko Rebalancer DeFi portfolio rebalancing agent on Base. ### Agent Trust History Returns daily trust score snapshots, 7d/30d trajectory windows, and volatility metrics for a specific on-chain agent, enabling trend-based reliability assessment. - **`fetch-agent-trust-history`** — Returns daily trust score snapshots, score trajectory over 7d/30d windows, and volatility for a given on-chain agent ID. ### Owner Registry Lookup Resolves a wallet address against the ERC-8004 owner registry to retrieve associated agents, chain coverage, aggregate trust scores, and risk assessments. - **`fetch-owner-lookup`** — Returns ERC-8004 ownership details for a wallet address, including associated agents, chains, trust score, and risk assessment. - **`fetch-owner-trust-profile`** — Looks up an Ethereum owner address in indexed ERC-8004 registry data and returns associated agents, chains, trust score, and risk assessment. - **`fetch-owner-agents`** — Returns all agents associated with a given owner address, including per-agent trust scores, score breakdowns (profile, feedback, legitimacy), chain coverage, and total agent count. ### Reviewer Reputation Looks up the on-chain reviewer reputation of an Ethereum wallet address, returning reviewer score, quality tier, total reviews, and unique agents reviewed via ERC-8004 feedback. - **`fetch-reviewer-details`** — Returns reviewer details for a given wallet address, including reviewer score, total reviews, quality tier, and recent review history indexed from ERC-8004 agent feedback. - **`fetch-erc8004-reviewer-profile`** — Returns reviewer history and reputation data for an Ethereum address, including review counts, reviewer score, quality tier, and recent ERC-8004 reviews. ### Solana Wallet Risk Screening Screens a Solana wallet address for trust score, risk level, behavioral activity components, risk flags, and detected program usage before transacting or evaluating a counterparty. - **`fetch-solana-trust-score`** — Returns a trust score, risk level, and wallet metadata for a given Solana address using Trust Layer on-chain analytics. - **`fetch-solana-wallet-risk-profile`** — Returns a trust score, risk level, activity components, risk flags, and detected program usage for a given Solana wallet address. ## Workflows ### Full Agent Due Diligence *Use when an agent needs to thoroughly evaluate a counterpart on-chain agent before delegating funds or granting permissions, combining current trust profile with historical trajectory.* 1. **`lookup-agent-trust-metadata`** — Retrieve current trust score, sybil risk, anomaly flags, and recommended max exposure for the target agent using its chain-qualified ID. 2. **`fetch-agent-trust-history`** — Pull daily trust score snapshots and 7d/30d trajectory to assess whether the agent's reputation is stable, improving, or degrading over time. ### Ethereum Agent Deep Profile *Use when an agent needs cross-chain reputation context, component score breakdown, and signed attestation metadata for a specific Ethereum agent before interacting.* 1. **`fetch-ethereum-agent-trust-score`** — Retrieve the full Ethereum agent trust profile including confidence, sybil risk, cross-chain linkage, component scores, and attestation metadata. 2. **`fetch-agent-trust-history`** — Supplement the current profile with historical score trajectory and volatility to assess long-term reliability. ### Owner Portfolio Trust Assessment *Use when an agent needs to evaluate all agents controlled by a specific wallet owner, including per-agent trust scores and legitimacy ratings.* 1. **`fetch-owner-trust-profile`** — Verify the wallet is a registered ERC-8004 owner and retrieve its aggregate trust score and chain coverage. 2. **`fetch-owner-agents`** — Enumerate all agents owned by that address with per-agent trust scores, profile/feedback/legitimacy breakdowns, and chain distribution. ### Reviewer-Weighted Trust Verification *Use when an agent needs to validate that a reviewer providing ERC-8004 feedback on an agent is credible before weighting that feedback in a trust decision.* 1. **`fetch-erc8004-reviewer-profile`** — Look up the reviewer's Ethereum address to confirm their quality tier, reviewer score, and review history. 2. **`lookup-agent-trust-metadata`** — Cross-reference the agent being reviewed to see whether its trust score already reflects reviewer-weighted feedback signals. ## Skill reference ### `fetch-reviewer-details` **Reviewer Lookup** — Returns reviewer details for a given wallet address, including reviewer score, total reviews, quality tier, and recent review history indexed from ERC-8004 agent feedback. *Use when:* Use when an agent needs to look up the on-chain reviewer reputation of a wallet address, such as verifying whether an address has left ERC-8004 feedback on agents and what quality tier they belong to. *Not for:* Do not use for looking up agent ratings or agent details; this endpoint is specific to the reviewer (the wallet leaving feedback), not the agent being reviewed. **Inputs:** - `address` (string, required) — Ethereum wallet address of the reviewer to look up, passed as a URL path parameter. **Returns:** Returns a JSON object with found=false, reviewerScore=null, totalReviews=0, uniqueAgentsReviewed=0, qualityTier='unknown', an empty recentReviews array, and an explanatory note when no ERC-8004 reviewer history exists for the address. **Example:** `GET https://api.thetrustlayer.xyz/reviewer/0x402Feee072D655B85e08f1751AF9ddbCd249521f` --- ### `fetch-owner-lookup` **Owner Lookup** — Returns ERC-8004 ownership details for a wallet address, including associated agents, chains, trust score, and risk assessment. *Use when:* Use when an agent needs to determine whether a wallet address is registered as an owner in an ERC-8004 registry, or to retrieve the list of agents, chains, and trust metrics associated with that address. *Not for:* Do not use for token balance lookups or general wallet portfolio data; this is specific to ERC-8004 agent ownership registry data. **Inputs:** - `address` (string, required) — The wallet address to look up ownership details for. Passed as a path parameter. **Returns:** Returns ownerAddress, found=false, totalAgents=0, empty chains and agents arrays, null avgTrustScore, riskAssessment='unknown', and a note explaining no ERC-8004 registry entries were found. **Example:** `GET https://api.thetrustlayer.xyz/owner/0x402Feee072D655B85e08f1751AF9ddbCd249521f` --- ### `fetch-solana-trust-score` **Solana Trust Check** — Returns a trust score, risk level, and wallet metadata for a given Solana address using Trust Layer on-chain analytics. *Use when:* Use when an agent needs to assess the trustworthiness or risk profile of a Solana wallet address before interacting with it, sending funds, or evaluating a counterparty. *Not for:* Do not use for EVM or non-Solana chain addresses; use a corresponding EVM trust/risk API instead. Not suitable for real-time streaming risk monitoring — this is a single-shot lookup. **Inputs:** - `solana_address` (string, required) — The Solana wallet address (base58-encoded public key) to check against Trust Layer data. **Returns:** Returns a JSON object with trust_score (integer), risk_level (string), wallet metadata, component breakdown (age, tx count, balances), risk_flags array, interacted programs map, and indexing timestamp. **Example:** `GET https://api.thetrustlayer.xyz/solana/X4o2D8op42a2jcNJJVZcDq3eYivh1oR9XiezPWCXosZ` --- ### `fetch-erc8004-reviewer-profile` **ERC-8004 Reviewer Lookup** — Returns reviewer history and reputation data for an Ethereum address, including review counts, reviewer score, quality tier, and recent ERC-8004 reviews. *Use when:* Use when an agent needs to determine whether a given Ethereum address has a history of reviewing on-chain agents via ERC-8004, or to assess the address's reviewer reputation score and quality tier. *Not for:* Do not use to look up agent profiles or agent reputation; this endpoint is specific to reviewer history, not the agents being reviewed. **Inputs:** - `address` (string, required) — Ethereum address to look up reviewer history for. Provided as a path parameter in the URL. **Returns:** Returns an object with found=false, reviewerScore=null, totalReviews=0, uniqueAgentsReviewed=0, qualityTier='unknown', an empty recentReviews array, and an explanatory note when no reviewer history exists. **Example:** `GET https://api.thetrustlayer.xyz/reviewer/0x742d35Cc6634C0532925a3b844Bc9e7595a8bC32` --- ### `fetch-solana-wallet-risk-profile` **TrustLayer Solana Wallet Risk Profile** — Returns a trust score, risk level, activity components, risk flags, and detected program usage for a given Solana wallet address. *Use when:* Use when an agent needs to screen a Solana wallet for risk or behavioral signals, such as before executing a transaction, evaluating a counterparty, or flagging suspicious on-chain activity. *Not for:* Do not use for EVM or non-Solana wallet screening; use an EVM-compatible risk API instead. Not suitable for real-time streaming risk monitoring — this is a single-shot profile lookup. **Inputs:** - `wallet_address` (string, required) — The Solana wallet address (base58-encoded public key) to retrieve the risk profile for. Provided as the last path segment of the URL. **Returns:** Returns a wallet risk profile with trust_score=81, risk_level=low, activity components (tx_count, sol_balance, token_count, nft_count), risk_flags like burst_activity, and a programs map of on-chain interactions. **Example:** `GET https://api.thetrustlayer.xyz/solana/So11111111111111111111111111111111111111112` --- ### `fetch-owner-trust-profile` **TrustLayer Owner Lookup** — Looks up an Ethereum owner address in indexed ERC-8004 registry data and returns associated agents, chains, trust score, and risk assessment. *Use when:* Use when an agent needs to verify whether an Ethereum address is a registered ERC-8004 owner, retrieve its associated agents and chains, or assess its trust score and risk level before interacting with it. *Not for:* Do not use for non-ERC-8004 identity lookups or general ENS/wallet resolution; use a dedicated ENS or wallet API instead. Not suitable for real-time on-chain queries — results reflect indexed registry data only. **Inputs:** - `ownerAddress` (string, required) — Ethereum address of the owner to look up in the ERC-8004 registry index. Passed as a path parameter in the URL. **Returns:** Returns ownerAddress, found=false, totalAgents=0, empty chains and agents arrays, avgTrustScore=null, riskAssessment='unknown', and an explanatory note when the address has no registered ERC-8004 agents. **Example:** `GET https://api.thetrustlayer.xyz/owner/0x742d35Cc6634C0532925a3b844Bc9e7595a8bC32` --- ### `lookup-agent-trust-metadata` **Trust Layer Agent Lookup** — Looks up a chain-qualified agent ID on Trust Layer and returns trust score, sybil risk, anomaly flags, and recommended max exposure, or a structured not-found result if the agent is unindexed. *Use when:* Use when an agent needs to assess the trustworthiness or reputation of another on-chain agent before interacting with it, delegating funds, or granting permissions — especially when the counterpart agent's identity is expressed as a chain-qualified ID (e.g. base:0x...). *Not for:* Do not use for token price lookups, wallet balance checks, or general blockchain data queries. Not suitable for human identity verification — this covers on-chain agent registrations only. **Inputs:** - `agentId` (string, required) — Chain-qualified agent identifier in the format chain:address (e.g. base:99999999). Embedded in the URL path after /trust/. **Returns:** Returns a JSON object with found=false, trust_score=null, confidence='none', sybil_risk='unknown', risk_level='unknown', recommended_max_exposure_usd=0, empty anomaly_flags, and a note advising to treat the agent as unverified. **Example:** `GET https://api.thetrustlayer.xyz/trust/base:99999999` --- ### `fetch-owner-agents` **Trust Layer Owner Agents** — Returns all agents associated with a given owner address, including per-agent trust scores, score breakdowns (profile, feedback, legitimacy), chain coverage, and total agent count. *Use when:* Use when an agent needs to look up the full list of on-chain agents owned by a specific wallet address and evaluate their trust scores, legitimacy ratings, and chain distribution. *Not for:* Do not use to look up a single agent by its own ID; use a per-agent endpoint instead. Not suitable for real-time trust monitoring or streaming updates — this is a single-shot snapshot. **Inputs:** - `ownerAddress` (string, required) — EVM wallet address of the owner whose agents should be retrieved. Provided as a path parameter in the URL. **Returns:** Returns ownerAddress, groupId, totalAgents count, chains array, and an agents array where each entry has agentId, trustScore, chain, scoreProfile, scoreFeedback, and scoreLegitimacy. **Example:** `GET https://api.thetrustlayer.xyz/owner/0xc15366b9c611d23dd1433c5f6782b2ab64457d03` --- ### `fetch-agent-trust-history` **TrustLayer Agent History** — Returns daily trust score snapshots, score trajectory over 7d/30d windows, and volatility for a given on-chain agent ID. *Use when:* Use when an agent needs to evaluate the historical trust score trajectory and volatility of a specific on-chain agent identified by chain and numeric ID, such as before delegating tasks or assessing reliability over time. *Not for:* Do not use for current/live trust scores — this endpoint returns historical snapshots only. Not suitable for agents on chains other than Base based on the observed response structure. **Inputs:** - `agentId` (string, required) — Agent identifier encoded as a path segment in the format chain:numericId (e.g. base:1378). Supplied as the trailing path parameter in the URL. **Returns:** Returns agentId, chain, dataPoints count, a snapshots array of date/score pairs, a trajectory object with 7d and 30d deltas, and a volatility float. **Example:** `GET https://api.thetrustlayer.xyz/history/base:1378` --- ### `fetch-ethereum-agent-trust-score` **TrustLayer Ethereum Agent Trust Score** — Returns a trust and risk profile for a specific Ethereum agent, including trust score, confidence level, sybil risk, recommended max exposure, cross-chain linkage, component scores, evidence summary, and signed attestation metadata. *Use when:* Use when an agent needs to evaluate the trustworthiness or risk level of a specific Ethereum agent before interacting, delegating funds, or accepting feedback from that agent — particularly when cross-chain reputation context and anomaly flags are needed. *Not for:* Do not use for bulk or portfolio-wide agent screening; this endpoint returns a profile for a single agent ID. Not suitable for real-time price or market data lookups. **Inputs:** - `agent_id` (string, required) — The Ethereum agent identifier encoded in the URL path as 'ethereum:{id}'. Specifies which agent's trust profile to retrieve. **Returns:** Returns a JSON object with trust_score=32, confidence='high', sybil_risk='low', risk_level='high', recommended_max_exposure_usd=8, cross-chain linkage to Base, component scores, evidence summary, and a signed ES256 attestation. **Example:** `GET https://api.thetrustlayer.xyz/trust/ethereum:13446` --- ### `fetch-gekko-rebalancer-profile` **Gekko Rebalancer Agent Profile** — Returns trust score, feedback metrics, and metadata for the Gekko Rebalancer DeFi portfolio rebalancing agent on Base. *Use when:* Use when an agent needs to evaluate the Gekko Rebalancer agent's trustworthiness, reputation score, or activity metrics before delegating portfolio rebalancing tasks on Base DeFi. *Not for:* Do not use to execute rebalancing transactions or fetch live portfolio allocations; this endpoint returns agent metadata and scoring only. **Returns:** Returns a JSON object with the agent's trustScore (38), sub-scores for profile/feedback/legitimacy, feedbackCount, uniqueCallers, and sync/scoring timestamps. **Example:** `GET https://api.thetrustlayer.xyz/agent/base:1378` --- ### `fetch-trust-layer-agent-profile` **Trust Layer Verified Agent Profile** — Returns verification and reputation metadata for a named Trust Layer agent, including trust score, liveness, economic activity, market interest score, and recent attestations. *Use when:* Use when an agent needs to evaluate the trustworthiness or reputation of another on-chain agent by its Trust Layer ID (e.g. base:1378), before delegating work, making a payment, or deciding whether to interact with it. *Not for:* Do not use for real-time liveness monitoring or streaming uptime checks; this is a single-shot profile snapshot. Not suitable for agents not registered on Trust Layer. **Inputs:** - `agent_id` (string, required) — Trust Layer agent identifier in the format chain:id, embedded in the URL path (e.g. base:1378). **Returns:** Returns a JSON object with trust_score, verified_score, risk_assessment, liveness metrics, economic activity stats, market_interest counts, and an array of up to 10 recent attestations for the queried agent. **Example:** `GET https://api.thetrustlayer.xyz/verified/base:1378` ---