forward-fastEndpoint

GET https://pro.circular.fi/finderarrow-up-right

Find trending tokens

Parameters

{
  // =========================
  // TOKENS — what to return
  // Window used to RANK tokens and build Token → AMM → Pool rollups
  // =========================

  // REQUIRED. List of arbitrage base token mints (Base58). Example: 1..N addresses.
  "tokensMint": [
    "So11111111111111111111111111111111111111112",
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
  ], 

  // Optional. Exclude these mints. Example: USDT mint.
  "tokensExclude": [
    "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB"
  ], 

  "tokensMax": 1, // Max tokens to return (ranked by gross revenues). Min: 1, Max: 50. Example: 1.

  "tokensTimeRange": 3000, // Aggregation window (seconds) for ranking. Min: 0, Max: 86400. Examples: 300 (fresh), 3600, 14400.

  "tokensMinMarketCap": 50000,          // Optional. USD. Min: 0. Example: 50_000.
  "tokensMaxMarketCap": 1000000000000, // Optional. USD. Max practical example: 1_000_000_000_000 (set higher to disable).

  "tokensMinVolume": 100000,         // Optional. USD within tokensTimeRange. Example: 100_000.
  "tokensMaxVolume": 1000000000,    // Optional. USD. Example: 1_000_000_000 (set higher to disable).

  "tokensMinVolumeArbitrage": 100000,        // Optional. USD within tokensTimeRange for arbitrage. Example: 100_000.
  "tokensMaxVolumeArbitrage": 1000000000,    // Optional. USD for arbitrage. Example: 1_000_000_000

  "tokensMinVolumeTrade": 100000,           // Optional. USD within tokensTimeRange for trade. Example: 100_000.
  "tokensMaxVolumeTrade": 1000000000,        // Optional. USD for trade. Example: 1_000_000_000

  "tokensMinRevenues": 500,           // Optional. USD (gross arbitrage gains). Example: 500.
  "tokensMaxRevenues": 1000000000,  // Optional. USD. Example: 1_000_000_000.

  "tokensMinProfits": 250,            // Optional. USD (net gains). Example: 250.
  "tokensMaxProfits": 1000000000,   // Optional. USD. Example: 1_000_000_000.

  "tokensMinLiquidity": 10000,            // Optional. USD (token liquidity). Example: 10_000.
  "tokensMaxLiquidity": 10000000,   // Optional. USD. Example: 10_000_000.
  
  "tokensMinTransactions": 5,       // Optional. Min tx count in window. Min: 1. Example: 5.
  "tokensMaxTransactions": 100000000, // Optional. Max tx count. Example: 100_000_000.

  "tokensMinPool": 2, // Optional. Min pools returned per AMMs. Example: 2

  "tokensAMMS": [
    "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo,2",
    "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG,1"
  ], // Optional. Format: "amm_address,<max_pools>". Cap per-AMM pools (Max per AMM: 10). Example: 2 and 1.


  // =========================
  // THRESHOLD — should I trade/arb now?
  // Independent decision window vs. tokensTimeRange
  // =========================

  "thresholdMaxTimeRange": 900,   // Optional. Seconds used for threshold decision. Min: 0, Max: 86400. Examples: 120, 900, 3600.
  "thresholdProfits": 200,          // Optional. USD net gains threshold. Example: 100.
  "thresholdRevenues": 200,         // Optional. USD gross gains threshold. Example: 500.
  "thresholdTransactions": 20,     // Optional. Tx count threshold. Example: 20.
  "thresholdProvider": "ALL",     // Optional. One of: FAST, TEMPORAL, JITO, NEXTBLOCK, BLOX, ASTRALANE, FLASHBLOCK, NODEONE, RAZOR, SENDER, STELLIUM, FALCON, ALL. Example: "JITO".
  "thresholdBot": "ALL",          // Optional. One of: SMB, NOTARB, ALL. Example: "ALL" or "SMB".

  // =========================
  // PERCENTILES — expected execution costs
  // Fees & tips percentiles RETURNED IN LAMPORTS
  // Independent stats window vs. the two above
  // =========================

  "percentilesFees": "p50",       // Optional. Percentile for fees. Examples: "p50", "p90", "50".
  "percentilesTips": "p50",       // Optional. Percentile for tips. Examples: "p50", "p95".
  "percentilesProvider": "ALL",   // Optional. One of: FAST, TEMPORAL, JITO, NEXTBLOCK, BLOX, ASTRALANE, FLASHBLOCK, NODEONE, RAZOR, SENDER, STELLIUM, FALCON, ALL. Example: "JITO".
  "percentilesBot": "ALL",        // Optional. One of: SMB, NOTARB, ALL. Example: "ALL" or "SMB".
  "percentilesTimeRange": 1800,    // Optional. Seconds. Min: 0, Max: 86400. Examples: 600, 1800, 3600.

  // Optional. List of signer wallets to track (Base58). Example: 0..N addresses. (If not specified, takes into account all transactions in the network)
  "wallets": [
    "RaVenxw8kykBbW7KGBaBsb7fDkkBYK4uJVDSFun6ZxR",
    "HxjwdF326ZunmUwC1iXhfgL3ku78YsksN6n7Rfxzwr6b",
    "7dGrdJRYtsNR8UYxZ3TnifXGjGc9eRYLq9sELwYpuuUu"
  ]
}

Response

Informations:

  • Requests per minute: Searcher 5 / Startup 60 / Pro 150

  • More technical information herearrow-up-right

Last updated