> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# getAssetsByAuthority
> Recupere todos os NFTs Solana, NFTs comprimidos e tokens controlados por um endereço de autoridade específico com suporte à paginação
## Parâmetros da Requisição
O endereço do proprietário cujos ativos serão recuperados.
A página dos resultados a serem retornados.
O número máximo de ativos a serem retornados.
As opções de ordenação para a resposta.
O critério pelo qual os ativos recuperados serão ordenados.
* `created`
* `recent_action`
* `updated`
* `none`
A direção pela qual os ativos recuperados serão ordenados.
* `asc`
* `desc`
O cursor para paginação retroativa através dos ativos.
O cursor para paginação para frente através dos ativos.
As opções de exibição para a resposta.
Exibe informações de agrupamento para coleções não verificadas em vez de ignorá-las.
Exibe metadados para a coleção.
Mostra o número total de ativos que corresponderam à consulta. Isso tornará a requisição mais lenta.
## OpenAPI
````yaml pt-BR/openapi/das-api/getAssetsByAuthority.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Ponto de extremidade RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Ponto de extremidade RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAssetsByAuthority
description: Retorna uma lista de ativos pertencentes a uma determinada autoridade.
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: A versão do protocolo JSON-RPC.
default: '2.0'
id:
type: string
description: Um ID para identificar a solicitação.
default: '1'
method:
type: string
enum:
- getAssetsByAuthority
description: O nome do método DAS a ser invocado.
default: getAssetsByAuthority
params:
type: object
default:
authorityAddress: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
properties:
authorityAddress:
type: string
description: >-
O endereço do proprietário cujos ativos devem ser
recuperados.
example: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
page:
type: integer
description: A página de resultados a ser retornada.
example: 1
limit:
type: integer
description: O número máximo de ativos a serem retornados.
example: 100
sortBy:
type: object
description: As opções de ordenação para a resposta.
properties:
sortBy:
type: string
description: >-
Os critérios pelos quais os ativos recuperados serão
ordenados.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: >-
A direção pela qual os ativos recuperados serão
ordenados.
enum:
- asc
- desc
before:
type: string
description: O cursor para paginar para trás através dos ativos.
example: string
after:
type: string
description: O cursor para paginar para frente através dos ativos.
example: string
options:
type: object
description: As opções de exibição para a resposta.
properties:
showUnverifiedCollections:
type: boolean
description: >-
Exibe informações de agrupamento para coleções não
verificadas em vez de ignorá-las.
default: false
showCollectionMetadata:
type: boolean
description: Exibe metadados para a coleção.
default: false
showGrandTotal:
type: boolean
description: >-
Mostra o número total de ativos que correspondem à
consulta. Isso tornará a solicitação mais lenta.
default: false
required:
- authorityAddress
responses:
'200':
description: Resposta bem-sucedida
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Todos os dados até e incluindo este slot são
garantidos de terem sido indexados.
example: 365750752
total:
type: integer
description: O número total de ativos encontrados.
example: 1
limit:
type: integer
description: O número máximo de ativos solicitados.
example: 1
page:
type: integer
description: A página atual de resultados.
example: 1
items:
type: array
description: Uma matriz de ativos.
items:
type: object
properties:
interface:
type: string
description: A interface do ativo.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: ProgrammableNFT
is_agent:
type: boolean
description: >-
Se este ativo possui uma Identidade de Agente
(plugin externo MPL Core AgentIdentity). Omitido
quando falso.
agent_token:
type: string
description: >-
Token do agente codificado em Base58 do programa
Agent Registry. Omitido quando não registrado.
asset_signer:
type: string
description: >-
PDA do assinante de ativo codificado em Base58
para MPL Core. Omitido quando não aplicável.
plugins:
type: object
description: >-
Plugins MPL Core, incluindo associação opcional
ao MIP-11 `groups`.
additionalProperties: true
id:
type: string
description: O ID do ativo.
example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
content:
type: object
description: O conteúdo do ativo.
example:
$schema: https://schema.metaplex.com/nft1.0.json
json_uri: >-
https://madlads.s3.us-west-2.amazonaws.com/json/6867.json
files:
- uri: >-
https://madlads.s3.us-west-2.amazonaws.com/images/6867.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://madlads.s3.us-west-2.amazonaws.com/images/6867.png
mime: image/png
authorities:
type: array
items:
type: object
description: As autoridades do ativo.
example:
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
scopes:
- full
compression:
type: object
description: Os detalhes de compressão do ativo.
example:
eligible: false
compressed: false
data_hash: ''
creator_hash: ''
asset_hash: ''
tree: ''
seq: 0
leaf_id: 0
grouping:
type: object
description: Os detalhes de agrupamento do ativo.
example:
- group_key: collection
group_value: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
royalty:
type: object
description: Os detalhes de royalties do ativo.
example:
royalty_model: creators
target: null
percent: 0.042
basis_points: 420
primary_sale_happened: true
locked: false
creators:
type: array
items:
type: object
description: Os detalhes dos criadores do ativo.
example:
- address: 5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv
share: 0
verified: true
ownership:
type: object
description: Os detalhes de propriedade do ativo.
example:
frozen: true
delegated: false
delegate: null
ownership_model: single
owner: 3F21SJs4FMpsakrxmd8GjgfQZG6BN6MVsvXcm5Yc6Jcf
burnt: false
'400':
description: >-
Solicitação ruim. O servidor não pôde entender a solicitação devido
à sintaxe inválida.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32602
message:
type: string
example: Parâmetros de solicitação inválidos.
id:
type: string
example: '1'
'401':
description: >-
Não autorizado. O cliente deve se autenticar para obter a resposta
solicitada.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32001
message:
type: string
example: Autenticação falhou. Chave API ausente ou inválida.
id:
type: string
example: '1'
'403':
description: Proibido. O cliente não possui direitos de acesso ao conteúdo.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32003
message:
type: string
example: Você não tem permissão para acessar este recurso.
id:
type: string
example: '1'
'404':
description: Não encontrado. O servidor não pode encontrar o recurso solicitado.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32004
message:
type: string
example: >-
Nenhum ativo encontrado para a autoridade
especificada.
id:
type: string
example: '1'
'429':
description: >-
Muitas solicitações. O usuário enviou muitas solicitações em um
determinado período de tempo.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32029
message:
type: string
example: >-
Limite de taxa excedido. Por favor, tente novamente
mais tarde.
id:
type: string
example: '1'
'500':
description: >-
Erro Interno do Servidor. O servidor encontrou uma situação que não
sabe como lidar.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32000
message:
type: string
example: Ocorreu um erro inesperado no servidor.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave API Helius. Você pode obter uma gratuitamente no
[painel](https://dashboard.helius.dev/api-keys).
````