{"uid":"cap_bAxHYVyCLQ_kT3BRQv82D","slug":"vybe-solana-trades-endpoint-52940514","name":"Vybe Solana Trades Endpoint","description":"Solana API endpoint for fetching trade history, volume, and metrics for any supported Solana AMM or DEX program, filtered by program.","url":"https://x402-api.vybenetwork.xyz/v4/trades?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer","format":"int32","minimum":0,"nullable":true,"description":"Page selection, 0-indexed."},"limit":{"type":"integer","format":"int32","minimum":0,"nullable":true,"description":"Limit of the number of trades to return per page. Default/max is 1000."},"timeEnd":{"type":"integer","format":"int64","minimum":0,"nullable":true,"description":"End time of the data to return (unix timestamp)"},"sortByAsc":{"type":"string","nullable":true,"description":"Sort ascending by 'price' or 'blockTime'. Only one of sort_by_asc or sort_by_desc can be used"},"timeStart":{"type":"integer","format":"int64","minimum":0,"nullable":true,"description":"Start time of the data to return (unix timestamp)"},"resolution":{"allOf":[{"type":"string","format":"resolution"}],"nullable":true,"description":"Resolution of the data. Possible values: 1h, 1d, 1w, 1m, 1y, or a string parseable to seconds"},"sortByDesc":{"type":"string","nullable":true,"description":"Sort descending by 'price' or 'blockTime'. Only one of sort_by_asc or sort_by_desc can be used"},"mintAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"The public key of either the base or quote token"},"marketAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"Market id to filter with. If provided, the baseMintAddress and quoteMintAddress fields are ignored"},"programAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"The program on which the trade occurred"},"baseMintAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"The public key of the base token"},"feePayerAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"The public key of the entity that pays for the trade, often used for retrieving trades associated with a specific trading account."},"authorityAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"Authority public key to filter with"},"quoteMintAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"The public key of the quote token"}}},"responseSchema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["authorityAddress","blockTime","iixOrdinal","baseMintAddress","interIxOrdinal","ixOrdinal","marketAddress","quoteMintAddress","price","programAddress","signature","slot","txIndex","fee","feePayerAddress","baseSize","quoteSize"],"properties":{"fee":{"type":"string","description":"The amount of fees paid for the trade."},"slot":{"type":"integer","format":"int64","minimum":0,"description":"Slot of the trade"},"price":{"type":"string","description":"The price of one unit of the base token, expressed in terms of the quote token."},"txIndex":{"type":"integer","format":"int32","description":"The transaction index of the trade."},"baseSize":{"type":"string","description":"The quantity of the base token involved in the trade."},"blockTime":{"type":"integer","format":"int64","description":"The Unix timestamp at which the trade occurred on the blockchain."},"ixOrdinal":{"type":"integer","format":"int32","minimum":0,"description":"The location of the trade ix inside the transaction."},"quoteSize":{"type":"string","description":"The amount of the quote token exchanged in the trade."},"signature":{"type":"string","description":"The unique identifier of the transaction signature on the blockchain."},"iixOrdinal":{"type":"integer","format":"int32","minimum":0,"description":"The location of the trade inner ix inside the transaction. 255 is returned if not applicable."},"marketAddress":{"type":"string","description":"The address of the market pair, e.g., SOL/USDC, where the trade took place."},"interIxOrdinal":{"type":"integer","format":"int32","minimum":0,"description":"The location of the trade inside an ix (in 2 hop swaps). 255 is returned if not applicable."},"programAddress":{"type":"string","description":"The public key of the AMM or DEX program that facilitated the trade."},"baseMintAddress":{"type":"string","description":"The mint address of the base token involved in the trade."},"feePayerAddress":{"type":"string","description":"The public key of the account responsible for paying the transaction fees."},"authorityAddress":{"type":"string","description":"The public key of the signer who authorized the trade."},"quoteMintAddress":{"type":"string","description":"The mint address of the quote token used in the trade."}}},"description":"Found trade data"}}},"example":null,"exampleRequest":null,"tags":["x402","finance"],"displayCostAmount":"0.024","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.024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lHcTSECQmylLeFICqwsRz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.024","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches paginated Solana on-chain trade records filtered by token, market, program, wallet, authority, or time range","exampleAgentPrompt":"Show me the last 100 trades for the SOL/USDC pair on Solana — filter by mint address So11111111111111111111111111111111111111112, sort descending by block time, and start from page 0.","exampleUseCases":null,"resultDescription":"Returns a paginated list of Solana on-chain trade records including price, block time, market, program, token addresses (base and quote), and fee payer details, structured as a TradeDataProgramVecReturn object","failureModes":["Payment not included or insufficient USDC via x402 — returns 402 Payment Required","Invalid mint or market address format — returns 400 Bad Request","Both sortByAsc and sortByDesc provided simultaneously — returns 400 Bad Request","Time range too wide or limit exceeds maximum of 1000 — returns 400 or truncated results","Unknown program address — returns empty result set or 404"],"whenToPreferThis":"Use this endpoint when you need granular, filterable Solana DEX trade history — especially when filtering by token mint, market, program, or fee payer. Prefer over wallet-level endpoints when the focus is trade events rather than account balances or transfers. The x402 micropayment model means no API key setup is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:42:00.152Z","isFirstParty":false,"canonicalSlug":"vybe-solana-trades-endpoint-52940514"}