เมตริกบนเชนรายวันสำหรับหุ้นในรูปแบบโทเค็นด้วย Data API

สำหรับการดีพลอยสัญญาและการรับฟัง event บน Robinhood Chain โปรดปฏิบัติตาม คู่มือ RPC และ WebSocket

• ขั้นตอนแรก: อ่านบล็อกล่าสุดโดยไม่ต้องใช้ API key โดยใช้คำสั่ง curl ด้านล่าง
• เสร็จสมบูรณ์เมื่อ: คำค้นหา stocks ที่ได้รับการยืนยันตัวตนส่งคืน data และ meta; ระเบียนข้อมูลที่พร้อมใช้งานจะประกอบด้วย day, token, transfers และ holder_count ในขณะที่ data: [] หมายความว่าไม่มีระเบียนกิจกรรมที่พร้อมใช้งาน

พารามิเตอร์และชุดข้อมูลของ Mainnet

ภารกิจสามขั้นตอน: สืบค้นกิจกรรมของหุ้นบน Robinhood Chain

ค้นหาหุ้นในรูปแบบโทเค็นที่มีความเคลื่อนไหวมากที่สุดในวัน UTC ล่าสุดที่บันทึกไว้ จากนั้นอ่านจำนวนการโอนและจำนวนผู้ถือ

ใช้ API key เดียวเพื่อสืบค้นกิจกรรมและผู้ถือของโทเค็นหุ้น mainnet สำหรับแดชบอร์ดกิจกรรม ข้อมูลเหล่านี้เป็นเมตริกกิจกรรมบนเชน ไม่ใช่ราคาเสนอซื้อขายหุ้น

1. อ่านบล็อกล่าสุดโดยไม่ต้องใช้ API key

curl -sS "https://api.blockvectra.com/v1/robinhood_mainnet/public" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

result ของ JSON-RPC คือหมายเลขบล็อกล่าสุดในรูปแบบเลขฐานสิบหก การเรียก RPC สาธารณะนี้ไม่จำเป็นต้องใช้คีย์; การสืบค้น Data API ในขั้นตอนที่ 3 ต้องใช้คีย์

2. สร้างคีย์สำหรับเชนเดียวกัน

เข้าสู่ระบบคอนโซลและเปิด API Keys สร้างคีย์และบันทึก secret ที่แสดงในกล่องโต้ตอบ คีย์เดียวกันนี้ใช้ได้ทั้งสำหรับ JSON-RPC และ Data API บน robinhood_mainnet

สำหรับ AI Agent ที่ใช้ HTTP โดยไม่มีเบราว์เซอร์ ให้ปฏิบัติตาม คู่มือการลงทะเบียนแบบเป็นโปรแกรม เพื่อลงทะเบียนด้วยลายเซ็นกระเป๋าเงิน Ethereum และสร้างคีย์; ห้ามขอให้ผู้ใช้วางคีย์ลงในแชท

3. สืบค้นกิจกรรมของหุ้นด้วยคีย์ของคุณ

แทนที่ replace-with-your-key ด้านล่างด้วยคีย์ที่คุณบันทึกไว้ จากนั้นรันคำสั่งบนเซิร์ฟเวอร์ของคุณหรือในเทอร์มินัลภายในเครื่อง การละเว้น day จะเป็นการเลือกวันล่าสุดที่บันทึกไว้; limit=5 จะส่งคืนหุ้นสูงสุด 5 รายการเรียงตามกิจกรรมการโอนจากมากไปน้อย

export BLOCKVECTRA_API_KEY='replace-with-your-key'

curl -sS "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?limit=5" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

อ่านฟิลด์เหล่านี้ในการตอบกลับ:

อาร์เรย์ data ที่ว่างเปล่าหมายความว่าไม่มีระเบียนกิจกรรมที่พร้อมใช้งาน หากต้องการตรวจสอบหุ้นจากผลลัพธ์ ให้ใช้ค่า token ดังกล่าวกับ GET /robinhood_mainnet/stocks/{token} ตามที่อธิบายไว้ด้านล่าง

ชุดข้อมูลหุ้นในรูปแบบโทเค็นคืออะไร

BlockVectra Data API ให้บริการเมตริกบนเชนรายวันและข้อมูลเมทาดาตาสำหรับหุ้นในรูปแบบโทเค็น ชุดข้อมูลนี้รวบรวมการโอนรายวัน, การมิ้นต์, การเบิร์น, การเปลี่ยนแปลงอุปทานสุทธิ, การกระจายตัวของผู้ถือ และเมตริกการซื้อขายบนกระดานเทรดแบบกระจายศูนย์ (DEX) ช่วยให้นักพัฒนาสามารถติดตามกิจกรรมสาธารณะของหุ้นในรูปแบบโทเค็นได้

สำหรับเชนที่นำเสนอชุดข้อมูลนี้ โปรดดูที่หน้า เชนที่รองรับ

• Base URL: https://api.blockvectra.com/v1/data — ยกเว้น GET /chains เส้นทาง Data API ทั้งหมดจะขึ้นต้นด้วยตัวระบุเชน (เช่น https://api.blockvectra.com/v1/data/{chain}/…)
• เชนตัวอย่าง: robinhood_mainnet (ใช้เป็นตัวอย่างพารามิเตอร์พาธ; ตรวจสอบ เชนที่รองรับ สำหรับเชนทั้งหมดที่นำเสนอชุดข้อมูลนี้)
• การยืนยันตัวตน: ระบุ API key ของคุณในส่วนหัวของคำขอ x-api-key: $BLOCKVECTRA_API_KEY
• การเรียกเก็บเงินและความครอบคลุม: วัดปริมาณเป็น Compute Units (CU); คิดค่าบริการเฉพาะการตอบกลับที่สำเร็จระดับ 2xx เท่านั้น หากเชนไม่มีความครอบคลุมสำหรับหุ้น endpoint จะส่งคืน HTTP 422 no_coverage (ไม่คิดค่าบริการ)

กระดานผู้นำรายวัน (GET /{chain}/stocks)

endpoint GET /{chain}/stocks จะส่งคืนกระดานผู้นำกิจกรรมรายวันของหุ้นในรูปแบบโทเค็นสำหรับวันที่ UTC ที่ระบุ รวมถึงเมทาดาตาสำหรับการแสดงผล (สัญลักษณ์, ชื่อ ฯลฯ) โดยเรียงลำดับตามกิจกรรมการโอนจากมากไปน้อย (โทเค็นที่มีความเคลื่อนไหวมากที่สุดขึ้นก่อน)

พารามิเตอร์คำขอ

• {chain} (พารามิเตอร์พาธ, จำเป็น): ตัวระบุเชน (ตัวอย่างเช่น robinhood_mainnet)
• day (พารามิเตอร์แบบสอบถาม, ไม่บังคับ): วันที่ตามปฏิทิน UTC ในรูปแบบ YYYY-MM-DD เมื่อละเว้น จะใช้ค่าเริ่มต้นเป็นวันล่าสุดที่บันทึกไว้ (หากไม่มีการบันทึกกิจกรรม จะส่งคืน 200 พร้อม data: []) หากระบุแต่วันที่ตามปฏิทินไม่ถูกต้องตามรูปแบบ YYYY-MM-DD จะส่งคืน HTTP 400 (error.code = "bad_request")
• limit (พารามิเตอร์แบบสอบถาม, ไม่บังคับ): จำกัดจำนวนระเบียนข้อมูลที่ส่งคืน ค่าเริ่มต้นคือ 50; ค่าที่มากกว่า 500 จะถูกปรับลดลงเหลือ 500; การส่งค่า 0 หรือไม่ใช่จำนวนเต็มจะส่งคืน HTTP 400 (error.code = "bad_request")

พฤติกรรมการแบ่งหน้า

endpoint นี้ไม่มีการแบ่งหน้า พารามิเตอร์ limit จะจำกัดจำนวนระเบียนสูงสุดที่ส่งคืน ในโครงสร้าง StockDailyListEnvelope ที่ครอบคลุม (data และ meta) endpoint สำหรับหุ้นจะไม่ส่งคืน next_cursor (คีย์นี้จะไม่มีอยู่เลย โดยไม่เคยเป็น null)

ตัวอย่างโค้ด

เทมเพลตเริ่มต้นฉบับสมบูรณ์บน Robinhood Chain: blockvectra/robinhood-stock-tokens

curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?day=2026-09-29&limit=10" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

โครงสร้างการตอบกลับ

โครงสร้างการตอบกลับคือ StockDailyListEnvelope ซึ่งประกอบด้วย data และ meta:

• data (อาร์เรย์): รายการของระเบียนข้อมูลกระดานผู้นำรายวัน (StockDaily) เรียงลำดับตามกิจกรรมการโอนจากมากไปน้อย (โทเค็นที่มีความเคลื่อนไหวมากที่สุดขึ้นก่อน) แต่ละรายการประกอบด้วยตัวระบุโทเค็น (token, symbol, name), กิจกรรมการโอน (transfers, unique_senders, unique_receivers), เมตริกอุปทาน (mint_raw_amount, burn_raw_amount, net_supply_change), เมตริกการกระจายตัว (holder_count, top10_holder_share_bps), เมตริกการซื้อขายบน DEX (dex_swap_count, dex_raw_volume) และเวลาประทับการรีเฟรช (refreshed_at)
• meta (ออบเจกต์): ข้อมูลเมทาดาตาของเชน (chain, chain_slug, chain_external_id, as_of_block, safe_block, finalized_block, coverage, refreshed_at) โดย meta.refreshed_at อาจเป็น null: null หมายความว่าไม่ทราบเวลาอัปเดตของข้อมูลนี้และควรได้รับการปฏิบัติเสมือนข้อมูลล้าสมัย; ส่วน endpoint ที่อิงตามบล็อกจะส่งคืนค่าเสมอ

ดึงข้อมูลหุ้นในรูปแบบโทเค็นหนึ่งรายการ (GET /{chain}/stocks/{token})

endpoint GET /{chain}/stocks/{token} จะดึงข้อมูลเมทาดาตาและเมตริกรายวันล่าสุดสูงสุด 30 วันสำหรับหุ้นในรูปแบบโทเค็นเฉพาะตามแอดเดรสของโทเค็น

พารามิเตอร์คำขอ

• {chain} (พารามิเตอร์พาธ, จำเป็น): ตัวระบุเชน (ตัวอย่างเช่น robinhood_mainnet)
• {token} (พารามิเตอร์พาธ, จำเป็น): แอดเดรสสัญญาโทเค็นขนาด 20 ไบต์; คำนำหน้า 0x เป็นตัวเลือกและยอมรับตัวพิมพ์ใหญ่หรือเล็กก็ได้ (แอดเดรสที่ส่งคืนจะถูกปรับมาตรฐานเป็น 0x ตามด้วยเลขฐานสิบหกตัวพิมพ์เล็ก 40 หลัก) รูปแบบแอดเดรสที่ไม่ถูกต้องจะส่งคืน HTTP 400 (error.code = "bad_request")
• หาก {token} ไม่ใช่หุ้นในรูปแบบโทเค็นที่เป็นที่รู้จัก จะส่งคืน HTTP 404 (error.code = "not_found") หาก {chain} เป็นเชนที่ไม่รู้จัก จะส่งคืน HTTP 404 (error.code = "unknown_chain")

ตัวอย่างโค้ด

curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks/0x1111111111111111111111111111111111111111" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

โครงสร้างการตอบกลับ

โครงสร้างการตอบกลับคือ StockTokenEnvelope ซึ่งประกอบด้วย data และ meta:

• data (ออบเจกต์): ออบเจกต์ StockToken ที่ประกอบด้วยเมทาดาตาของสัญญาโทเค็น (address, symbol, name, decimals, created_block, created_tx_hash, factory, creator, mint_address, burn_address, refreshed_at) และอาร์เรย์เมตริกรายวันล่าสุด daily
  • daily (อาร์เรย์): อาร์เรย์ของเมตริกรายวันล่าสุด (StockDailyMetric) สูงสุด 30 วัน เรียงลำดับตามวันที่จากใหม่ไปเก่า (ใหม่สุดขึ้นก่อน) แต่ละรายการรายวันจะใช้สคีมาเมตริกเดียวกันกับกระดานผู้นำด้านบน (โดยไม่มีฟิลด์ token, symbol และ name ที่ซ้ำซ้อน)
• meta (ออบเจกต์): ออบเจกต์เมทาดาตาของเชนที่สอดคล้องกับการตอบกลับของกระดานผู้นำ

คำอธิบายฟิลด์ส่งคืนที่สำคัญ

ฟิลด์เมตริกรายวัน (StockDaily และ StockDailyMetric)

ทั้งกระดานผู้นำและรายการประวัติรายวันของโทเค็นเดี่ยวต่างมีฟิลด์หลักต่อไปนี้:

ฟิลด์เมทาดาตาของโทเค็น (StockToken)

เมื่อสืบค้นโทเค็นเดี่ยว ออบเจกต์ data ด้านนอกจะประกอบด้วยเมทาดาตาของสัญญาและเมตริกรายวันล่าสุด:

ข้อตกลงการเข้ารหัสข้อมูล

API ปฏิบัติตามกฎการเข้ารหัสที่เข้มงวดในทุก endpoint เพื่อรักษาความแม่นยำและความสอดคล้องของตัวเลข:

• ความปลอดภัยของมูลค่า: ค่าใดๆ ที่อาจเกิน 2^53 (จำนวนเต็ม 256 บิต เช่น mint_raw_amount, burn_raw_amount, net_supply_change และ dex_raw_volume) จะถูกแปลงเป็นอนุกรมในรูปแบบสตริงฐานสิบ โดยไม่เคยอยู่ในรูปตัวเลข JSON และไม่ใช้สัญกรณ์วิทยาศาสตร์หรือเลขฐานสิบหก เพื่อป้องกันการสูญเสียความแม่นยำในสภาพแวดล้อมรันไทม์ เช่น JavaScript ใน JavaScript/TypeScript ให้แปลงค่าด้วย BigInt(str) (เช่น const net = BigInt(body.data.daily[0].net_supply_change)); ใน Python ให้แปลงค่าด้วย int(str) ส่วนตัวนับที่มีค่าน้อยกว่า 2^53 มาก (transfers, unique_senders, unique_receivers, holder_count, top10_holder_share_bps, dex_swap_count, created_block) จะเป็นตัวเลข JSON ทั่วไป
• ค่าไบนารีและฐานสิบหก: แอดเดรสคือ 0x ตามด้วยอักขระฐานสิบหกตัวพิมพ์เล็ก 40 ตัว; แฮชคือ 0x ตามด้วยอักขระฐานสิบหกตัวพิมพ์เล็ก 64 ตัว โดยค่าฐานสิบหกที่ส่งคืนทั้งหมดจะเป็นตัวพิมพ์เล็กอย่างเคร่งครัด
• เวลาประทับและวันที่: เวลาประทับ เช่น refreshed_at จะใช้รูปแบบ YYYY-MM-DDTHH:MM:SSZ (ISO-8601 UTC พร้อมความแม่นยำระดับวินาที) ส่วนการรวบรวมข้อมูลรายวัน (day) จะใช้วันที่ตามปฏิทินแบบธรรมดา (YYYY-MM-DD)

ประมาณการการใช้งาน (รีเฟรช 50 โทเค็นทุกวัน)

การสืบค้น Data API ใช้ Compute Units (CU) ตามค่าน้ำหนักเมธอดของแพลตฟอร์ม ประมาณการด้านล่างประเมินสถานการณ์ที่ 50 โทเค็นเรียกใช้ GET /{chain}/stocks/{token} หนึ่งครั้งต่อวัน โดยประเมินเทียบกับค่าน้ำหนักเมธอดที่ใช้งานอยู่:

การเริ่มต้นใช้งานและการอัปเกรด

โควตาฟรีเหมาะสำหรับการพัฒนา การทดสอบ และปริมาณงานที่ไม่หนักมาก เมื่อทราฟฟิกของคุณขยายตัวและต้องการการทำงานพร้อมกันที่สูงขึ้นหรือต้องการ compute units เพิ่มขึ้น ให้เติมเงินบนเชนในหน้า การเรียกเก็บเงิน ของคอนโซล; เมื่อได้รับการยืนยันบนเชนและเพิ่มเครดิตแล้ว เพดานการเรียกต่อวินาทีทั่วทั้งบัญชีจะถูกยกเลิก โดยแต่ละคีย์ยังคงอยู่ภายใต้อัตรา CU และขีดจำกัด burst ตามที่อธิบายไว้ใน เอกสาร JSON-RPC ฟรีเครดิตที่ยังไม่ได้ใช้จะยังคงอยู่ในเครดิตของคุณและสามารถใช้งานได้ต่อไป สำหรับอัตราและหน่วยเรียกเก็บเงินปัจจุบัน โปรดดูที่ หน้าราคา

ขั้นตอนถัดไป

• เลือกดูไดเรกทอรีชุดข้อมูล เพื่อดูชุดข้อมูลทั้งหมดที่ BlockVectra จัดทำดัชนี
• ดูแพ็กเกจฟรีและการกำหนดราคา เพื่อตรวจสอบสิทธิประโยชน์ในบัญชีของคุณ
• เข้าสู่ระบบคอนโซล เพื่อสร้าง API key