{
 "openapi": "3.1.0",
 "info": {
  "title": "FOBO agent",
  "version": "1.0.0",
  "description": "Every fobo.fun launch on Robinhood Chain: tokens, floors (the worst-case price, which only rises), holders, creators and their fees, launch-window snipers, locks, limit orders, referrals, protocol revenue and the $FOBO burn. Facts and history from a live index, never a buy or sell call.\n\nSign in with a wallet: POST https://21413.8004.im/auth/challenge {\"address\":\"0x…\"} → sign the returned message with that wallet (personal_sign) → POST https://21413.8004.im/auth/token {\"address\",\"message\",\"signature\"} → send \"Authorization: Bearer <token>\" (valid 24 h, works on all our agents). Signed in on https://www.erc8004.markets/chat? Use \"API token\" there."
 },
 "servers": [
  {
   "url": "https://21413.8004.im"
  }
 ],
 "components": {
  "securitySchemes": {
   "wallet": {
    "type": "http",
    "scheme": "bearer"
   }
  }
 },
 "security": [
  {
   "wallet": []
  }
 ],
 "paths": {
  "/auth/challenge": {
   "post": {
    "summary": "Message to sign",
    "security": [],
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "address": {
          "type": "string"
         }
        },
        "required": [
         "address"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/auth/token": {
   "post": {
    "summary": "Bearer token (24 h) for a signed message",
    "security": [],
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "address": {
          "type": "string"
         },
         "message": {
          "type": "string"
         },
         "signature": {
          "type": "string"
         }
        },
        "required": [
         "address",
         "message",
         "signature"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/v1/me": {
   "get": {
    "summary": "Your tier and today's quota for this agent",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/ask": {
   "post": {
    "summary": "Ask FOBO agent in plain words",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "q": {
          "type": "string"
         }
        },
        "required": [
         "q"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/fobo_today": {
   "post": {
    "summary": "FOBO right now: launches, swaps, traders and volume in the last 24 h, floor raises, the $FOBO price, floor and burn, and the most traded tokens today.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {},
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/find_tokens": {
   "post": {
    "summary": "List / filter / rank FOBO tokens. Sorts: volume_24h (default), volume, mcap, holders, floor_growth, closest_to_floor (least downside to the floor), newest, trades. Filters: quote (ETH or FOBO pair), age, volume, market cap, holders, max_drop_pct (most the price can fall to the floor), creator_locked, traded_today, creator.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "sort": {
          "type": "string",
          "enum": [
           "newest",
           "volume_24h",
           "volume",
           "mcap",
           "holders",
           "floor_growth",
           "closest_to_floor",
           "trades"
          ]
         },
         "quote": {
          "type": "string",
          "description": "ETH or FOBO (the pair)"
         },
         "max_age_hours": {
          "type": "number"
         },
         "min_age_hours": {
          "type": "number"
         },
         "min_volume_usd": {
          "type": "number"
         },
         "min_volume_24h_usd": {
          "type": "number"
         },
         "min_mcap_usd": {
          "type": "number"
         },
         "max_mcap_usd": {
          "type": "number"
         },
         "min_holders": {
          "type": "integer"
         },
         "max_drop_pct": {
          "type": "number",
          "description": "at most this % between the price and the floor"
         },
         "creator_locked": {
          "type": "boolean",
          "description": "the creator locked their launch buy in FoboVesting"
         },
         "traded_today": {
          "type": "boolean"
         },
         "creator": {
          "type": "string",
          "description": "creator address"
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/new_launches": {
   "post": {
    "summary": "The newest FOBO launches.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "quote": {
          "type": "string",
          "description": "ETH or FOBO"
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/token_check": {
   "post": {
    "summary": "Everything about one FOBO token: price, market cap, the floor and how far the price can drop to it, floor growth, volume, holders and top-holder share, creator holding, dev buy and how long it is locked, creator fees earned / owed / paid out, launch-window (snipe) activity, locked supply and unlocks, buybacks, open limit orders, protocol fees, its description and links.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "token address, $TICKER, ticker or name"
         }
        },
        "required": [
         "token"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/token_trades": {
   "post": {
    "summary": "Latest swaps of one token, with trader, side, USD, tax.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "token address, $TICKER, ticker or name"
         },
         "side": {
          "type": "string",
          "enum": [
           "buy",
           "sell"
          ]
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": [
         "token"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/token_holders": {
   "post": {
    "summary": "Top holders of one token (pool and FOBO contracts left out).",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "token address, $TICKER, ticker or name"
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": [
         "token"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/floor_history": {
   "post": {
    "summary": "How one token’s floor (worst-case price) has risen: each raise, growth over 1 d / 7 d / since launch.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "token address, $TICKER, ticker or name"
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": [
         "token"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/creator_profile": {
   "post": {
    "summary": "One creator: the tokens they launched, volume, and the creator fees they earned, still owed and already paid out.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "address": {
          "type": "string",
          "description": "wallet address 0x…"
         }
        },
        "required": [
         "address"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/top_creators": {
   "post": {
    "summary": "Creators ranked by fees earned (default), launches or volume.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "sort": {
          "type": "string",
          "enum": [
           "earned",
           "launches",
           "volume"
          ]
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/wallet_profile": {
   "post": {
    "summary": "One wallet on FOBO: tokens traded, bought / sold / holding in USD, PnL, tax paid, launch-window trades, tokens it launched, who referred it and its referral earnings, its limit orders.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "address": {
          "type": "string",
          "description": "wallet address 0x…"
         }
        },
        "required": [
         "address"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/top_traders": {
   "post": {
    "summary": "Wallets with the most FOBO volume over the last N days (default 7).",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "days": {
          "type": "integer"
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/launch_snipers": {
   "post": {
    "summary": "Wallets that buy in tokens’ first 60 s (the high-tax launch window), for one token or across all launches.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "optional token"
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/unlocks": {
   "post": {
    "summary": "Locked supply (FoboVesting): for one token, or every lock fully unlocking in the next N days (default 30).",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string"
         },
         "days": {
          "type": "integer"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/fobo_burn": {
   "post": {
    "summary": "$FOBO bought back and burned: totals, share of supply, ETH spent, latest burns.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/daily_trend": {
   "post": {
    "summary": "FOBO day by day (UTC) over the last N days (default 14): launches, swaps, traders, volume, protocol fees, floor raises, $FOBO burned, and the change of the recent half against the half before.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "days": {
          "type": "integer"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/limit_orders": {
   "post": {
    "summary": "FoboLimitOrders: limit buys / sells, for one token, one owner wallet, or all; status open (default all), filled, cancelled, refunded, expired. Totals: open orders and their USD, fills, keeper fees.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "optional token"
         },
         "owner": {
          "type": "string",
          "description": "optional owner wallet 0x…"
         },
         "status": {
          "type": "string",
          "enum": [
           "open",
           "filled",
           "cancelled",
           "refunded",
           "expired",
           "all"
          ]
         },
         "side": {
          "type": "string",
          "enum": [
           "buy",
           "sell"
          ]
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/referrals": {
   "post": {
    "summary": "FOBO referrals (FoboRevenue): with an address, the traders that wallet referred and what it earned; without, the top referrers by earnings. days = optional period.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "address": {
          "type": "string",
          "description": "optional referrer wallet 0x…"
         },
         "days": {
          "type": "integer"
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/protocol_revenue": {
   "post": {
    "summary": "FOBO’s own revenue: protocol fees and how they were split (team, partners, referrers), creator fees and floor money from swaps, $FOBO burned, payouts, and the tokens that paid the most fees. days = optional period (default all time).",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "days": {
          "type": "integer"
         },
         "limit": {
          "type": "integer",
          "description": "rows to return (default 25)"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/fobo_settings": {
   "post": {
    "summary": "FOBO’s live settings and rules: launch fee, max dev buy, whether launches are paused, allowed quote tokens, tax split, referrer / partner shares, team and owner, limit-order pay tokens, and the latest config changes on chain.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {},
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  }
 }
}