Smartperps Wallet

{
  "account_value_usd": 151226719,
  "address": "0x0000000000000000000000000000000000000001",
  "book": {
    "long_notional_usd": 0,
    "net_usd": -700946583,
    "short_notional_usd": 700946583
  },
  "checked_at": "2026-10-23T01:08:30.196Z",
  "cohort_entry": {
    "display_name": null,
    "pnl_30d_usd": 114316598,
    "pnl_all_time_usd": 179019894,
    "rank_30d_pnl": 1,
    "roi_30d": 0.6858
  },
  "confidence": "high",
  "data_note": "Public on-chain Hyperliquid data only. Liquidation is shown as distance from mark in whole percent, not as a price. Do not use this data to target, front-run liquidations of, or harass account holders.",
  "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys.",
  "effective_leverage": 4.64,
  "in_smart_money_cohort": true,
  "last_30d": {
    "closing_fills": 64,
    "fees_usd": 73,
    "fills": 2000,
    "most_traded": [
      {
        "symbol": "xyz:META",
        "volume_usd": 453357
      },
      {
        "symbol": "HYPE",
        "volume_usd": 165242
      }
    ],
    "realized_pnl_usd": -7535,
    "truncated": true,
    "volume_usd": 763893,
    "window_days": 30,
    "winning_closes_pct": 76.6
  },
  "margin_usage_pct": 98.3,
  "margin_used_usd": 148682072,
  "open_positions": 19,
  "positions": [
    {
      "entry_price": 2322.73,
      "leverage": 5,
      "liquidation_distance_pct": 74,
      "margin": "cross",
      "notional_usd": 254365099,
      "side": "short",
      "size": 106464.1028,
      "symbol": "ETH",
      "unrealized_pnl_usd": -7077189
    },
    {
      "entry_price": 76327.4,
      "leverage": 5,
      "liquidation_distance_pct": 88,
      "margin": "cross",
      "notional_usd": 214683283,
      "side": "short",
      "size": 2637.9539,
      "symbol": "BTC",
      "unrealized_pnl_usd": -13335028
    }
  ],
  "sources_failed": [],
  "tier": "wallet",
  "total_notional_usd": 700946583
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://api.youraitools.co/smartperps/v1/wallet?address=0x0000000000000000000000000000000000000001'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://api.youraitools.co/smartperps/v1/wallet?address=0x0000000000000000000000000000000000000001' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.youraitools.co%2Fsmartperps%2Fv1%2Fwallet
const res = await pay("https://api.youraitools.co/smartperps/v1/wallet?address=0x0000000000000000000000000000000000000001");
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://api.youraitools.co/smartperps/v1/wallet?address=0x0000000000000000000000000000000000000001")
    print(res.status_code, res.text)