openapi: 3.1.0
info:
  title: Curve.finance crvUSD Pools API
  version: 1.0.0
  description: Curve.finance public REST API for pools, gauges, volumes, APY/APR, lending vaults, fees, and CRV/crvUSD supply data across supported blockchains.
  contact:
    name: Curve Finance
    url: https://curve.finance
  license:
    name: MIT
servers:
- url: https://api.curve.finance/v1
tags:
- name: Pools
paths:
  /getHiddenPools:
    get:
      tags:
      - Pools
      description: Returns a list of pool ids, grouped by chain id, that are known to be dysfunctional in some way. This list can be used by front-ends to avoid displaying these pools, and protect users from interacting with these pools.
      responses:
        '200':
          description: null
  /getPoolList/{blockchainId}:
    get:
      tags:
      - Pools
      description: 'Returns addresses of all pools, in all registries, on a specific chain.


        Note: For backward compatibility, in this endpoint the "factory" registry is renamed to "stable-factory"

        '
      parameters:
      - $ref: '#/components/parameters/blockchainId'
      responses:
        '200':
          description: null
  /getPools/{blockchainId}/{registryId}:
    get:
      tags:
      - Pools
      description: 'Returns information on all pools, in a specific registry, on a specific chain.


        Note:

        - Doesn''t work for Harmony: its 3pool isn''t in the main registry, and Harmony is lacking a crypto registry

        - Doesn''t work for Moonbeam: it''s lacking a main registry

        '
      parameters:
      - $ref: '#/components/parameters/blockchainId'
      - $ref: '#/components/parameters/registryId'
      responses:
        '200':
          description: null
  /getPools/all/{blockchainId}:
    get:
      tags:
      - Pools
      description: 'Returns all pools, in all registries, on a specific chain.

        '
      parameters:
      - $ref: '#/components/parameters/blockchainId'
      responses:
        '200':
          description: null
  /getPools/all:
    get:
      tags:
      - Pools
      description: 'Returns all pools, in all registries, on all chains.

        '
      responses:
        '200':
          description: null
  /getPools/big/{blockchainId}:
    get:
      tags:
      - Pools
      description: 'Returns all pools whose TVL is ≥$10k, in all registries, on a specific chain.

        '
      parameters:
      - $ref: '#/components/parameters/blockchainId'
      responses:
        '200':
          description: null
  /getPools/big:
    get:
      tags:
      - Pools
      description: 'Returns all pools whose TVL is ≥$10k, in all registries, on all chains.

        '
      responses:
        '200':
          description: null
  /getPools/empty/{blockchainId}:
    get:
      tags:
      - Pools
      description: 'Returns all pools whose TVL is $0, in all registries, on a specific chain.

        '
      parameters:
      - $ref: '#/components/parameters/blockchainId'
      responses:
        '200':
          description: null
  /getPools/empty:
    get:
      tags:
      - Pools
      description: 'Returns all pools whose TVL is $0, in all registries, on all chains.

        '
      responses:
        '200':
          description: null
  /getPools/small/{blockchainId}:
    get:
      tags:
      - Pools
      description: 'Returns all pools whose TVL is <$10k, in all registries, on a specific chain.

        '
      parameters:
      - $ref: '#/components/parameters/blockchainId'
      responses:
        '200':
          description: null
  /getPools/small:
    get:
      tags:
      - Pools
      description: 'Returns all pools whose TVL is <$10k, in all registries, on all chains.

        '
      responses:
        '200':
          description: null
components:
  parameters:
    blockchainId:
      in: path
      name: blockchainId
      required: true
      schema:
        type: string
        enum:
        - ethereum
        - arbitrum
        - aurora
        - avalanche
        - base
        - bsc
        - celo
        - fantom
        - fraxtal
        - harmony
        - hyperliquid
        - kava
        - mantle
        - moonbeam
        - optimism
        - polygon
        - sonic
        - x-layer
        - xdai
        - zkevm
        - zksync
    registryId:
      in: path
      name: registryId
      required: true
      schema:
        type: string
        enum:
        - factory
        - main
        - crypto
        - factory-crypto
        - factory-crvusd
        - factory-twocrypto
        - factory-tricrypto
        - factory-eywa
        - factory-stable-ng