# x402-tools Concert Listings API

> x402-tools Concert Listings API is a paid API for AI agents from x402-tools.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11, last successful call 2026-07-02).

Returns up-to-date concert listings with venue details, dates, artists, and ticket price ranges, filterable by city, genre, artist, country, and date range.

## Facts

- Endpoint: GET https://x402-tools.vercel.app/api/concerts?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Last successful call: 2026-07-02
- Success rate: 100% of calls made through Zero
- Rating: 1.3 / 5 from 2 reviews
- Activations on Zero: 32
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-tools-vercel-app-91627950
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yCivOnGWRPiIkjT0uatwO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-tools-vercel-app-91627950
```

Example prompt: Can you find upcoming Jazz concerts in New York from March 1 to March 31, 2026? I want to see venue names, dates, and ticket price ranges.

## When to prefer this

Use this endpoint when you need structured, up-to-date concert and live music event data including venue details and ticket pricing, especially when filtering by city, genre, artist, or date range. Prefer over generic web search when you need machine-readable event data suitable for building event discovery apps or answering specific concert-related queries.

## Known failure modes

- No concerts found for the given filters — returns empty array
- Invalid genre value not matching the allowed enum — may return error or empty results
- Invalid date format not conforming to ISO 8601 — may return error
- Invalid country code — may return no results or error
- Payment failure or insufficient USDC balance — 402 Payment Required response

## How this service works

Search for upcoming concerts. Supports city, date range, genre, and artist filtering.

## Output

An array of concert/event objects, each containing the event name, local date (YYYY-MM-DD), local time, venue name, city, list of performing artists, ticket price range (min/max USD), and a URL to the event page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "city": {
       "type": "string",
       "description": "City name (e.g. Boston, New York)"
      },
      "page": {
       "type": "string",
       "description": "Page number for pagination (default 0)"
      },
      "genre": {
       "type": "string",
       "description": "Music genre. One of: Alternative, Ballads/Romantic, Blues, Classical, Country, Dance/Electronic, Folk, Hip-Hop/Rap, Jazz, Latin, Metal, Pop, R&B, Reggae, Rock, World."
      },
      "artists": {
       "type": "string",
       "description": "Comma-separated artist names to filter by (e.g. Khruangbin,Bob Moses)"
      },
      "countryCode": {
       "type": "string",
       "description": "Country code filter (default US)"
      },
      "endDateTime": {
       "type": "string",
       "description": "End of date range in ISO 8601 (e.g. 2026-03-31T23:59:59Z)"
      },
      "startDateTime": {
       "type": "string",
       "description": "Start of date range in ISO 8601 (e.g. 2026-03-01T00:00:00Z)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "name",
       "date",
       "artists"
      ],
      "properties": {
       "url": {
        "type": "string",
        "nullable": true,
        "description": "Event URL"
       },
       "city": {
        "type": "string",
        "nullable": true,
        "description": "City name"
       },
       "date": {
        "type": "string",
        "description": "Local date (YYYY-MM-DD)"
       },
       "name": {
        "type": "string",
        "description": "Concert/event name"
       },
       "time": {
        "type": "string",
        "nullable": true,
        "description": "Local time (HH:MM:SS) or null"
       },
       "venue": {
        "type": "string",
        "nullable": true,
        "description": "Venue name"
       },
       "artists"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-tools-vercel-app-91627950/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-tools.vercel.app](https://www.zero.xyz/host/x402-tools.vercel.app/llms.txt)