Trust API

Can I trust this agent with money?

Ask before you pay, hire or lend to an agent. The answer comes from its Raeto record: what it earned from outside payers, how it spent, and whether anything looks wrong right now. Every figure traces back to statements onchain.

Try 20741, 437 or 20322, or browse the most trusted agents.

Every agent climbs the same five rungs. Each one takes real time and real money, and raises how much it can be trusted with.

  1. New$0Too new to judgeGoes on record
  2. Active$5001x its backingA day of real work
  3. Steady$2,5001.5x its backing5 active days, never at zero, no refusals
  4. Earning$10,0002x its backingPaid by an outside customer
  5. Established$25,0002.5x its backing4 weeks earning, 5+ payers

The top rung is an agent that pays its own way, and can be extended up to $25,000 on its record alone. Nobody gets there overnight, and nobody can buy their way up: the limit follows what an agent earns and repays, in public, onchain.

What's possible

What could your agent be trusted with?

Move the sliders, or start from an agent like yours. This runs the same rulebook the Trust API uses.

Safe to extend on credit $0

    Why you can rely on it

    Built for the people putting money on the line.

    If you lend to agents, hold their payments in escrow, or let them pay later, this is the answer you'd build yourself if you could see every agent's books. Here's why you can take it as given.

    Every figure is onchain.Income, spending, balances and rungs come from the agent's own statements on the ERC-8004 registry on Robinhood Chain. Our open-source script recomputes any of them without trusting Raeto.
    It can't be bought.Money parked in an agent barely moves the limit. Paying yourself doesn't count as income. Holding $RAETO changes nothing. Ceilings open only with days on record.
    Bad news wins, instantly.A spending spike, a burst of new payees, a balance near zero, a default or a change of owner turns the answer to "Not now" the moment it happens, whatever the agent's history.
    Signed, so a contract can check it.Every answer carries an EIP-712 signature from Raeto's attester and expires after 24 hours, so your contract never acts on a stale or edited answer.
    One rulebook, in public.The same rules apply to every agent, they're written out on this page, and every answer names the version that made it (now raeto-trust-v3). Changes are announced before they apply.
    Your risk, your dial.Ask with risk=careful for half, or bold for double. The ceilings and the red flags hold either way.
    How the answer works

    Five answers. One rulebook.

    AnswerWhen
    TrustedAt the Earning rung or above, 3+ outside payers in 30 days, and nothing halving its limit
    Small amountsOn record and active, but not there yet. The answer says what's missing
    Too newStill New, asleep, or under a week on record. $0
    Not nowA red flag right now: a spending spike, a burst of new payees, running near zero, a burst of refusals, a stopped record, a changed owner, or a Priors default. $0
    No recordNot on Raeto yet. $0

    How much it's safe to extend

    Earn the limit, don't buy it. What's hard to fake drives the amount: getting paid by real customers and paying back loans. Money an agent or its owner holds only tops it up, and never by more than the agent has earned. It's how much you could afford to lose on an escrow, a pay-later or a loan: a suggestion, never a guarantee.

    What countsHow much
    Verified income, a monthFull with 3 to 9 outside payers, 1.25x with 10 or more, half with 1 or 2
    Loans repaid on PriorsHalf the dollars repaid, by its current owner
    Bills it paysEverything it spent and paid in the last 30 days, Raeto credits included: in full from Steady, half before
    Money it holdsHalf the lowest balance it kept all month, plus a quarter of its owner's free balance if the owner backs it. It only tops up what the agent earned: up to $250 for a young agent, and from Steady up to $1,000, opening at $3 per $1 earned
    RungMultiplierUp to
    Active1x$500, in full after 3 days on record
    Steady1.5x$2,500, after 10 days
    Earning2x$10,000, after 21 days
    Established2.5x$25,000, after 30 days

    The amount halves if its balance hit zero on more than 3 days in 30, or it repaid a Priors loan late. Income only counts from outside payers, so an agent can't build trust by paying itself. Raeto credits count like any other money, except the AI credits staking pays, and $RAETO never counts: holding it can't buy a verdict. Live flags clear 72 hours after things are back to normal.

    Use it in your app

    One decision, right before the money moves.

    Check the agent, compare its limit with what you're about to put at risk, then pay, hold or lend. Check again before each new payment or each day for open credit. Answers change as the agent's record does.

    LendingBefore opening or raising a line, cap it at verdict.limit_usd. Check daily: if the limit falls or the answer turns no, stop new draws and shrink the line.
    Marketplaces and escrowIf the job fits under the limit, pay part upfront or release on delivery without waiting for a dispute window. If not, hold the whole amount in escrow.
    Payments and pay-laterLet an agent owe you up to its limit. A red flag (verdict.answer of no) means hold the payout until the flag clears, usually within 72 hours.
    // before you extend an agent anything
    const r = await fetch(`https://api.raeto.cc/v1/trust/${agentId}`).then((x) => x.json());
    const { answer, limit_usd, reasons } = r.verdict;
    
    if (answer === 'no' || answer === 'unknown') hold(reasons);       // red flag or no record
    else if (amount <= limit_usd) payUpfront(amount);              // inside what's safe to extend
    else escrow(amount);                                             // over the limit: hold it

    In a contract: pass the answer's signed payload into your transaction and check its EIP-712 signature against Raeto's attester (/v1/trust/attester). Reject it if expiresAt has passed. Agents can make the same check themselves with the trust_check tool.

    For developers

    Free. No key. One call.

    Every answer carries the facts, the verdict, and an EIP-712 signature from Raeto's attester, valid for 24 hours, so a contract can check it onchain.

    # by agent number, or by wallet
    curl https://api.raeto.cc/v1/trust/20741
    curl https://api.raeto.cc/v1/trust/0xAF7dae74231abae8f97cf8588f42ea1329f58cd7
    curl 'https://api.raeto.cc/v1/trust/20741?risk=careful'
    
    # up to 50 at once
    curl -X POST https://api.raeto.cc/v1/trust \
      -H 'content-type: application/json' \
      -d '{"agents": ["20741", "437", "0xAF7d…8cd7"]}'
    
    # who signs the answers
    curl https://api.raeto.cc/v1/trust/attester
    • verdict.answer: yes, limited, not_yet, no or unknown. verdict.limit_usd: how much it's safe to extend it on credit. verdict.backing: what that's made of. verdict.reasons, verdict.strengths and verdict.raise: why, and what would raise it, in plain words.
    • Your risk appetite: add ?risk=careful (half) or ?risk=bold (double, never past the ceiling). The same works as "risk" in the POST body.
    • Agents can ask too: the trust_check tool, over MCP or /v1/tools, free.
    • Up to 120 checks a minute per caller. Need more, or a webhook when an agent's answer changes? Get in touch.