Hummingbirdα

Find opportunities. Make informed decisions.

Alpha
Hummingbird APIv1
API Pro $19.50/monthGet API key
Daily allowance10,000requests / UTC day
Rate60per minute · all keys
Cost calculations10per minute · ≤ 5 routes each
Keys2active read-only keys
AuthBearerHUMMINGBIRD_API_KEY

Hummingbird's arbitrage data, in your own tools and AI.

Find opportunities, calculate costs at your amount, check the exit. One read-only REST API and an online Skill your AI assistant can follow.

Get API keyRead the documentation

Example request

Sample data · not live
Request · cURL
curl "https://humarb.com/api/v1/opportunities?size=10000&hours=24&limit=5" \
  -H "Authorization: Bearer $HUMMINGBIRD_API_KEY"
executionPlan.netUsd
Net after four entry/exit fees on current public books
breakEven.hours
First time the scenario net turns nonnegative at a constant funding rate
liquidityCapacity.status
Depth check for your amount; limited or unknown rows still return
scan.nextOffset
Cursor for the next five candidates; an empty page can still have more
executable
Always false: a calculation, not an order or a fill

Only engine-selected routes whose fresh executionPlan.netUsd is still positive are returned.

200 · application/jsonexcerpt of fields
{
  "version": 1,
  "mode": "current_positive_execution_references",
  "status": "ready",
  "asOf": "2026-09-30T08:00:00.000Z",
  "modelInvoked": false,
  "scan": {
    "scanned": 5,
    "positive": 1,
    "engineSelected": 1,
    "nextOffset": 5
  },
  "routes": [
    {
      "routeId": "4c1f0a9e2b7d4e6f8a3c5b1d0e9f7a26",
      "long": {
        "venue": "bybit",
        "symbol": "BTCUSDT"
      },
      "short": {
        "venue": "okx",
        "symbol": "BTC-USDT-SWAP"
      },
      "executable": false,
      "executionPlan": {
        "status": "ready",
        "netUsd": "12.40",
        "netReturnPct": "0.062",
        "breakEven": {
          "status": "within_horizon",
          "hours": "8"
        },
        "validUntil": "2026-09-30T08:01:00.000Z"
      },
      "liquidityCapacity": {
        "status": "within_policy"
      }
    }
  ]
}

Endpoints

Full reference
  • GET/opportunitiesfunding:read

    Scan up to 5 candidates on current public books; returns engine-selected pairs whose fresh net stays positive

    Docs
  • POST/execution-plansfunding:read

    Cost calculation for 1–5 route IDs at your amount, fees and capital

    Docs
  • GET/routesfunding:read

    Retained raw route universe for research, including negative and unverified rows

    Docs
  • GET/marketsmarkets:read

    Retained public contract metadata by venue and asset

    Docs
  • GET/routes/{routeId}/analysisfunding:read

    Saved engine report matching the route and scenario

    Docs
  • GET/assessments/{assessmentId}funding:read

    A saved report by ID while it is retained

    Docs
  • GET/history?routeId=…&days=7funding:read

    7- or 30-day settlement history with coverage

    Docs
  • GET/eventsfunding:read

    SSE notice when a new funding snapshot is published

    Docs

Hand a task to your AI

Each prompt tells your AI to read the Skill online, then do the task. Analysis only; it never places orders.

  • Funding opportunity scanner

    Find engine-selected pairs with positive current net estimates. Compare venues, costs and source times in one view.

    Pairs · net estimates · evidence

  • Net return calculator

    Use your amount and account fees to align both legs and calculate entry, exit and funding cash flows.

    Paired size · fees · net return

  • Faster break-even shortlist

    Compare the cost-recovery schedule. Put 1–3 hour scenarios first, with depth limits and risks alongside.

    Break-even time · settlement count

  • Exit risk simulator

    Compare adverse exits and basis convergence before committing to a route. Separate assumptions from known costs.

    Exit scenarios · net after stress

  • History & engine evidence

    Combine saved engine judgments with 7- or 30-day settlement records to inspect reversals and coverage.

    Settlement history · saved judgments

  • Opportunity update assistant

    Use publication events to refresh your watchlist or dashboard when a new funding snapshot is available.

    Publication events · refresh logic

Read-only data and scenario analysis. Credentials and order execution stay in your system. Results retain their source times and assumptions; future returns are uncertain.