> ## Documentation Index > Fetch the complete documentation index at: https://docs.derive.xyz/llms.txt > Use this file to discover all available pages before exploring further. # public/get_block_proposals > Returns the listed block proposals: those that have not ended, then those that ended recently. Each group has the most recently updated first. Pass currency to return the proposals of one currency. Each proposal shows the maker's direction, the priced legs, its status and expires_at_sec. It never shows a wallet, a subaccount or a signature. Accept an open proposal with private/accept_block_proposal. ## OpenAPI ````yaml /openapi.json post /public/get_block_proposals openapi: 3.1.0 info: title: Derive v3 API version: 0.2.0 description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST. servers: - url: https://api.derive.xyz/v3 description: Production (HTTP POST base) - url: https://testnet.api.derive.xyz/v3 description: Testnet (HTTP POST base) security: [] tags: - name: Subaccounts description: >- List, inspect, and label subaccounts, portfolios, positions, and collateral. - name: Session Keys description: Register, edit, and list delegated signing keys. - name: Account description: Wallet-level account information and settings. - name: Orderbook description: Place, replace, cancel, and query orders, trigger orders, and algos. - name: RFQ description: 'Request-for-quote: send RFQs, quote, and execute block trades.' - name: Liquidations description: >- Open a Dutch auction against a breaching subaccount, quote the auctions running right now, bid on them, and review past ones. - name: Vault Shareholders description: >- Deposit into and withdraw from vaults, and track shares, requests, and performance. - name: Vault Curators description: >- Create and operate curated vaults: settle deposit and withdrawal requests, and manage vault metadata. - name: History description: >- Per-account historical records: orders, trades, transfers, and settlements. - name: Market Maker Protection description: Configure, read, and reset market-maker protection. - name: Transfers & Withdrawals description: Move collateral between subaccounts, to other wallets, and on-chain. - name: Onchain Actions description: >- L1 onchain actions submitted via OnchainActionManager: register deposit addresses, list pending deposits, and inspect onchain action history. - name: System description: Rate limits, transaction lookups, and live incidents. - name: Market Data description: Instruments, currencies, tickers, and market-wide feeds. - name: Maker Scoring description: Maker programs, score breakdowns, and detailed scoring snapshots. - name: Referrals description: Referral codes and program performance. - name: Chat description: Anonymous chat rooms and conversations with the concierge. - name: Other description: Uncategorized. paths: /public/get_block_proposals: post: tags: - RFQ summary: public/get_block_proposals description: >- Returns the listed block proposals: those that have not ended, then those that ended recently. Each group has the most recently updated first. Pass currency to return the proposals of one currency. Each proposal shows the maker's direction, the priced legs, its status and expires_at_sec. It never shows a wallet, a subaccount or a signature. Accept an open proposal with private/accept_block_proposal. operationId: public_get_block_proposals requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PublicGetBlockProposalsRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/BlockProposalGetPublicResponse' default: description: JSON-RPC error (see Error Codes) content: application/json: schema: type: object required: - error properties: error: $ref: '#/components/schemas/RPCError' components: schemas: PublicGetBlockProposalsRequest: type: object properties: currency: description: Returns only the proposals of this currency (e.g. `ETH`). type: - string - 'null' BlockProposalGetPublicResponse: description: Result for `public/get_block_proposals`. type: object required: - proposals properties: proposals: type: array items: $ref: '#/components/schemas/BlockProposalResultPublic' RPCError: type: object required: - code - message properties: code: type: integer format: int64 data: type: - string - 'null' message: type: string BlockProposalResultPublic: description: A block proposal as every other wallet sees it. type: object required: - block_trade_id - creation_timestamp - currency - direction - expires_at_sec - last_update_timestamp - legs - listed - proposal_id - risk_universe_id - status properties: block_trade_id: description: The block trade, once the proposal executes. type: - string - 'null' format: uuid creation_timestamp: type: integer format: int64 currency: type: string direction: $ref: '#/components/schemas/Direction' description: The maker's direction. The taker trades the opposite. expires_at_sec: description: The last second (UTC) at which the proposal can be accepted. type: integer format: int64 last_update_timestamp: type: integer format: int64 legs: type: array items: $ref: '#/components/schemas/PricedLegParamsAndResponse' listed: description: Whether the proposal is on the public list. type: boolean proposal_id: description: UUID v4 string type: string format: uuid risk_universe_id: type: integer format: uint32 minimum: 0 status: $ref: '#/components/schemas/BlockProposalStatus' Direction: type: string enum: - buy - sell PricedLegParamsAndResponse: type: object required: - amount - direction - instrument_name - price properties: amount: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal direction: $ref: '#/components/schemas/Direction' instrument_name: type: string price: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal BlockProposalStatus: oneOf: - type: string enum: - open - executing - executed - expired - description: By the maker. type: string enum: - cancelled - description: By the recipient. type: string enum: - declined ```` ## Related topics - [public/get_block_proposal](https://docs.derive.xyz/api-reference/rfq/publicget_block_proposal.md) - [Block proposals](https://docs.derive.xyz/api-reference/channels/blockproposals.md) - [RFQ Trading](https://docs.derive.xyz/trading/rfq.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.