전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON
  1. REST API
  2. 조회

텍스트 → 자산 ID

GET /assets
ListAssets

이름이나 티커로 주식과 ETF, 원자재, 지수, 암호화폐를 조회하고, 모든 자산 엔드포인트가 받는 asset_id과 asset_class를 가져옵니다. 검색하려면 query을, 정확히 일치하는 항목을 찾으려면 asset_id를 보내고, 둘 다 보내지 않으면 가장 활발한 자산을 둘러봅니다.

파라미터 규칙:

  • asset_id는 asset_class와 함께 보내야 합니다.
  • asset_id은 query와 함께 사용할 수 없습니다.

https://nebula-api.hiddensystems.ai/api/v1/x402/assets에서 월렛 결제를 사용할 수 있습니다. Nebula 계정이나 API 키가 필요하지 않으며, 서명하기 전에 결제 제안을 확인하세요. x402 결제 가이드.

파라미터

asset_id string QUERY

/assets 또는 /search에서 가져온 자산 ID입니다(예: NVDA, GLD, SPX, bitcoin). 함께 반환된 asset_class와 같이 보내세요.

Example:NVDA

asset_class string QUERY

결과를 하나의 클래스로 제한합니다: equity(주식과 ETF), commodity, index 또는 crypto. asset_id를 보낼 때 필수입니다.

허용 값
equitycommodityindexcrypto

Example:equity

query string QUERY

공개 식별자와 이름을 대상으로 하는 대소문자 구분 없는 검색입니다.

Example:NVIDIA

limit integer QUERY

반환되는 최대 결과 수.

Default:50

offset integer QUERY

건너뛴 결과 수.

Default:0

cURL 예제

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/assets' \
  --header 'X-API-Key: YOUR_API_KEY'

응답

200 OK
400 잘못된 요청
401 인증되지 않음
402 크레딧이 모두 소진됨. 응답에 갱신 시점과 구매한 크레딧 잔액이 포함됩니다.
403 금지됨
404 찾을 수 없음
405 허용되지 않은 메서드입니다. Allow 헤더에 지원되는 메서드가 나열됩니다.
429 요청이 너무 많음
500 내부 서버 오류
503 서비스 이용 불가

미디어 타입 application/json

assets
array<object> 필수

제공된 검색 필터와 일치하는 자산입니다.
assets[].asset_class
string 필수

자산의 클래스입니다: equity(주식 및 ETF), commodity, index, crypto 중 하나입니다. asset 범위의 모든 요청에 asset_id와 함께 보내세요.

허용 값
equitycommodityindexcrypto
assets[].asset_id
string 필수

공개 자산의 정규 식별자입니다: 주식, 상품, 지수의 경우 티커 또는 시장 심볼이고, crypto의 경우 CoinGecko 슬러그(슬러그가 없으면 숫자 id)입니다.

assets[].handle
string 선택 사항

사용 가능한 경우 기본 소셜 핸들입니다.

assets[].market_cap_usd
number (double) 선택 사항

미국 달러 기준 최신 시가총액입니다. 암호화폐에 대해 보고되며, 주식, 원자재, 지수에는 없습니다.

assets[].name
string 필수

사람이 읽을 수 있는 이름입니다.

assets[].price_change_24h_pct
number (double) 선택 사항

24시간 동안의 원시 시장 가격 변동이며, 퍼센트 포인트 단위입니다.

assets[].price_usd
number (double) 선택 사항

최신 또는 관측된 시장 가격이며 미국 달러 단위입니다.

assets[].symbol
string 필수

표시용 티커 또는 시장 심볼입니다.

has_more
boolean 필수

반환된 레코드 뒤에 사용할 수 있는 페이지가 더 있으면 true입니다.

limit
integer 필수

요청된 최대 레코드 수입니다.

offset
integer 필수

건너뛴 일치 레코드 수입니다.

{
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "name": "NVIDIA Corporation",
      "price_change_24h_pct": 2.37,
      "price_usd": 182.41,
      "symbol": "NVDA"
    },
    {
      "asset_class": "commodity",
      "asset_id": "GLD",
      "name": "SPDR Gold Shares",
      "symbol": "GLD"
    },
    {
      "asset_class": "index",
      "asset_id": "SPX",
      "name": "S&P 500",
      "symbol": "SPX"
    }
  ],
  "has_more": false,
  "limit": 50,
  "offset": 0
}