# CoinOpSelect Referral Quote API

> CoinOpSelect Referral Quote API is a paid API for AI agents from coinop.publicvm.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-21).

Returns a referral fee quote for a given venue and fee configuration, including fee basis points and referral basis points.

## Facts

- Endpoint: GET https://coinop.publicvm.com/api/v1/referral/quote?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coinopselect-referral-quote-api-2fedd313
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wn71ZhrW4d5o8bETqRdtU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability coinopselect-referral-quote-api-2fedd313
```

Example prompt: What's the referral quote for Uniswap with a fee of 30 bps and a referral of 10 bps on CoinOpSelect?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Paid on-chain token, wallet, contract and research data over x402 on Base.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "referral-quote",
  "quote": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coinopselect-referral-quote-api-2fedd313/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coinop.publicvm.com](https://www.zero.xyz/host/coinop.publicvm.com/llms.txt)