{"uid":"cap_P8lY5W7pJX3B-lt50Nw8U","slug":"vybe-solana-token-transfers-query-db6e5cba","name":"Vybe Solana Token Transfers Query","description":"**Replaces**: `GET /token/transfers`\n\nReturns on-chain transfer history with filtering by token, sender, receiver, time, and amount.","url":"https://x402-api.vybenetwork.xyz/v4/transfers?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 transfers 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)"},"maxAmount":{"type":"integer","format":"int64","minimum":0,"nullable":true,"description":"Upper bound of the amount to filter with"},"minAmount":{"type":"integer","format":"int64","minimum":0,"nullable":true,"description":"Lower bound of the amount to filter with"},"signature":{"type":"string","nullable":true,"description":"Signature of the transaction"},"sortByAsc":{"type":"string","nullable":true,"description":"Sort ascending by 'amount', 'slot', 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)"},"sortByDesc":{"type":"string","nullable":true,"description":"Sort descending by 'amount', 'slot', 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 the token of interest"},"senderAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"Sender’s public key"},"feePayerAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"Fee payer's public key"},"receiverAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"Receiver’s public key"},"senderAccountAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"Sender’s token account address"},"callingProgramAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"The public key of the Calling program"},"receiverAccountAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"Receiver’s token account address"}}},"responseSchema":{"type":"object","required":["transfers"],"properties":{"transfers":{"type":"array","items":{"type":"object","required":["signature","callingMetadata","senderAddress","mintAddress","feePayerAddress","decimal","amount","slot","blockTime","price","calculatedAmount","valueUsd"],"properties":{"slot":{"type":"integer","format":"int64","minimum":0,"description":"The slot number in which the transaction was processed on the Solana blockchain, helping to pinpoint the exact sequence of events."},"price":{"type":"string","description":"Price of the token involved in the transaction (e.g. `mint_address`) expressed in USD."},"amount":{"type":"integer","format":"int64","minimum":0,"description":"The total number of tokens involved in the transaction."},"decimal":{"type":"integer","format":"int64","minimum":0,"description":"The number of decimal places used for the token's smallest unit."},"valueUsd":{"type":"string","description":"Calculated total USD value of the transfer based on the `amount`, `decimal`, and `price` values."},"blockTime":{"type":"integer","format":"int64","description":"The timestamp when the transaction was confirmed on the blockchain, in Unix time."},"signature":{"type":"string","description":"The cryptographic signature that uniquely identifies the transaction on the blockchain."},"mintAddress":{"type":"string","description":"The public key of the token's mint, specifying the token type involved in the transaction."},"senderAddress":{"type":"string","description":"The public key of the account sending the tokens."},"callingMetadata":{"type":"array","items":{"type":"object","required":["callingInstructions","ixName","callingProgramAddress","programName"],"properties":{"ixName":{"type":"string"},"programName":{"type":"string"},"callingInstructions":{"type":"string","format":"binary"},"callingProgramAddress":{"type":"string"}}},"description":"The public key of the Solana program that initiated the transaction."},"feePayerAddress":{"type":"string","description":"The public key of the account responsible for paying the transaction fees."},"receiverAddress":{"type":"string","nullable":true,"description":"The public key of the account receiving the tokens."},"calculatedAmount":{"type":"string","description":"The resulting amount after applying the `decimal` to the `amount` value."},"senderAccountAddress":{"type":"string","nullable":true,"description":"The public key of the specific token account address of the sender."},"receiverAccountAddress":{"type":"string","nullable":true,"description":"The public key of the specific token account address of the receiver."}}},"description":"Found transfer 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_E6PE1jNbYy4xCwiBjlUlx","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":"Query and filter historical Solana token transfer events by sender, receiver, token, amount range, time range, or transaction signature","exampleAgentPrompt":"Show me all SPL token transfers sent from wallet 7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs for the USDC mint between January 1 2025 and March 31 2025, sorted newest first, up to 100 results per page.","exampleUseCases":null,"resultDescription":"Returns a paginated list of Solana token transfer records matching the specified filters, including transaction signatures, sender and receiver wallet addresses, token account addresses, transfer amounts, block times, slot numbers, and the calling program — up to 1000 transfers per page.","failureModes":["Payment required (402) if x402 USDC payment header is missing or insufficient","Invalid public key format for mintAddress, senderAddress, or receiverAddress returns 400","Conflicting sort parameters (both sortByAsc and sortByDesc set) returns 400","No results if time range or amount filters are too restrictive","Rate limiting or credit exhaustion if prepaid credits are depleted","Invalid unix timestamp format for timeStart or timeEnd"],"whenToPreferThis":"Use this endpoint when you need to query historical SPL token transfers on Solana with flexible filtering by sender, receiver, token mint, amount range, time window, or transaction signature. Prefer it over generic blockchain explorers when you need programmatic, paginated, structured transfer data payable per-call with no API key setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:31:18.941Z","isFirstParty":false,"canonicalSlug":"vybe-solana-token-transfers-query-db6e5cba"}