docs
how Pons Agent works
PONS AGENT is an agent that lives on X. There is no app, no dashboard and no DMs. You tag it under a post, it reads the coin and replies in the same thread.
quickstart
Reply to any post that mentions a coin — yours or someone else's — and put @ponsagentx in your reply. That is the entire interface.
what you post
@ponsagentx $TICKERA contract address works too, and is always more precise than a ticker: @ponsagentx So11111111111111111111111111111111111111112
what comes back
Every reply is assembled from live market data. The numbers and links are generated by code, not written by the model — a model that rewrites prices eventually invents one. Only the closing line is written by the model.
- price
- Current price in USD, at as many decimals as the coin needs.
- mc
- Market cap. Falls back to fully diluted value when the source has no circulating supply.
- liq
- Pool liquidity in USD. The number that decides whether you can actually get out.
- vol
- Traded volume over the last 24 hours.
- 24h / 1h
- Price change over each window.
- Nb / Ns
- Buys and sells in the last 24 hours. Lopsided counts say more than the price does.
- x
- The project's X handle, as declared by the project.
- chart
- Link to the pair on DexScreener.
- axiom
- Deep link to the token on Axiom. Only included for chains Axiom covers — Solana by default — because a link to a chain it does not know opens an empty page.
Socials and websites are self-reported. Anyone launching a token can write whatever they want in those fields. PONS AGENT passes them through as declared — it does not verify that the account belongs to the project.
how it picks the coin
The agent reads your reply first, then the post you replied to. A contract address always wins over a $ticker, because an address is unambiguous and a ticker is a guess.
When several tokens share a ticker, it picks the pair with the most 24h volume, not the most liquidity — liquidity is cheap to fake, volume is not. It then says in the reply that the ticker was ambiguous, so you can check it looked at the coin you meant.
If it cannot find a coin, or the market data source has nothing for it, it stays quiet. A made-up answer is worse than no answer.
limits and rules
- One reply per mention. Tagging again in the same post does nothing.
- It never replies to itself, and it ignores its own posts.
- It gives no financial advice. It will not tell you to buy, sell or hold, and it does not predict prices. It describes what the data shows and names the risk it can see.
- Replies fit in one post. If everything does not fit, the links and the numbers stay and the commentary is dropped.
- It works only in public posts. It does not read or send DMs.
what it runs on
- market data
- DexScreener public API — prices, liquidity, volume, transactions and the project's declared socials.
- commentary
- Claude, given the market snapshot and asked for one closing line. It reads the numbers but never writes them — the data block is assembled in code.
- x
- The official X API. It polls its own mentions and replies in-thread.
- axiom links
- A configurable deep-link template. Axiom has no public API, so the format is observed rather than documented.