{"uid":"cap_RkYFRkI3m3A-3SQaIBEDH","slug":"pro-api-coingecko-com-963930ee","name":"CoinGecko On-Chain SOL Token Price (Solana)","description":"Fetches the on-chain USD price for the Solana token mint So11111111111111111111111111111111111111112 via x402 v2.","url":"https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/solana/token_price/So11111111111111111111111111111111111111112","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"include_24hr_vol":{"type":"boolean"},"mcap_fdv_fallback":{"type":"boolean"},"include_market_cap":{"type":"boolean"},"include_inactive_source":{"type":"boolean"},"include_24hr_price_change":{"type":"boolean"},"include_total_reserve_in_usd":{"type":"boolean"}}}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"include_24hr_vol":true,"include_market_cap":true,"include_24hr_price_change":true}},"output":{"type":"object","example":{"So11111111111111111111111111111111111111112":{"usd":150.25,"usd_24h_vol":5000000000,"usd_24h_change":2.5,"usd_market_cap":50000000000}}}},"response":{"data":{"id":"08f46dfb-0f65-4103-9cca-dc5507540fbb","type":"simple_token_price","attributes":{"token_prices":{"So11111111111111111111111111111111111111112":"74.071360525994967095600549603"},"h24_volume_usd":{"So11111111111111111111111111111111111111112":"4994167669.63176"},"market_cap_usd":{"So11111111111111111111111111111111111111112":"1655794978.6120305"},"h24_price_change_percentage":{"So11111111111111111111111111111111111111112":"4.3743795606"}}}}},"exampleRequest":{"include_24hr_vol":true,"include_market_cap":true,"include_24hr_price_change":true},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6ozFLImmNYv6uk43VfP_E","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the current on-chain USD price and market data for the native Solana (SOL) token (mint So11111111111111111111111111111111111111112) from CoinGecko's Pro API.","exampleAgentPrompt":"What's the current on-chain price of SOL in USD right now, including its 24-hour volume, market cap, and price change percentage?","exampleUseCases":[{"title":"Real-time portfolio value calculation","prompt":"I need to check how much my Solana holdings are worth right now. Can you get me the current SOL price in USD along with today's price change so I can see if I'm up or down?"},{"title":"DeFi swap execution validation","prompt":"Before I execute this token swap on a DEX, pull the latest on-chain SOL price and 24-hour volume to make sure I'm getting a fair rate compared to recent trading activity."},{"title":"Market analysis for trading decision","prompt":"Give me SOL's current price, market cap, and 24-hour change percentage so I can assess whether the token's momentum looks healthy right now and decide if it's a good entry point."}],"resultDescription":"Returns a JSON object keyed by the SOL mint address containing the current USD token price, and optionally 24-hour trading volume in USD, market cap in USD, and 24-hour price change percentage. Example: {\"So11111111111111111111111111111111111111112\": {\"usd\": 150.25, \"usd_24h_vol\": 3096660945.57, \"usd_market_cap\": 1084494857.78, \"usd_24h_change\": -0.47}}","failureModes":["Payment required (402): x402 micropayment of $0.01 USDC not provided or failed","Invalid token address: returns 404 or empty result","Network unavailable or CoinGecko Pro API outage: 503 or timeout","Rate limit exceeded: 429 Too Many Requests","Malformed query parameters: 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you specifically need the on-chain USD price of the native Solana (SOL) token with optional market data (volume, market cap, 24h change) from CoinGecko's Pro API. Prefer this over general CoinGecko coin price endpoints when you want on-chain DEX-sourced data for SOL rather than aggregated CEX pricing. Ideal for DeFi agents needing real-time SOL valuation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:56:40.597Z","isFirstParty":false}