{"openapi":"3.1.0","info":{"title":"Jupiter (BYOK) API","version":"0.1.0","description":"Jupiter (BYOK) lets an AI assistant read your own Jupiter data through the Jupiter API with a key you supply (Jupiter Developer Platform API key (free tier available)). Read-only: 8 tools (search_tokens, list_tokens_by_tag, list_top_tokens, list_recent_tokens, get_token_prices, list_lend_earn_tokens, get_lend_positions, get_lend_earnings). The BYOK key travels with each request, is used for that...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-jupiter.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-jupiter/docs"},"termsOfService":"https://connectorbay.com/byok-jupiter/terms"},"servers":[{"url":"https://byok-jupiter.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-jupiter/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_tokens":{"post":{"operationId":"search_tokens","summary":"Search Solana tokens by symbol, name or mint address (comma-separate up to 100 mints), with price, market cap, liquidity","description":"Search Solana tokens by symbol, name or mint address (comma-separate up to 100 mints), with price, market cap, liquidity, holders, organic score and 24h trading stats. Use for \"Find the Solana token JUP and show its price and organic score\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Symbol, name or mint address; comma-separate several mints.","maxLength":200,"title":"Query","type":"string"}},"required":["query"],"title":"search_tokensArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_tokens_by_tag":{"post":{"operationId":"list_tokens_by_tag","summary":"List Solana tokens carrying a tag: lst (liquid staking tokens), verified or stocks (tokenized equities). Use for \"Which ","description":"List Solana tokens carrying a tag: lst (liquid staking tokens), verified or stocks (tokenized equities). Use for \"Which Solana tokens are tagged as liquid staking tokens\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Tag name.","enum":["lst","verified","stocks"],"title":"Query","type":"string"}},"required":["query"],"title":"list_tokens_by_tagArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_top_tokens":{"post":{"operationId":"list_top_tokens","summary":"List top Solana tokens by organic score, traded volume or trending, over a 5m, 1h, 6h or 24h window. Use for \"Which Sola","description":"List top Solana tokens by organic score, traded volume or trending, over a 5m, 1h, 6h or 24h window. Use for \"Which Solana tokens are trending over the last hour\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"Ranking category.","enum":["toporganicscore","toptraded","toptrending"],"title":"Category","type":"string"},"interval":{"description":"Time window.","enum":["5m","1h","6h","24h"],"title":"Interval","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Number of tokens (1 to 100).","title":"Limit"}},"required":["category","interval"],"title":"list_top_tokensArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_recent_tokens":{"post":{"operationId":"list_recent_tokens","summary":"List Solana tokens whose first liquidity pool was created most recently. Use for \"Which new Solana tokens just got their","description":"List Solana tokens whose first liquidity pool was created most recently. Use for \"Which new Solana tokens just got their first pool\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_recent_tokensArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_token_prices":{"post":{"operationId":"get_token_prices","summary":"Get current USD prices for up to 50 Solana token mints, with liquidity, decimals and 24h price change. Tokens without a ","description":"Get current USD prices for up to 50 Solana token mints, with liquidity, decimals and 24h price change. Tokens without a reliable price are omitted. Use for \"What are the USD prices of SOL and USDC\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ids":{"description":"Comma-separated token mint addresses (up to 50).","maxLength":200,"title":"Ids","type":"string"}},"required":["ids"],"title":"get_token_pricesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_lend_earn_tokens":{"post":{"operationId":"list_lend_earn_tokens","summary":"List Jupiter Lend earn vaults: underlying asset, total assets and supply, supply and rewards rates and withdrawable liqu","description":"List Jupiter Lend earn vaults: underlying asset, total assets and supply, supply and rewards rates and withdrawable liquidity. Use for \"What are the current Jupiter Lend earn rates\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_lend_earn_tokensArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_lend_positions":{"post":{"operationId":"get_lend_positions","summary":"List the Jupiter Lend earn positions of one or more wallets: vault, shares, underlying assets and allowance. Use for \"Wh","description":"List the Jupiter Lend earn positions of one or more wallets: vault, shares, underlying assets and allowance. Use for \"What does this wallet have deposited in Jupiter Lend\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"users":{"description":"Wallet addresses, comma-separated.","maxLength":200,"title":"Users","type":"string"}},"required":["users"],"title":"get_lend_positionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_lend_earnings":{"post":{"operationId":"get_lend_earnings","summary":"Get the Jupiter Lend earnings of a wallet for given vault token positions. Use for \"How much has this wallet earned in J","description":"Get the Jupiter Lend earnings of a wallet for given vault token positions. Use for \"How much has this wallet earned in Jupiter Lend\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"user":{"description":"Wallet address, base58.","maxLength":200,"title":"User","type":"string"},"positions":{"description":"Vault token addresses (position tokens), comma-separated.","maxLength":200,"title":"Positions","type":"string"}},"required":["user","positions"],"title":"get_lend_earningsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}