{
 "openapi": "3.1.0",
 "info": {
  "title": "Pons agent",
  "version": "1.0.0",
  "description": "Every pons launch on Robinhood Chain since day one: launches, curve trades, fees, graduations, creators, early buyers, snipers and proven wallets, and how past launches with the same early signals did. Facts and past hit rates from a live index, never a buy or sell call.\n\nSign in with a wallet: POST https://21410.8004.im/auth/challenge {\"address\":\"0x…\"} → sign the returned message with that wallet (personal_sign) → POST https://21410.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://21410.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 Pons 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/token_check": {
   "post": {
    "summary": "Everything about one pons token: price-free facts (volume, traders, fees to creator, graduated or not), first-minute / 5-minute / 1-hour buyers, proven early buyers, snipers, creator history, copycat X links, and how past launches with the same early signals did (graduation rate vs normal).",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "A $TICKER (e.g. $HOODLE) or the token contract address (0x…)."
         }
        },
        "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_early_buyers": {
   "post": {
    "summary": "The proven wallets (good record of buying early into launches that graduated) that bought this token early, with their records.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "A $TICKER (e.g. $HOODLE) or the token contract address (0x…)."
         }
        },
        "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_copycats": {
   "post": {
    "summary": "Other launches with the same ticker or the same X link as this token.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "A $TICKER (e.g. $HOODLE) or the token contract address (0x…)."
         }
        },
        "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_creator": {
   "post": {
    "summary": "Profile of the creator of this token: their other launches, graduations, fees earned, trading.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "token": {
          "type": "string",
          "description": "A $TICKER (e.g. $HOODLE) or the token contract address (0x…)."
         }
        },
        "required": [
         "token"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/address_profile": {
   "post": {
    "summary": "Profile of one wallet address: launches created, early-buy record, curve trading, fees credited and unclaimed, biggest positions.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "address": {
          "type": "string",
          "description": "0x… wallet address"
         }
        },
        "required": [
         "address"
        ]
       }
      }
     }
    },
    "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": "Live screener: launches from the last N minutes (5–240) with their first-minute buyers, proven early buyers and snipers, best first. Numbers refresh every minute.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "minutes": {
          "type": "number"
         },
         "min_buyers": {
          "type": "number",
          "description": "min outside buyers in the first 5 min"
         },
         "min_proven": {
          "type": "number",
          "description": "min proven early buyers in the first hour"
         },
         "pair": {
          "type": "string",
          "enum": [
           "any",
           "ETH",
           "USDG",
           "Stocks"
          ]
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/find_launches": {
   "post": {
    "summary": "Flexible search over all pons launches with filters (age, pair, graduated, has X / website, min/max fees to creator in USD, curve volume, traders, first-minute buyers, proven early buyers, snipers, creator tax %, creator sold early, a creator address, a ticker) and a sort. Use for any list of launches: top by volume / traders (≈ holders) / fees, fastest or recent graduations, fees but never graduated, no socials, etc.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "days": {
          "type": "number",
          "description": "Only launches from the last N days (0.04 = 1 hour). Omit for all time (pons started 3 Aug 2026)."
         },
         "pair": {
          "type": "string",
          "enum": [
           "any",
           "ETH",
           "USDG",
           "Stocks"
          ],
          "description": "Quote pair. Default any."
         },
         "graduated": {
          "type": "string",
          "enum": [
           "any",
           "yes",
           "no"
          ],
          "description": "Graduated from the bonding curve? Default any."
         },
         "has_x": {
          "type": "boolean",
          "description": "true = has an X (Twitter) link, false = has none."
         },
         "has_website": {
          "type": "boolean",
          "description": "true = has a website, false = has none."
         },
         "creator_sold_early": {
          "type": "boolean",
          "description": "The creator sold in the first 5 minutes."
         },
         "creator": {
          "type": "string",
          "description": "Only launches by this creator address (0x…)."
         },
         "ticker": {
          "type": "string",
          "description": "Ticker equals this (without $)."
         },
         "graduated_within_hours": {
          "type": "number",
          "description": "Graduated within the last N hours."
         },
         "min_fees_usd": {
          "type": "number"
         },
         "max_fees_usd": {
          "type": "number"
         },
         "min_volume_usd": {
          "type": "number"
         },
         "max_volume_usd": {
          "type": "number"
         },
         "min_traders": {
          "type": "number"
         },
         "max_traders": {
          "type": "number"
         },
         "min_buyers_1m": {
          "type": "number"
         },
         "max_buyers_1m": {
          "type": "number"
         },
         "min_buyers_5m": {
          "type": "number"
         },
         "max_buyers_5m": {
          "type": "number"
         },
         "min_proven_1m": {
          "type": "number"
         },
         "max_proven_1m": {
          "type": "number"
         },
         "min_proven_5m": {
          "type": "number"
         },
         "max_proven_5m": {
          "type": "number"
         },
         "min_proven_60m": {
          "type": "number"
         },
         "max_proven_60m": {
          "type": "number"
         },
         "min_snipers": {
          "type": "number"
         },
         "max_snipers": {
          "type": "number"
         },
         "min_creator_tax_pct": {
          "type": "number"
         },
         "max_creator_tax_pct": {
          "type": "number"
         },
         "min_age_hours": {
          "type": "number"
         },
         "max_age_hours": {
          "type": "number"
         },
         "min_minutes_to_graduate": {
          "type": "number"
         },
         "max_minutes_to_graduate": {
          "type": "number"
         },
         "sort": {
          "type": "string",
          "enum": [
           "volume",
           "traders",
           "fees",
           "newest",
           "oldest",
           "fastest_graduation",
           "recently_graduated",
           "proven_buyers",
           "first_minute_buyers"
          ],
          "description": "Default volume."
         },
         "refine_previous": {
          "type": "boolean",
          "description": "true = start from the filters of the previous launch list in this conversation and change only the ones given here."
         },
         "limit": {
          "type": "number",
          "description": "Rows to return, 1–100. Default 50."
         }
        }
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/unclaimed": {
   "post": {
    "summary": "Addresses with the most creator fees credited but not yet claimed (USD).",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "min_usd": {
          "type": "number"
         }
        },
        "required": []
       }
      }
     }
    },
    "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 (launchers) ranked by graduations, volume, number of launches, or graduation rate (min 5 launches) over the last N days.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "metric": {
          "type": "string",
          "enum": [
           "grads",
           "volume",
           "launches",
           "rate"
          ]
         },
         "days": {
          "type": "number"
         },
         "pair": {
          "type": "string",
          "enum": [
           "any",
           "ETH",
           "USDG",
           "Stocks"
          ]
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/bot_farms": {
   "post": {
    "summary": "Creators with very many launches (likely bots) and their graduation rate.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "min_launches": {
          "type": "number"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/proven_wallets": {
   "post": {
    "summary": "Wallets with the best early-buy record (bought within 2 min of launch; share that graduated).",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "min_n": {
          "type": "number",
          "description": "min early buys, default 10"
         },
         "sort": {
          "type": "string",
          "enum": [
           "rate",
           "n"
          ]
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/snipers": {
   "post": {
    "summary": "Wallets that most often buy in the launch block itself.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "min_n": {
          "type": "number"
         }
        },
        "required": []
       }
      }
     }
    },
    "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": "Biggest curve traders, by volume, net taken out (sold minus bought, i.e. profit on the curve), number of trades, or number of tokens.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "sort": {
          "type": "string",
          "enum": [
           "volume",
           "net",
           "trades",
           "tokens"
          ]
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/today": {
   "post": {
    "summary": "Today on pons vs the last days: launches, graduations, curve volume, traders, fees.",
    "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/pair_trend": {
   "post": {
    "summary": "ETH vs USDG vs stock pairs over the last N days: launches, graduations, volume.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "days": {
          "type": "number"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/fees_summary": {
   "post": {
    "summary": "All-time fee totals: charged on curves, paid to creators, protocol, launch platforms, unclaimed.",
    "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/time_to_grad": {
   "post": {
    "summary": "How long launches take to graduate (median, percentiles) over the last N days.",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "days": {
          "type": "number"
         },
         "pair": {
          "type": "string",
          "enum": [
           "any",
           "ETH",
           "USDG",
           "Stocks"
          ]
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/signal_rates": {
   "post": {
    "summary": "How past launches did grouped by one early signal (graduation, $10k volume, $1k creator fees rates vs normal).",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "signal": {
          "type": "string",
          "enum": [
           "buyers_1m",
           "proven_1m",
           "proven_5m",
           "proven_60m",
           "snipers",
           "first_buy",
           "creator_sold",
           "top_share",
           "launch_mode",
           "socials",
           "x_reuse",
           "creator_history",
           "pair",
           "tax",
           "hour"
          ],
          "description": "buyers_1m: Outside buyers in the first minute; proven_1m: Proven early buyers in the first minute; proven_5m: Proven early buyers in the first 5 minutes; proven_60m: Proven early buyers in the first hour; snipers: Snipers (outside buys in the launch block); first_buy: Time to the first outside buy; creator_sold: Creator sold in the first 5 minutes; top_share: Biggest outside buyer's share of buys (5 min); launch_mode: How it was launched; socials: Links set at launch; x_reuse: Same X link used by other launches; creator_history: Creator's earlier launches; pair: Pair; tax: Creator tax; hour: Launch hour (UTC)"
         }
        },
        "required": [
         "signal"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  },
  "/v1/tools/playbook": {
   "post": {
    "summary": "Which early signals went with success most and least often (best and worst groups by lift).",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "outcome": {
          "type": "string",
          "enum": [
           "grad",
           "big",
           "fees"
          ],
          "description": "grad = graduated, big = $10k curve volume, fees = creator earned $1k+"
         }
        },
        "required": []
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "Sign-in needed"
     },
     "429": {
      "description": "Daily quota used"
     }
    }
   }
  }
 }
}