{"uid":"cap_wn71ZhrW4d5o8bETqRdtU","slug":"coinopselect-referral-quote-api-2fedd313","name":"CoinOpSelect Referral Quote API","description":"Paid on-chain token, wallet, contract and research data over x402 on Base.","url":"https://coinop.publicvm.com/api/v1/referral/quote?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string"},"method":{"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"fee":{"type":"string","description":"Fee bps number"},"venue":{"type":"string","description":"Venue name"},"referral":{"type":"string","description":"Referral bps number"}}}}},"output":{"type":"object","properties":{"query":{"type":"string"},"quote":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":"referral-quote","quote":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_5zYKNp63Zde3O6zGlzKif","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":"Returns a referral fee quote for a given venue and fee configuration, including fee basis points and referral basis points.","exampleAgentPrompt":"What's the referral quote for Uniswap with a fee of 30 bps and a referral of 10 bps on CoinOpSelect?","exampleUseCases":[{"title":"Referral fee calculation for DeFi venue","prompt":"Can you get me a referral quote for Aerodrome with a fee of 25 bps and a referral of 15 bps so I know what the cost breakdown looks like?"},{"title":"Comparing referral rates across venues","prompt":"Pull a referral quote for Velodrome with 50 bps fee and 20 bps referral — I want to see what the quote object returns before I build my integration."},{"title":"Validating referral config before deployment","prompt":"Before I go live, can you check the referral quote on CoinOpSelect for our venue with 30 bps fee and 5 bps referral to confirm the numbers look right?"}],"resultDescription":"Returns a JSON object with a 'query' field set to 'referral-quote' and a 'quote' object containing the computed referral and fee details for the requested venue and basis point configuration.","failureModes":["Missing required 'type' or 'method' fields returns an error","Invalid or unrecognized venue name may return an empty or null quote object","Malformed fee or referral bps values (non-numeric strings) may cause computation errors","Payment failure via x402 (insufficient USDC balance) results in 402 Payment Required","Network or upstream provider issues may return 5xx errors"],"whenToPreferThis":"Use this endpoint when you need to programmatically compute or verify referral and fee quotes for specific DeFi venues on Base, especially when building integrations that require knowing exact basis-point breakdowns before routing trades or deploying referral logic. Best suited for agents that need lightweight, pay-per-call on-chain data without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:21:06.918Z","isFirstParty":false,"canonicalSlug":"coinopselect-referral-quote-api-2fedd313"}