{"openapi":"3.1.0","info":{"title":"BumbleBeam API","version":"1.0.0","description":"Plain JSON for the Beam blockchain from BumbleBeam's own explorer node. Amounts are decimal strings in whole units with each asset's own precision; times are ISO 8601 and unix seconds. Read-only, no key, rate-limited per IP."},"servers":[{"url":"https://explorer.bumblebeam.org"}],"paths":{"/v1/status":{"get":{"summary":"Chain tip, peers, shielded counts","parameters":[],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/supply":{"get":{"summary":"BEAM issued and maximum supply","parameters":[],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/search":{"get":{"summary":"Resolve a height, kernel, contract, asset or BANS name","parameters":[{"name":"q","in":"query","required":false,"description":"what to look up","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/blocks":{"get":{"summary":"Block headers, newest first","parameters":[{"name":"limit","in":"query","required":false,"description":"1-500, default 20","schema":{"type":"integer"}},{"name":"before","in":"query","required":false,"description":"only blocks below this height","schema":{"type":"integer"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/blocks/{height}":{"get":{"summary":"One block","parameters":[{"name":"height","in":"path","required":true,"description":"block height","schema":{"type":"integer"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/kernels/{id}":{"get":{"summary":"A kernel and its block","parameters":[{"name":"id","in":"path","required":true,"description":"64 hex characters","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/assets":{"get":{"summary":"Confidential assets","parameters":[{"name":"q","in":"query","required":false,"description":"filter: name, ticker, #id or owner key","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/assets/{id}":{"get":{"summary":"One asset (0 is BEAM)","parameters":[{"name":"id","in":"path","required":true,"description":"asset ID","schema":{"type":"integer"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/dex/pools":{"get":{"summary":"DEX liquidity pools","parameters":[{"name":"asset","in":"query","required":false,"description":"asset ID or ticker","schema":{"type":"string"}},{"name":"tier","in":"query","required":false,"description":"Low, Medium or High","schema":{"type":"string"}},{"name":"all","in":"query","required":false,"description":"1 to include empty pools","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/names":{"get":{"summary":"BANS names","parameters":[{"name":"q","in":"query","required":false,"description":"name filter","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"active, on_hold or expired","schema":{"type":"string"}},{"name":"for_sale","in":"query","required":false,"description":"1 for names listed for sale","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/names/{name}":{"get":{"summary":"One BANS name","parameters":[{"name":"name","in":"path","required":true,"description":"the name","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/contracts":{"get":{"summary":"Deployed contracts","parameters":[{"name":"q","in":"query","required":false,"description":"filter by kind, ID or shader","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"kind prefix","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/contracts/{id}":{"get":{"summary":"One contract","parameters":[{"name":"id","in":"path","required":true,"description":"64 hex characters","schema":{"type":"string"}},{"name":"calls","in":"query","required":false,"description":"recent calls, 1-500","schema":{"type":"integer"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/peers":{"get":{"summary":"Peers of the node","parameters":[],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/network":{"get":{"summary":"The network and every Beam mining pool: hashrate, miners, workers, blocks in 24 h, fee, BEAM/USD","parameters":[],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}},"/v1/network/blocks":{"get":{"summary":"Latest blocks with the pool that found each","parameters":[{"name":"limit","in":"query","required":false,"description":"1-500, default 50","schema":{"type":"integer"}},{"name":"before","in":"query","required":false,"description":"only blocks below this height","schema":{"type":"integer"}},{"name":"pool","in":"query","required":false,"description":"pool id, e.g. 2miners","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON"},"400":{"description":"bad parameter"},"404":{"description":"not found"},"502":{"description":"the node did not answer"}}}}}}