jup-ag Jupiter Token Verification
This skill routes agents through the public Jupiter token-verification flow for a Solana token mint.
Base URL: https://api.jup.ag
Auth: x-api-key from developers.jup.ag (required)
Cost: 1000 JUP
Use/Do Not Use
Use when:
- checking whether a token is eligible for submission
- crafting and signing the submission payment transaction
- executing the submission flow
- optionally updating token metadata as part of the submission
- submitting a metadata-only paid update when eligibility allows metadata but not verification
Do not use when:
- the agent would need private or internal routes
- the agent needs to fetch or merge existing metadata from non-public endpoints
- the user wants swaps, trading, or unrelated Jupiter flows
Triggers: verify token, submit verification, check eligibility, craft payment transaction, execute payment, pay for verification, update token metadata, metadata-only submission
Intent Router
| User intent | Endpoint | Method |
|---|---|---|
| Check eligibility | /tokens/v2/verify/express/check-eligibility?tokenId={TOKEN_ID} |
GET |
| Craft payment transaction | /tokens/v2/verify/express/craft-txn?senderAddress={SENDER_ADDRESS} |
GET |
| Sign and execute payment | /tokens/v2/verify/express/execute |
POST |
Eligibility Decision Matrix
canVerify |
canMetadata |
Action |
|---|---|---|
true |
true |
verification+metadata (if user has metadata) or verification only |
true |
false |
verification only, omit tokenMetadata |
false |
true |
metadata-only |
false |
false |
STOP — show verificationError / metadataError to user |
Examples
Load these on demand:
- API Reference for the exact request and response shapes, accepted input formats, normalization rules, submission-mode field requirements, and token metadata fields. This is the source of truth for request construction.
- Verify when the user wants to execute a request and has confirmed the paying wallet details
Agent Operating Rules
- Reuse as much as possible from the user's first message. Ask only for missing required fields.
- Never ask the user to paste a raw private key or seed phrase into chat.
- Never print secret values. Only mention non-sensitive file paths, key names, and derived public addresses.
- Do not claim a request was submitted unless you have a real API response or the user explicitly ran the local script themselves.
- If the current agent runtime cannot reach the network, install dependencies, or access local signer files, stop before execution and hand the user the exact local steps instead of fabricating progress.
Execution Notes
For execute requests in constrained agent environments:
- outbound HTTP and package installation may require approval or user permission
- equivalent shell and package-manager commands are fine; do not block on a specific CLI if the environment already has an equivalent way to run the same steps
Resources
- Jupiter Burn Multisig:
8gMBNeKwXaoNi9bhbVUWFt4Uc5aobL9PeYMXfYDMePE2 - JUP Token Mint:
JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN - Jupiter Docs: developers.jup.ag
- Jupiter Verified: verified.jup.ag