전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON

REST API
조회

검색

GET /search

검색

자산, 인물, 계정, 토픽을 한 번에 검색합니다. 각 결과의 kind는 어떤 유형인지 알려줍니다. 자산에는 asset_id와 asset_class가, 주체에는 subject_id가 포함됩니다. 한쪽만 검색하려면 kind를 보내세요.

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

파라미터

query string QUERY 필수

검색할 텍스트: 티커, 회사 또는 코인 이름, 인물, 계정 또는 토픽.

Example:NVIDIA

kind string QUERY

결과를 자산(주식, 원자재, 지수, 암호화폐) 또는 주체(인물, 계정, 토픽)로 제한합니다. 생략하면 둘 다 검색합니다.

허용 값

assetsubject

Example:asset

limit integer QUERY

반환되는 최대 결과 수.

Default:10

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/search' \
  --data-urlencode 'query=NVIDIA' \
  --header 'X-API-Key: YOUR_API_KEY'

응답

200 OK

400 잘못된 요청

401 인증되지 않음

402 크레딧이 모두 소진됨. 응답에 갱신 시점과 구매한 크레딧 잔액이 포함됩니다.

403 금지됨

404 찾을 수 없음

405 허용되지 않은 메서드입니다. Allow 헤더에 지원되는 메서드가 나열됩니다.

429 요청이 너무 많음

500 내부 서버 오류

503 서비스 이용 불가

미디어 타입 application/json

query

string 필수

해석된 자유 텍스트 문자열을 그대로 반환합니다.

results

array<object> 필수

순위가 매겨진 결과이며, 가장 높은 순위부터 정렬됩니다.

results[].asset_class

string 선택 사항

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

results[].asset_id

string 선택 사항

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

results[].kind

string 필수

결과의 유형입니다: asset(asset_id와 asset_class로 조회) 또는 subject(subject_id로 조회)입니다.

허용 값

assetsubject

results[].matched_alias

string 선택 사항

쿼리와 일치한 이름 또는 별칭으로, 검색이 왜 해당 결과로 이어졌는지 보여줄 수 있습니다.

results[].name

string 필수

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

results[].subject_id

string 선택 사항

자산이 아닌 인물, 계정 또는 주제의 정규 식별자입니다.

results[].symbol

string 선택 사항

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

{
  "query": "nvidia",
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "kind": "subject",
      "matched_alias": "NVIDIA AI",
      "name": "NVIDIA AI",
      "subject_id": "handle:nvidiaai"
    }
  ]
}