Rarible

Rarible Points API

The Points API from Rarible — 3 operation(s) for points.

GitHub OpenAPI

Operations 3

GET /v0.1/points/rewards Get the leaderboard of awarded points across blockchains #
GET /v0.1/points/rewards/{address} Get awarded points by address #
GET /v0.1/points/claim/signature Sign a message to claim rewards #

Documentation

📖
Documentation
https://docs.rarible.org/docs/introduction
📖
Authentication
https://docs.rarible.org/docs/authentication
📖
Documentation
https://docs.rarible.org/docs/data-analytics

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/rarible/refs/heads/main/openapi/rarible-points-api-openapi.yml

Other Resources

🔗
Signup
https://rarible.org/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/rarible-points-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

rarible-points-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OpenAPI definition Points API
  version: v0.1
  description: '# Exciting News


    Hey there, amazing developers!'
servers:
- url: https://{environment}.rarible.org
  description: Production (Mainnet)
  variables:
    environment:
      enum:
      - api
      - testnet-api
      default: api
security:
- ApiKeyAuth: []
tags:
- name: Points
  x-controller: PointsController
paths:
  /v0.1/points/rewards:
    get:
      tags:
      - Points
      summary: Get the leaderboard of awarded points across blockchains
      description: Returns a paginated list of wallets with awarded points and rankings
      operationId: getPointsRewards
      parameters:
      - name: size
        in: query
        required: false
        description: 'Maximum number of results (default: 50)'
        schema:
          type: integer
          default: 50
          minimum: 1
          maximum: 1000
      - name: continuation
        in: query
        required: false
        description: Pagination cursor (point number and address to continue from)
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RewardEntities'
        '400':
          $ref: '#/components/responses/BadRequest'
        '500':
          $ref: '#/components/responses/ServerError'
  /v0.1/points/rewards/{address}:
    get:
      tags:
      - Points
      summary: Get awarded points by address
      description: Returns reward information grouped by blockchain for a specific wallet address
      operationId: getPointsRewardsByAddress
      parameters:
      - name: address
        in: path
        required: true
        description: Wallet address
        schema:
          type: string
          example: ETHEREUM:0x1234567890123456789012345678901234567890
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RewardsByBlockchain'
        '404':
          $ref: '#/components/responses/EntityNotFound'
        '400':
          $ref: '#/components/responses/BadRequest'
        '500':
          $ref: '#/components/responses/ServerError'
  /v0.1/points/claim/signature:
    get:
      tags:
      - Points
      summary: Sign a message to claim rewards
      description: A user uses this resource to sign a request to use their points collected through Points Program to claim the rewards (RARI)
      operationId: getClaimSignature
      parameters:
      - name: blockchain
        in: query
        description: Blockchain
        required: true
        schema:
          $ref: '#/components/schemas/Blockchain'
      - name: signer
        description: Address of the user who is claiming the reward
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/UnionAddress'
      - name: epoch
        description: Number of the epoch in which the user is claiming the reward
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/BigInteger'
      - name: points
        description: The number of points to claim
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/BigDecimal'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RewardsClaimSignatureResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    BigInteger:
      type: string
      example: 123456
    UnionApiErrorEntityNotFound:
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: string
          enum:
          - NOT_FOUND
          default: NOT_FOUND
        message:
          type: string
          description: Error message
    Blockchain:
      type: string
      enum:
      - APTOS
      - ETHEREUM
      - POLYGON
      - SOLANA
      - ARBITRUM
      - CHILIZ
      - LIGHTLINK
      - ZKSYNC
      - BASE
      - RARI
      - ZKLINK
      - QUAI
      - ECLIPSE
      - ELECTRONEUM
      - SAAKURU
      - OASIS
      - MATCH
      - MOONBEAM
      - ETHERLINK
      - ZKCANDY
      - BERACHAIN
      - ABSTRACT
      - SHAPE
      - TELOS
      - HEDERAEVM
      - VICTION
      - SETTLUS
      - GOAT
      - HYPEREVM
      - MEGAETH
      - MEGAETHTESTNET
      - MEGAETHTESTNETV2
      - BASECAMP
      - CAMP
      - SOMNIA
      - ARENAZ
      - INJECTIVE
      - INJECTIVETESTNET
      - APECHAIN
      - BLOCKCHAINKEK
      - STELLAR
      - ZILLIQA
      - FRAXTAL
      - XLAYER
      - MONAD
      example: ETHEREUM
    BigDecimal:
      type: string
      example: 123456.789
    UnionApiErrorServerError:
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: string
          enum:
          - UNKNOWN
          default: UNKNOWN
        message:
          type: string
          description: Error message
    RewardEntity:
      type: object
      properties:
        rewardWallet:
          $ref: '#/components/schemas/UnionAddress'
          description: Wallet address with blockchain prefix
          example: ETHEREUM:0x1234567890123456789012345678901234567890
        points:
          description: Points accumulated by the wallet
          $ref: '#/components/schemas/BigDecimal'
        rank:
          type: integer
          format: int64
          description: Rank position of the wallet
          example: 1
      required:
      - rewardWallet
      - points
    RewardsClaimSignatureResponse:
      type: object
      properties:
        signature:
          type: string
      required:
      - signature
    UnionAddress:
      type: string
      description: Blockchain address in Union format `${blockchainGroup}:${token}`
      example: ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb
    RewardEntities:
      type: object
      properties:
        entities:
          type: array
          description: List of reward entities
          items:
            $ref: '#/components/schemas/RewardEntity'
        continuation:
          type: string
          description: Continuation token to paginate rewards search result
      required:
      - entities
    UnionApiErrorBadRequest:
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: string
          enum:
          - BAD_REQUEST
          - VALIDATION
          default: BAD_REQUEST
        message:
          type: string
          description: Error message
    RewardByBlockchainEntity:
      type: object
      properties:
        rewardWallet:
          $ref: '#/components/schemas/UnionAddress'
          description: Wallet address with blockchain prefix
          example: ETHEREUM:0x1234567890123456789012345678901234567890
        points:
          description: Points accumulated by the wallet
          $ref: '#/components/schemas/BigDecimal'
        rank:
          type: integer
          format: int64
          description: Rank position of the wallet
          example: 1
        blockchain:
          $ref: '#/components/schemas/Blockchain'
      required:
      - rewardWallet
      - points
      - blockchain
    RewardsByBlockchain:
      type: object
      description: List of rewards by blockchain for a specific address
      properties:
        rewards:
          type: array
          description: List of reward entities for each blockchain
          items:
            $ref: '#/components/schemas/RewardByBlockchainEntity'
      required:
      - rewards
      example:
        rewards:
        - rewardWallet: ETHEREUM:0x1234567890123456789012345678901234567890
          points: '1200'
          rank: 5
          blockchain: ETHEREUM
        - rewardWallet: ETHEREUM:0x1234567890123456789012345678901234567890
          points: '300'
          rank: 15
          blockchain: POLYGON
  responses:
    ServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/UnionApiErrorServerError'
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/UnionApiErrorBadRequest'
    EntityNotFound:
      description: Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/UnionApiErrorEntityNotFound'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      x-default: 11111111-1111-1111-1111-111111111111