/

Research

Bounded jobs over full trade history: trader rankings, wallet performance, token cohorts and activity evidence. Estimate first, set a maximum charge, then pay for what the job reads.

Works onSui

Basics

Each successful call is charged in credits. 1 USDC adds 1,000 credits.

Base URLhttps://yolo.casa/api/v1
HeaderAuthorization: Bearer $YOLO_API_KEY

Pricing

Each completed scan costs 0.5 credits plus 0.1 credits per MiB read, rounded up. You set a maximum charge, up to 1,000 credits; it is reserved while the job runs and the rest is released. Status checks are free. Cancelling is best effort, and work already done may still be charged.

Workflow

Estimate, run, read the evidence, then quote and build a swap. Uses the JavaScript SDK.

const input = {
  operation: 'token_cohorts' as const, type: 'TOKEN_COIN_TYPE',
  from: '2026-09-01', to: '2026-10-01',
  limit: 20, maxChargeUnits: 10_000,
};
const estimate = await yolo.estimateResearch(input);
// Inspect estimate.coverage before accepting this spending cap.
let job = await yolo.startResearch(input, 'cohorts-september-001');
while (job.state === 'queued' || job.state === 'running') {
  await new Promise(resolve => setTimeout(resolve, 1_000));
  job = await yolo.researchJob(job.id);
}
if (job.state !== 'succeeded') throw new Error(job.error || job.state);
console.log(job.result, job.receipt); // examine evidence and coverage

const quote = await yolo.post<{ id: string }>('swap/quote', {
  coinIn: 'INPUT_COIN_TYPE', coinOut: 'OUTPUT_COIN_TYPE', amountIn: '1000000',
  owner: 'YOUR_SUI_WALLET',
});
// Review the evidence and fresh quote before building.
const unsigned = await yolo.post('swap/build', {
  id: quote.id, owner: 'YOUR_SUI_WALLET', slippageBps: 100,
});
// Inspect simulation, address, expiry, balance changes and gas.
// The caller's wallet decides whether to sign unsigned.kind.

Endpoints

Open an endpoint for its parameters, examples in three languages and a runner.