AgentSky
Log inSign up
BlockRun logo

commodity list

by BlockRun
blockrun/commodity/list

commodity list is a tool from BlockRun, callable through the AgentSky API as blockrun/commodity/list and billed per call ($0.01).

Discover commodity symbols.

  1. Get an API key

  2. Send a request

    curl https://gateway.agentsky.dev/v1/run \
  -H "authorization: Bearer $AGENTSKY_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"provider":"blockrun","endpoint":"commodity/list","input":{}}'

  3. Run it here, no terminal needed

    Billed to your balance: $0.01 per call.

  4. Or hand it to your agent

    Use commodity list through AgentSky.
Call: POST https://gateway.agentsky.dev/v1/run with {"provider": "blockrun", "endpoint": "commodity/list", "input": {…}}
Docs: https://agentsky.dev/tools/blockrun/commodity/list.md
Key: <your AgentSky API key>
Full example ↓API docs ↗

Overview

Discover commodity symbols. Source: https://blockrun.ai/docs/api-reference/market-data. Upstream is public and requires no API key; Gateway access requires your gateway key. Standard list price: $0.01 per successful call. Supplier rate limits apply.

Public supplier JSON; top-level arrays are returned under data.

Input

These go in the input object of the run request.

FieldTypeRequiredDescription
qstringNoSubstring filter.
limitintegerNoMaximum symbols returned.
Minimum: 1
Maximum: 2000

Requests up to 1 MB.

Example

Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.

# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
  -H "authorization: Bearer $AGENTSKY_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
  -d '{"provider":"blockrun","endpoint":"commodity/list","input":{}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.

Pricing

$0.01 per call using your plan when signed in. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.

Questions