Skip to content

EmergentKnowledgeGroup/jupiter-signal-forge

Repository files navigation

Jupiter Signal Forge

Jupiter Signal Forge is an agent-built market structure lab for the Superteam Earn "Not Your Regular Bounty" track.

It combines Jupiter's Tokens API, Price API, and Swap V2 order endpoint into a small dashboard that turns live Solana token data into:

  • route pressure scores
  • token trust and liquidity notes
  • a non-executing Swap V2 quote probe
  • product ideas that chain Jupiter APIs together

The app does not sign transactions, does not custody funds, and does not place trades. It uses a public no-funds taker address for Swap V2 probes so the response exposes route shape, price impact, and error semantics without execution.

Live Links

APIs Used

  • GET /tokens/v2/{category}/{interval} for toptrending, toptraded, and toporganicscore
  • GET /tokens/v2/recent for fresh pool discovery
  • GET /price/v3?ids=... for selected token, SOL, and USDC price checks
  • GET /swap/v2/order for non-executing SOL route probes

Keyless access is supported by Jupiter at low rate limits, so the public demo works without a bundled secret. If you want higher rate limits, set VITE_JUPITER_API_KEY before building.

Local Run

npm install
npm run dev

Verification

npm run lint
npm run build

Agent Notes

The implementation was built by Codex using Jupiter's integrating-jupiter agent skill plus the live docs index. The skill was useful as an endpoint router, but live docs were fresher on keyless API access, so the implementation follows the current docs behavior and keeps API-key use optional.

Why This Is Solana-Native

Jupiter Signal Forge uses Solana token mints as primary identities and works directly from Jupiter's Solana market data. It does not translate the chain into a generic price board; it keeps the account and route context visible so an agent can reason about liquidity, token verification, holder concentration, and whether a Swap V2 route is worth touching.

Why It Is Novel

Most hackathon demos either execute a transaction or show a token table. This project turns a failed-to-execute route probe into a useful design signal. The no-funds Swap V2 response is not treated as a dead end. It becomes part of a read-only route pressure model that can generate next product moves such as trigger rehearsals, route fingerprints, and trust quarantines.

Agent Autonomy

Codex selected the opportunity, read the Superteam and Jupiter docs, installed Jupiter's agent skill, implemented the app, wrote this README and the DX report, verified the app locally and on GitHub Pages with Playwright, published the repo, and submitted through the Superteam agent API. Human involvement was limited to providing payout addresses and broad authorization.

About

Agent-built Jupiter API signal lab for route pressure and product ideas

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors