---
title: "Get the referral funnel for a referrer"
method: GET
path: "/api/v1/referrals/funnel"
tags: ["Referrals"]
---

# Get the referral funnel for a referrer

`GET /api/v1/referrals/funnel`

## Request

- Base URL: `https://api.mainnet.aptoslabs.com/decibel`
- URL: `https://api.mainnet.aptoslabs.com/decibel/api/v1/referrals/funnel`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/decibel/apis/decibel-trading-api/docs/api/v1/referrals/funnel/get.ts> (a function with typed inputs; its response is checked against the schema)

Sign-ups and first-time deposits per UTC day, newest day first. Days with no
activity are omitted; clients fill the gaps.

## Query parameters

- `referrer_account` string, required
- `days` integer

## Response `200`

Per-day sign-ups and first deposits

- ReferralFunnelDay[]
  - `day_start_unix_ms` integer, required: UTC midnight of the day
  - `first_deposits` integer, required: Referrals whose very first collateral deposit landed on this day
  - `sign_ups` integer, required: Referrals that redeemed one of the referrer's codes on this day

## Other responses

- `400`: Invalid address
- `500`: Database error

## Changes

- **2026-11-03** `bb095628df0a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/decibel/apis/decibel-trading-api/changes/api/v1/referrals/funnel/get.md)

---

[API](https://skmtc.dev/decibel/apis/decibel-trading-api.md) - [All operations](https://skmtc.dev/decibel/apis/decibel-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/decibel/apis/decibel-trading-api/revisions/8f4984df6a54?raw)