> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.bridge.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get daily reward history for a stablecoin

> Returns paginated daily reward records with per-provider breakdowns, AUM, fees, and distribution status. Data is calculated with a t-2 business day lag; the most recent available record corresponds to two business days prior to the current date.



## OpenAPI

````yaml https://withbridge-image1-sv-usw2-monorail-openapi.s3.amazonaws.com/latest.json get /rewards/{currency}/history
openapi: 3.0.2
info:
  title: Bridge API
  description: APIs to move into, out of, and between any form of a dollar
  version: '1'
servers:
  - url: https://api.bridge.xyz/v0
    description: The base path for all resources
security:
  - ApiKey: []
tags:
  - name: Customers
  - name: Fiat Payout Configuration
  - name: External Accounts
  - name: Transfers
  - name: Prefunded Accounts
  - name: Balances
  - name: Liquidation Addresses
  - name: Developers
  - name: API Keys
  - name: Plaid
  - name: Virtual Accounts
  - name: Static Memos
  - name: Cards
  - name: Funds Requests
  - name: Webhooks
  - name: Lists
  - name: Crypto Return Policies
  - name: Rewards
  - name: Associated Persons
  - name: Sandbox
paths:
  /rewards/{currency}/history:
    get:
      tags:
        - Rewards
      summary: Get daily reward history for a stablecoin
      description: >-
        Returns paginated daily reward records with per-provider breakdowns,
        AUM, fees, and distribution status. Data is calculated with a t-2
        business day lag; the most recent available record corresponds to two
        business days prior to the current date.
      parameters:
        - $ref: '#/components/parameters/RewardCurrencyParameter'
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 90
            default: 30
          description: Number of days to return per page
        - name: cursor
          in: query
          schema:
            type: string
          description: Pagination cursor from a previous response
      responses:
        '200':
          description: Daily reward history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeveloperRewardHistory'
              examples:
                DeveloperRewardHistory:
                  $ref: '#/components/examples/DeveloperRewardHistory'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/AuthenticationError'
        '500':
          $ref: '#/components/responses/UnexpectedError'
components:
  parameters:
    RewardCurrencyParameter:
      in: path
      name: currency
      required: true
      schema:
        type: string
      description: The stablecoin symbol
  schemas:
    DeveloperRewardHistory:
      title: Developer Daily Reward History
      type: object
      properties:
        currency:
          type: string
          description: The stablecoin symbol
        developer_id:
          type: string
          description: The developer ID
        reserves_currency:
          type: string
          description: The denomination currency for all monetary amounts
        data:
          type: array
          items:
            type: object
            properties:
              date:
                type: string
                description: The reward calculation date (YYYY-MM-DD)
              distributed:
                type: boolean
                description: Whether rewards for this date have been distributed
              total:
                type: object
                properties:
                  aum:
                    type: string
                    description: Developer AUM across all providers
                  developer_rewards:
                    type: string
                    description: Gross rewards (net of premint yield)
                  net_rewards:
                    type: string
                    description: Net rewards after fees
                  bridge_fee_bps:
                    type: string
                    description: Effective fee rate for that day
                  bridge_fee:
                    type: string
                    description: Fee amount for that day
                  annualized_yield_bps:
                    type: string
                    description: Blended annualized yield across providers
              providers:
                type: array
                items:
                  type: object
                  properties:
                    provider:
                      type: string
                      description: Provider identifier
                    aum:
                      type: string
                      description: Developer AUM held at this provider
                    developer_rewards:
                      type: string
                      description: Gross rewards from this provider
                    annualized_yield_bps:
                      type: string
                      description: Annualized yield rate for this provider
        pagination:
          type: object
          properties:
            has_more:
              type: boolean
              description: Whether more pages are available
            next_cursor:
              type: string
              nullable: true
              description: Cursor for the next page
    Error:
      required:
        - code
        - message
      properties:
        code:
          type: string
          minLength: 1
          maxLength: 256
        message:
          type: string
          minLength: 1
          maxLength: 512
        source:
          title: ErrorSource
          required:
            - location
            - key
          properties:
            location:
              type: string
              enum:
                - path
                - query
                - body
                - header
            key:
              type: string
              description: >-
                Comma separated names of the properties or parameters causing
                the error
  examples:
    DeveloperRewardHistory:
      summary: Daily reward history for a stablecoin
      value:
        currency: usdb
        developer_id: 2d127766-02fa-44b0-9fc8-a67665dbf109
        reserves_currency: usd
        data:
          - date: '2026-04-20'
            distributed: false
            total:
              aum: '45000000.00'
              developer_rewards: '5390.41'
              net_rewards: '4851.37'
              bridge_fee_bps: '10.0000'
              bridge_fee: '539.04'
              annualized_yield_bps: '436.6667'
            providers:
              - provider: blackrock
                aum: '30000000.00'
                developer_rewards: '3561.64'
                annualized_yield_bps: '432.5000'
              - provider: superstate
                aum: '15000000.00'
                developer_rewards: '1828.77'
                annualized_yield_bps: '445.0000'
        pagination:
          has_more: true
          next_cursor: eyJkYXRlIjoiMjAyNi0wNC0yMCJ9
  responses:
    BadRequestError:
      description: Request containing missing or invalid parameters.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            BadCustomerRequestErrorExample:
              summary: Bad customer request
              value:
                code: bad_customer_request
                message: fields missing from customer body.
                name: first_name,ssn
    AuthenticationError:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            MissingTokenError:
              summary: No Api-Key header
              description: The header may be missing or misspelled.
              value:
                code: required
                location: header
                name: Api-Key
                message: Missing Api-Key header
            InvalidTokenError:
              summary: Invalid key in Api-Key header
              value:
                code: invalid
                location: header
                name: Api-Key
                message: Invalid Api-Key header
    UnexpectedError:
      description: Unexpected error. User may try and send the request again.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            UnexpectedError:
              summary: An unexpected error
              value:
                errors:
                  - code: unexpected
                    message: An expected error occurred, you may try again later
  securitySchemes:
    ApiKey:
      type: apiKey
      name: Api-Key
      in: header

````