Jupiter Signal Lab

Jupiter Signal Lab is a read-only CLI that combines Jupiter Tokens V2 and Price V3 data into a compact signal board for human review.

It is designed for the Superteam "Not Your Regular Bounty" as an AI-agent-friendly integration experiment:

• Tokens V2 provides token search, category discovery, organic score, liquidity, audit flags, and trading stats.
• Price V3 provides USD price, block recency, decimals, and 24h price change.
• The CLI combines those into watch lanes and Trigger-style order ideas without signing or sending transactions.

Setup

cd jupiter-signal-lab
npm test
$env:JUPITER_API_KEY='<developer-platform-key>'
node bin\jup-signal-lab.js --category toporganicscore --interval 1h --limit 20

Keyless requests may work for light testing, but the bounty asks for Developer Platform usage, so a real key from developers.jup.ag is required before final submission.

Examples

Search known symbols:

node bin\jup-signal-lab.js --symbols "SOL,JUP" --json

Inspect exact mint addresses:

node bin\jup-signal-lab.js --mints "So11111111111111111111111111111111111111112,JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"

Scan a token category:

node bin\jup-signal-lab.js --category toptrending --interval 5m --limit 25

Output lanes:

• momentum-watch: strong trust/liquidity and controlled positive 24h momentum.
• dip-watch: strong token metrics with negative 24h move worth manual review.
• overextended-wait: strong token metrics but momentum is stretched.
• research-only: interesting but not enough for an execution plan.
• reject-suspicious: Jupiter audit flags indicate the token should be avoided.

Why This Is Different

Most token dashboards either show raw trending lists or jump directly to trading. Jupiter Signal Lab stops in the middle:

1. Discover candidates through Jupiter Tokens V2.
2. Pull Price V3 for current USD price and 24h movement.
3. Explain why a token is routed into a lane.
4. Produce a Trigger-style idea only as a human-review object.
5. Avoid wallet access and transaction creation entirely.

That makes it suitable for AI-agent workflows where the agent can research, rank, and explain, while a human stays responsible for execution.

Safety

This project does not:

• build transactions
• sign transactions
• place Trigger orders
• submit Swap orders
• use a wallet

Every Trigger-style output is a human-review idea only.

Submission Status

• Developer Platform API key support is implemented.
• Keyed and keyless smoke evidence is saved under examples/.
• DX-REPORT.md includes keyed run notes and read-only safety findings.
• Colosseum/GitHub/video links are handled outside the package source.

Bounty Artifacts

• DX-REPORT.md contains the Developer Experience report draft.
• COLOSSEUM_PROFILE.md contains copy for the Colosseum project profile.
• examples/keyless-smoke-exact-mints.md and examples/keyed-smoke-exact-mints.md are deterministic SOL/JUP smoke runs.
• examples/keyless-smoke-toptrending-5m.json and examples/keyed-smoke-toptrending-5m.json are live category smoke runs.
• examples/keyed-smoke-toporganicscore-1h.md is a keyed organic-score category run.